建站与协作

Sun-Panel:建立家庭服务导航页

  • 0 次阅读
  • 0 条评论
文章摘要

Sun-Panel 为 NAS 服务和常用站点提供图标化入口。分类应按家庭成员能理解的用途组织,并区分内网与外网访问地址。 Sun-Panel 把常用网址与自建服务整理成卡片入口,省去记忆多个端口和地址的麻烦。它适合为家人提供清楚的服务首页,但导航权限并不会自动替代目标服务自己的登录与访问控制。

项目介绍

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 预先挂入。

参考资料