Sun-Panel 群晖 Container Manager 部署与配置文档

2026-09-27 12:54:52

一、部署说明

前置准备

打开群晖 File Station，进入存放项目目录，例如 /volume1/docker/sun-panel
在该目录内手动新建文件夹：conf、uploads

群晖 Container Manager 不会自动创建挂载目录，缺少目录会触发 bind mount 挂载失败。参考官方文档：https://doc.sun-panel.top/zh_cn/usage/quick_deploy.html

docker-compose.yml（官方原版，推荐完整版）

version: "3.2"
services:
  sun-panel:
    image: "hslr/sun-panel:latest"
    container_name: sun-panel
    volumes:
      - ./conf:/app/conf
      - ./uploads:/app/uploads
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - "3002:3002"
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai

端口：3002，访问地址 http://NASIP:3002
/var/run/docker.sock：用于读取Docker容器列表，实现容器启停与一键导入卡片
conf：核心配置、账号数据持久化目录；备份时备份此目录
uploads：上传图片、自定义图标存储目录

部署步骤

打开 Container Manager，新建项目，项目文件夹选择 /volume1/docker/sun-panel
粘贴上述 compose 配置，创建并启动项目
浏览器访问 http://NASIP:3002，进入初始化页面，设置管理员账号密码

二、基础功能介绍

Sun-Panel 是国产开源轻量导航面板，主打内网服务统一入口。

应用卡片分组管理
- 手动添加卡片：自定义分组，填写名称、内网地址、外网地址、图标，支持内外网一键切换。
- Docker一键导入：挂载docker.sock后，自动扫描容器，批量生成应用卡片，自动识别容器名称与端口。
简易Docker管理：查看容器列表，支持启停容器，查看基础运行状态。
附加功能：浏览器书签批量导入、自定义壁纸、首页时钟、弹窗小窗口预览网页。

卡片仅作为跳转链接，无第三方服务API深度集成，不能读取Jellyfin、RSS等服务内部运行状态，无状态监控小组件。

三、Sun-Panel vs Homarr 对比

项目	Sun-Panel	Homarr
定位	轻量导航面板 + 简易Docker管理	多功能仪表盘，导航+服务状态监控
默认端口	3002	7575
卡片添加	手动录入 / Docker一键导入；原生支持内外网一键切换	手动录入 / Docker集成导入；单地址，无原生内外网切换
监控能力	无第三方服务状态看板，仅基础容器启停	大量原生小组件，支持Jellyfin、Docker、天气、RSS等API集成
资源占用	低，轻量	相对更高
配置门槛	低，全中文可视化，无需配置API密钥	较高，需要逐个配置第三方服务API密钥
核心特色	内外网一键切换、书签批量导入、弹窗预览	丰富监控组件、拖拽布局、多服务实时状态展示
短板	无服务内部状态监控，仅做跳转	内外网切换需要维护两套独立卡片

四、选型总结

Sun-Panel：适合仅需要统一服务导航入口，需要内外网一键切换，不需要首页展示媒体播放、RSS等实时状态。
Homarr：适合导航+多服务状态监控场景，首页直接展示各类服务运行信息。

五、常见故障

Bind mount failed 挂载失败：本地conf/uploads目录未提前手动创建。
容器启动成功但无法访问：检查防火墙，确认3002端口放行，确认NAS内网IP正确。

六、配套备份提示

数据全部保存在项目目录下的conf文件夹，定期备份该目录即可。

← 返回文章列表