Docker部署Sub-Store订阅管理系统

一、Sub-Store 简介#

Sub-Store 是一款开源的订阅转换服务，支持聚合多个订阅链接并输出为不同客户端格式。

它能让你：

将多个机场或自建节点订阅整合；
输出为 Clash / Surge / QuantumultX / Loon / Shadowrocket 等格式；
自定义节点筛选、排序、分组；
通过 Web 界面轻松管理。

GitHub 项目地址：
👉 https://github.com/sub-store-org/Sub-Store

二、部署环境准备#

推荐系统环境：


系统	支持
Debian 12 / Ubuntu 22.04	✅ 推荐
Alpine / CentOS 7+	✅ 支持
内存要求	≥ 256MB

确保系统已安装：

1
apt update && apt install -y docker.io docker-compose

三、Docker Compose 配置文件#

在服务器任意目录（如 /root/sub-store）下创建文件：

1
mkdir -p /root/sub-store
2
cd /root/sub-store
3
nano docker-compose.yml

然后粘贴以下内容 👇：

1
version: "3.8"
2

3
services:
4
  sub-store:
5
    image: xream/sub-store:latest
6
    container_name: sub-store
7
    restart: always
8
    ports:
9
      - "127.0.0.1:3001:3001"
10
    volumes:
11
      - ./data:/opt/app/data
12
    environment:
13
      SUB_STORE_FRONTEND_BACKEND_PATH: /MySecretToken123
14
      SUB_STORE_BACKEND_SYNC_CRON: "55 23 * * *"
15
      SUB_STORE_BODY_JSON_LIMIT: 10mb

四、配置详解#


配置项	示例值	作用	说明
version	`"3.8"`	Compose 文件版本	指定 Docker Compose 的语法版本，3.8 适用于较新的 Docker
services	`sub-store`	服务定义	定义一个名为 `sub-store` 的服务
image	`xream/sub-store:latest`	Docker 镜像	使用 Sub-Store 官方镜像，`latest` 表示最新版本
container_name	`sub-store`	容器名称	指定容器名称为 `sub-store`，方便管理和查看日志
restart	`always`	自动重启策略	容器异常退出或 Docker 重启时会自动重新启动
ports	`"127.0.0.1:3001:3001"`	端口映射	将宿主机本地回环地址（127.0.0.1）的 3001 端口映射到容器的 3001 端口。
volumes	`./data:/opt/app/data`	数据持久化	将本地 `./data` 目录映射到容器 `/opt/app/data`，用于保存配置和数据
environment	环境变量配置	程序运行参数	用来控制 Sub-Store 的运行行为

⚠️ 建议你修改：

1
SUB_STORE_FRONTEND_BACKEND_PATH=/MySecretToken123

示例：

1
/rd304CYuZ2KByUk4WRHF

这样可以防止被随意访问。

随机生成密码网站：https://1password.com/zh-cn/password-generator

五、启动服务#

保存文件后执行：

1
docker compose up -d

查看运行状态：

1
docker ps

若一切正常，你会看到类似输出：

1
    CONTAINER ID   IMAGE             STATUS          PORTS
2
    a1b2c3d4e5f6   xream/sub-store   Up 10 seconds   0.0.0.0:3001->3001/tcp

六、Caddy反代#

编辑/etc/caddy/Caddyfile

1
nano /etc/caddy/Caddyfile

1
example.com {
2
   reverse_proxy localhost:3001
3
 }

重启caddy

1
systemctl restart caddy

七、访问与初始设置#

浏览器访问：

https://你的域名

若配置了后端路径（如 /ks9foTp4xE8fr24pg2DZ），
打开 反代域名 输入后端路径ks9foTp4xE8fr24pg2DZ

你会看到 Sub-Store 的管理界面，可以：

添加或导入订阅；
设置转换规则；
生成统一的订阅链接。

八、设置Gist同步#

1.拥有一个 GitHub 账号#

注册或登录：https://github.com/

2.获取一个 GitHub Personal Access Token（访问令牌）#

打开 https://github.com/settings/tokens
点击Token（classic）并在右上选择Generate new token（classic）
勾上Repo和Gist这两项后，点击底下的Generate token即生成Token了
生成后复制该 token（⚠️ 只显示一次！）

建议保存到安全的地方，例如 ~/.config/sub-store/token.txt。

3.Sub-store设置Gist同步#

将Github用户名和获取的Token粘贴进去即可