Sun-Panel：打造你的专属NAS门户，从零开始构建高效导航首页

1. 为什么你需要一个NAS导航首页每天打开电脑第一件事就是面对浏览器里密密麻麻的书签栏——Jellyfin、Nextcloud、Bitwarden、Transmission...这些自建服务分散在不同的IP和端口上记不住地址就得反复翻找记事本。更头疼的是在公司想访问家里的NAS服务时还得区分内网外网地址。这种体验就像把工具扔在杂乱的工具箱里每次使用都要翻找半天。Sun-Panel就是为解决这些问题而生的NAS导航门户。它相当于给你的所有服务做了个可视化目录就像图书馆的检索系统。我实测下来最实用的三个场景统一入口把所有自建服务、常用网页整合在一个页面支持分类管理智能切换自动识别内外网环境点击图标无需手动切换地址状态监控直观显示服务器CPU、内存等基础信息异常状态一目了然对于家庭用户它能将孩子的学习资源、家人的照片库、影音服务分门别类展示对小型团队可以按部门设置不同权限的导航组。我自己的使用方案是把服务分成四类媒体中心Jellyfin、Plex、qBittorrent文件管理Nextcloud、FileBrowser工具集合Bitwarden、Portainer、HomeAssistant常用网站GitHub、技术文档等2. Sun-Panel核心功能解析2.1 比传统书签强在哪普通浏览器书签只能保存单一URL而Sun-Panel有这些独特优势双地址自动切换一个图标可同时设置内网如192.168.1.100:8096和公网地址如mydomain.com/jellyfin系统会根据访问环境自动选择可视化仪表盘支持自定义背景、布局调整图标尺寸可自由缩放多账户隔离家庭成员各自有独立视图避免孩子误操作管理后台服务状态集成通过简单配置就能显示服务的在线/离线状态2.2 那些让人惊喜的细节使用三个月后我发现几个特别实用的功能图标库集成内置Iconify的6000图标搜索movie就能找到完美的影视图标小窗模式点击图标可选择直接弹出小窗口适合快速查看下载进度CSS注入通过自定义CSS可以修改字体、颜色等我的暗黑模式方案是这样的body { background-color: #1a1a1a; color: #e0e0e0; } .card { background-color: #2d2d2d; }Docker健康监测如果通过Docker部署会自动显示容器运行状态3. 从零开始的安装指南3.1 硬件准备建议虽然Sun-Panel本身资源占用极低实测内存100MB但考虑到要整合各种服务建议NAS设备群晖DS220/威联通TS-251D等x86机型更佳内存容量如果同时运行多个服务建议4GB以上存储空间系统本身只需50MB预留1GB空间用于存放上传的图标和配置我的测试环境是一台树莓派4B4GB内存同时运行Sun-PanelJellyfinTransmission负载稳定在0.3左右。3.2 两种安装方式详解3.2.1 Docker CLI方案适合熟悉命令行的用户这里给出完整路径示例# 创建目录结构群晖用户注意修改/volume1为实际存储卷 mkdir -p /volume1/docker/sun-panel/{conf,database,uploads} # 启动容器端口3004可自行修改 docker run -d \ --name sun-panel \ -p 3004:3002 \ -v /volume1/docker/sun-panel/conf:/app/conf \ -v /volume1/docker/sun-panel/uploads:/app/uploads \ -v /volume1/docker/sun-panel/database:/app/database \ --restart unless-stopped \ hslr/sun-panel:latest3.2.2 Docker-Compose方案推荐使用这种方式方便后期管理。创建一个docker-compose.yml文件version: 3 services: sun-panel: image: hslr/sun-panel:latest container_name: sun-panel restart: unless-stopped ports: - 3004:3002 volumes: - ./conf:/app/conf - ./uploads:/app/uploads - ./database:/app/database然后执行docker-compose up -d4. 个性化配置实战4.1 安全设置第一步首次登录后默认账号adminsun.cc/12345678立即要做三件事修改管理员密码进入账户管理→修改密码创建新用户建议为每个家庭成员创建独立账号禁用默认账户在账户列表点击禁用图标4.2 导航分组技巧合理的分类能大幅提升效率这是我的分组方案示例媒体中心图标颜色统一用蓝色系文件管理使用绿色系图标灰色背景智能家居所有Home相关服务集中放置工作区仅对办公账号可见创建分组时可以按住图标直接拖拽调整顺序。对于高频服务建议放到第一屏可见位置。4.3 图标优化指南从Iconify选择图标的几个技巧搜索使用英文关键词如cloud比云结果多优先选择mdi-开头的Material Design图标复杂图标建议下载SVG后上传避免在线加载延迟修改图标样式的CSS示例/* 圆形背景 */ .icon-wrapper { border-radius: 50%; padding: 8px; background: rgba(255,255,255,0.1); } /* 悬停效果 */ .card:hover { transform: scale(1.05); transition: all 0.3s ease; }5. 高级应用场景5.1 内外网智能切换这是Sun-Panel最实用的功能之一。添加服务时公网地址填写域名端口如https://mydomain.com:8443内网地址填写局域网IP如http://192.168.1.100:8096系统会自动检测访问来源当我在公司点击图标时会自动跳转到公网地址回到家则使用内网地址避免绕行公网提升速度。5.2 多用户权限管理通过创建不同用户组实现权限隔离在账户管理创建children组为该组只分配儿童影视和学习资料分组设置组权限为仅查看这样孩子登录后既看不到管理后台也无法访问成人内容分区。5.3 与其它工具集成通过自定义HTML区块可以嵌入实用组件!-- 嵌入天气插件 -- iframe srchttps://embed.windy.com/embed.html width300 height200/iframe !-- 待办事项列表 -- div idtodo-list h3今日任务/h3 ul liinput typecheckbox 备份NAS数据/li liinput typecheckbox 整理照片库/li /ul /div6. 常见问题解决方案6.1 图标加载慢怎么办如果遇到图标显示延迟可以在设置中关闭实时加载在线图标将常用图标下载为SVG后上传到本地修改/app/conf/app.conf中的CDN设置[icon] cache_time 3600 preload_num 506.2 忘记密码如何处理如果管理员账户被锁定进入容器shelldocker exec -it sun-panel sh执行密码重置cd /app ./sun-panel --reset-password按提示输入新密码6.3 如何备份配置重要定期备份这三个目录/app/conf所有配置文件/app/database用户数据和导航设置/app/uploads上传的图标和图片我的自动化备份方案是通过群晖的Hyper Backup每天凌晨3点同步到Google Drive。