打造高颜值服务器导航页：Docker 部署 Sun-Panel

📝 简介

Sun-Panel 是一款开源、免费、轻量级的服务器导航面板。 主要特点：资源占用极低、支持内网/外网链接、内置文件管理、支持多用户、可视化配置（无需手写 YAML）。适合 NAS、Homelab 用户统一管理服务入口。

作为一名 Homelab 爱好者或 NAS 用户，你是否遇到过这样的烦恼：部署的服务越来越多，端口号根本记不住，Chrome 浏览器的书签栏已经挤得密密麻麻？

是时候给你的服务器安一个“家”了。

今天我们要介绍的是 Sun-Panel——一款轻量、美观、功能强大的服务器导航面板。它不仅支持 Docker 一键部署，还集成了文件管理、富文本编辑器等实用功能。

🧐为什么选择 Sun-Panel？

市面上的导航面板很多（如 Heimdall, Homarr 等），但 Sun-Panel 凭借以下特点脱颖而出：

• 轻量级：系统占用极低，几乎忽略不计。

• 配置简单：所见即所得的编辑模式，无需手撸 YAML 配置文件。

• 功能丰富：支持内网/外网链接、自定义图标、文件上传、多用户管理。

• Docker 部署：部署只需一行命令，迁移备份极为方便。

🚀准备工作

在开始之前，请确保你的服务器（VPS、NAS 或树莓派）已经安装了 Docker 环境。

如果你使用 Docker Compose（推荐），请确保也已安装。

🚀 核心命令 (Docker Compose)

推荐使用 docker-compose 部署，便于维护配置和数据持久化。

创建一个 docker-compose.yml 文件，写入以下内容：

YAML

version: '3.8'
services:
  sun-panel:
    image: hslr/sun-panel:latest
    container_name: sun-panel
    restart: always
    ports:
      - "3002:3002"    # 访问端口
    volumes:
      - ./conf:/app/conf          # 配置文件目录
      - ./uploads:/app/uploads    # 上传文件/图标目录
      - ./database:/app/database  # 数据库目录

🔍 参数解析

⚡️ 快速部署流程

1. 创建工作目录

Bash

mkdir -p /home/docker/sun-panel && cd /home/docker/sun-panel

2. 启动容器 将上述 yaml 内容保存为文件后，执行：

Bash

docker-compose up -d

3. 查看状态

Bash

docker-compose ps

💡 默认配置 (必看)

• 访问地址：http://服务器IP:3002

• 默认账号：admin@sun.cc

• 默认密码：12345678

⚠️ 安全提示：首次登录后，请立即点击左下角「账号设置」修改默认密码。

🛠 常用维护命令

更新镜像与容器：

Bash

docker-compose pull && docker-compose up -d

查看实时日志：

Bash

docker-compose logs -f --tail=50

📝总结

Sun-Panel 是一个非常优秀的开源项目，它极大地简化了 Homelab 的入口管理。花费 5 分钟部署它，能为你节省以后无数个寻找端口的 5 分钟。

如果你也在寻找一款清爽的导航页，不妨试试 Sun-Panel！

🛠️你可能遇到的问题

• 端口冲突：如果 3002 被占用，请修改 docker-compose.yml 中冒号左边的端口，例如 "8080:3002"。

• 权限问题：如果挂载目录无法写入，请检查宿主机目录的权限。