项目介绍
Sun-Panel 用于集中展示家庭 NAS、路由器和常用网站的访问入口。下面介绍部署配置、群晖安装与目录准备。可以按媒体、文件、网络等用途分组,再为每个服务填写图标和访问地址。
version: "3.2"
services:
sun-panel:
image: "hslr/sun-panel:latest"
container_name: sun-panel
volumes:
- ./conf:/app/conf
- /var/run/docker.sock:/var/run/docker.sock # 挂载docker.sock
# - ./runtime:/app/runtime # 挂载日志目录
# - /mnt/sata1-1:/os # 硬盘挂载点(根据自己需求修改)
ports:
- 3002:3002
restart: always
sun-panel-helper:
image: madrays/sun-panel-helper:latest
container_name: sun-panel-helper
environment:
- BACKEND_PORT=3009 # 后端服务端口,可自定义修改避免冲突
ports:
- "33002:80" # 前端页面访问端口,可自定义修改避免冲突
volumes:
- ./conf/custom:/app/backend/custom
restart: unless-stopped补充:部署与使用
配置与常见问题
- 导航页本身不会替后端应用提供身份验证或内网穿透。
更新与备份
导出导航配置并备份数据目录,更新后检查图标和分类。
群晖 Compose 部署
基础导航不需要为容器管理附加 Docker socket,也不需要额外安装助手组件。下面只启动导航服务:
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/sun-panel/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/sun-panel /volume1/docker/sun-panel/conf
cd /volume1/docker/sun-panel
HALO_PREPARE
cd /volume1/docker/sun-panel
services:
sun-panel:
image: hslr/sun-panel:latest
ports:
- "3002:3002"
volumes:
- /volume1/docker/sun-panel/conf:/app/conf
restart: unless-stopped
先建立 conf 目录,在项目目录运行 docker compose config --quiet,再 docker compose up -d。访问 http://NAS_IP:3002,按上游说明完成首次登录并修改初始凭据。latest 是浮动标签,更新前记录镜像摘要与配置备份。
导航卡片分别测试内外网地址与图标。若以后确需接入容器状态,再按对应版本文档单独评估 Docker 管理权限;不因基础导航功能把 socket 预先挂入。