Sun Panel：打造你的 Homelab 导航仪表盘

2026-05-14

前言

如果你正在搭建 Homelab，一定需要一个导航页来快速访问各个服务。Sun Panel 是一款轻量、美观的 NAS 导航面板 / 仪表盘，支持小组件、书签管理、自定义 CSS/JS，非常适合作为 Homelab 的入口页面。

它的核心优势：

轻量：Docker 一键部署，资源占用极低
美观：现代化 UI，支持自定义样式
实用：内置天气、便签、书签等小组件
多用户：支持多账户管理

本文将介绍如何通过 Docker Compose 部署 Sun Panel，并进行基础配置。

Docker 部署

创建目录结构

1
2
mkdir -p /opt/sun-panel/conf
cd /opt/sun-panel

编写 docker-compose.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
version: "3.8"

services:
  sun-panel:
    image: hslr/sun-panel:latest
    container_name: sun-panel
    ports:
      - "3002:3002"
    volumes:
      - ./conf:/app/conf
    restart: unless-stopped

参数说明：

参数	说明
`image`	使用官方最新镜像 `hslr/sun-panel:latest`
`container_name`	容器名称，方便管理
`ports`	宿主机 3002 端口映射到容器 3002 端口
`volumes`	将配置目录挂载到宿主机，数据持久化
`restart`	容器异常退出时自动重启

启动服务

1
docker compose up -d

等待镜像拉取完成后，Sun Panel 即可启动运行。

访问与初始化

部署完成后，在浏览器中访问：

1
http://你的IP:3002

首次访问即可进入 Sun Panel 的主界面。默认无需登录即可查看导航页，如需管理可进入后台设置。

后台管理入口

点击页面右上角的设置图标，或在地址栏输入：

1
http://你的IP:3002/#/setting

即可进入后台管理页面，进行小组件、书签、样式等配置。

功能介绍

小组件

Sun Panel 内置多种实用小组件：

天气：显示当前天气信息
便签：快速记录待办事项
书签：收藏常用链接，一键直达
系统信息：展示服务器运行状态（需额外配置）

小组件支持拖拽排列，按需调整位置和大小。

书签管理

在后台设置中可以添加书签分组和链接，支持自定义图标和排序。每个书签分组可以对应一类服务，例如：

📁 文件管理
🖥️ 系统监控
🌐 下载工具
🎬 媒体服务

自定义样式

Sun Panel 支持通过自定义 CSS 覆盖默认样式，打造个性化导航页。在后台设置中找到「自定义样式」选项即可编辑。

进阶配置

反向代理

如果你希望通过域名访问 Sun Panel，可以使用 Nginx 或 Caddy 做反向代理。

Nginx 示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
server {
    listen 80;
    server panel.你的域名.com;

    location / {
        proxy_pass http://127.0.0.1:3002;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

配置完成后记得申请 SSL 证书，启用 HTTPS。

自定义 CSS 示例

以下是一段简单的自定义 CSS，可以让卡片更加圆润：

1
2
3
4
5
6
7
8
.item {
    border-radius: 12px;
}

.item:hover {
    transform: scale(1.02);
    transition: all 0.3s ease;
}

自定义 JS

Sun Panel 也支持自定义 JavaScript，可以实现更高级的交互效果，比如动态问候语、自定义时钟等。

总结

Sun Panel 是一款非常适合 Homelab 使用的导航面板，部署简单、界面美观、功能实用。通过 Docker 几条命令即可完成部署，再配合反向代理和自定义样式，轻松打造个性化的导航首页。

项目地址： https://github.com/slrayyuan/sun-panel

前言