Skip to content

一键部署 ​

一键部署从公开镜像部署服务。

准备 ​

  • 一台 Linux 服务器。
  • 服务器能访问 GitHub Release 和 GHCR 镜像。
  • 服务器已有 curl。
  • 请在个人局域网内部署,部署在公网请务必配置 TLS 加密。

运行安装脚本 ​

在服务器终端运行:

bash
curl -fsSL https://github.com/SubBoost/subboost/releases/latest/download/install.sh | bash

脚本将:

  • 检查 Docker 和 Docker Compose。
  • 缺少 Docker 时提示是否安装。
  • 创建安装目录,默认是 /opt/subboost。
  • 生成 .env 里的数据库密码、加密密钥和首次管理员初始化令牌。
  • 下载 Compose 文件和镜像。
  • 安装 subboost 管理命令。
  • 启动服务。

设置访问地址 ​

安装时会询问访问地址和端口。直接回车会自动填入服务器 IP 并选择可用端口。

创建管理员 ​

安装完成后会显示访问地址和首次初始化链接:

text
访问地址: http(s)://<访问地址>:<端口>
首次初始化链接: http(s)://<访问地址>:<端口>/login#setup-token=<初始化令牌>

复制首次初始化链接,在浏览器中打开并创建管理员。该链接包含初始化令牌,请勿分享。

检查 ​

安装完成后运行:

bash
subboost status

运行完整检查:

bash
subboost doctor

如果页面打不开,先看日志:

bash
subboost logs

备份 ​

创建管理员后运行:

bash
subboost backup

备份包含数据库和 .env。两者必须一并保存,否则无法解密已有订阅。

常用命令 ​

命令用途
subboost status查看运行状态和访问地址。
subboost doctor检查 Docker、配置和健康接口。
subboost logs查看日志。
subboost backup备份数据库和 .env。
subboost update更新到最新版本。
subboost restart重启服务。

相关文档 ​