SubBoost Youko 自部署

VPS 安装部署教程

这份教程按“能跑起来、能生成正确订阅链接、方便后续更新”的顺序写。你用 Cloudflare Tunnel 或其它反向代理时，重点确认 APP_URL 是最终给 Clash 客户端导入的公网域名。

查看运行站点

关键检查

后台“账户设置 / 运行站点”里，订阅分享主域名应显示你的正式域名。

备份重点

保存 local/.env 和数据库备份。ENCRYPTION_KEY 丢了，已保存订阅配置无法解密。

1. 登录 VPS

用 SSH 登录你的服务器。建议使用 Ubuntu 22.04/24.04 或 Debian 12，内存至少 1GB。

ssh root@你的服务器IP

2. 安装 Docker

如果服务器还没有 Docker，可以先安装 Docker 和 Compose 插件。

curl -fsSL https://get.docker.com | bash
docker compose version

3. 拉取项目

把你二改后的 GitHub 仓库拉到服务器。下面地址按你的仓库为例。

git clone https://github.com/youko-nobody/subboost-youko.git
cd subboost-youko

4. 创建环境变量

复制示例环境变量，然后编辑 local/.env。最重要的是 APP_URL，公网域名部署时必须写正式域名。

cp local/local.env.example local/.env
nano local/.env

5. 启动服务

首次启动会构建镜像并启动数据库、应用和定时任务。

docker compose --env-file local/.env -f local/docker-compose.yml up -d --build

6. 创建管理员

浏览器打开初始化链接，把 LOCAL_SETUP_TOKEN 换成 local/.env 里的值，创建第一个管理员账号。

https://你的域名/login#setup-token=你的LOCAL_SETUP_TOKEN

local/.env 小白说明

APP_URL

正式访问地址。Cloudflare Tunnel 用 https://你的域名这种公网域名。

SUBBOOST_PORT

容器映射到服务器的端口，常用 3000。

DATABASE_URL

数据库连接串，密码要和 POSTGRES_PASSWORD 一致。

ENCRYPTION_KEY

加密保存订阅配置的密钥，部署后不要随便改。

JWT_SECRET

登录会话密钥，部署后不要随便改。

CRON_SECRET

定时任务调用接口的密钥。

LOCAL_SETUP_TOKEN

首次初始化管理员用的令牌，初始化后仍建议妥善保存。

通过 Cloudflare Tunnel 访问时，APP_URL 写隧道域名，例如 https://你的域名，不要写 localhost，也不要写容器内地址。

常用维护命令

docker compose --env-file local/.env -f local/docker-compose.yml ps
docker compose --env-file local/.env -f local/docker-compose.yml logs -f app
git pull
docker compose --env-file local/.env -f local/docker-compose.yml up -d --build
docker compose --env-file local/.env -f local/docker-compose.yml down

改了 APP_URL、密钥或端口后，需要重新 up -d。更新代码后建议重新构建镜像。