喵pass

使用 Docker Compose 部署Sun-Panel

2025/10/30
19
0

Sun-Panel

官方地址:Sun-Panel

一个NAS、服务器导航面板、简易docker管理器、Homepage、浏览器首页。

特点

  • 🍉 界面简洁,功能强大,资源占用少

  • 🍊 上手简单,可视化操作,可0代码使用

  • 🍠 一键切换内、外网模式链接

  • 🍵 支持docker部署(支持Arm系统)

  • 🎪 支持多账号隔离使用

  • 🎏 支持查看系统状态

  • 🫙 支持自定义js、css

  • 🍻 简单使用可以无需连接外部数据库

  • 🍾 丰富图标风格自由搭配,支持iconify图标库

  • 🚁 支持网页内置小窗口打开(部分三方网站屏蔽此功能)

  • 🐳 简单的docker管理器,支持查看容器状态、控制容器的开启和关闭

部署教程

一、默认账号密码

  • 账号:admin@sun.cc

  • 密码:12345678

二、命令参数

1. v1.4.0+ 版本

参数

说明

-h

查看命令说明

-config-reset

生成或重置配置文件(conf/conf.ini)

-config-path

指定程序配置文件的目录 (默认 "./conf")

-password-reset

重置第一个管理账号的密码

2. v1.3.0 及之前版本

[v1.3.0 及之前版本命令参数查看链接](此处需替换为原网页中 “点此查看” 对应的实际链接,原文档未提供具体链接,可保留 “v1.3.0 及之前版本,请点此查看” 的文字提示)

参数

说明

-h

查看命令说明

-config

生成配置文件(conf/conf.ini)

-password-reset

重置第一个管理账号的密码

三、docker 运行

提示:[DockerHub Sun-Panel 项目首页](此处需替换为原网页中 “DockerHub Sun-Panel 项目首页” 对应的实际链接,原文档未提供具体链接,可保留文字提示)

1. v1.4.0+ 版本

(1)目录挂载说明

目录挂载 -v 全部可选,可根据自身需求选择:

本地目录

容器目录

说明

~/sun-panel/conf

/app/conf

配置文件(多合一目录)

/var/run/docker.sock

/var/run/docker.sock

若想在容器中使用 docker 功能,请挂载此目录(非特殊情况下,请原样挂载),支持 v1.5.0+ 版本

~/sun-panel/runtime

/app/runtime

运行日志(不推荐挂载)

(2)拉取最新镜像

sh

docker pull hslr/sun-panel:latest

(3)直接下载运行

latest 可以替换成其他版本号(版本查看链接),示例已挂载 docker 目录,可在容器中使用 docker:

sh

docker run -d --restart=always -p 3002:3002 \
-v ~/docker_data/sun-panel/conf:/app/conf \
-v /var/run/docker.sock:/var/run/docker.sock \
--name sun-panel \
hslr/sun-panel:latest
  • 容器端口默认:3002

  • --restart=always:设置容器自动重启

  • -d:设置容器后台运行

2. v1.3.0 及之前版本

v1.3.0 及之前版本 docker 运行详情查看链接

(1)目录挂载说明

目录挂载 -v 全部可选,可根据自身需求选择:

容器目录

说明

/app/conf

配置文件

/app/uploads

上传的文件

/app/database

数据库文件

/app/runtime

运行日志 (不推荐挂载)

/app/web/custom

自定义(js,css 等),仅限 v1.3.0 版本

(2)直接下载运行

sh

docker run -d --restart=always -p 3002:3002 \
-v ~/docker_data/sun-panel/conf:/app/conf \
-v ~/docker_data/sun-panel/uploads:/app/uploads \
-v ~/docker_data/sun-panel/database:/app/database \
--name sun-panel \
hslr/sun-panel

四、docker-compose 运行

仅供参考,请根据自身需求修改,支持 v1.4.0 及以上版本

1. 配置文件内容

yaml

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

2. 运行命令

sh

docker-compose up -d

五、可执行(二进制)文件运行

提示:前往 [Github Releases](此处需替换为原网页中 “Github Releases” 对应的实际链接,原文档未提供具体链接,可保留文字提示) 下载二进制文件

执行示例(命令行运行)

sh

./sun-panel

赞赏码.png