通过 Docker 在 VPS 上部署 Sub-Store

前言#

Sub-Store 是目前最强大的高级订阅管理工具。不同于基础的订阅转换，它更像是一个针对代理配置的“后端工作站”。

我个人主要将其用于以下场景：

多订阅聚合管理：将多个机场订阅和零散的自建节点整合，去重并重命名，保持节点列表整洁。
配置动态生成：利用其强大的文件存取和脚本（Script）功能，动态生成适配 Sing-box 的 JSON 配置。
一链接走天下：provider 字段中填入订阅，实现只需一条 Sub-Store 链接，即可在 iOS、Android、Windows 等全平台（Mihomo/Sing-box）实现代理通用且自动更新。

sub-store-org

Sub-Store

Waiting for api.github.com...

00K

Waiting...

官方频道
 官方群组

🛠️ 环境准备#

1C 512M即可使用机器为debian13
首先，安装必要的依赖工具

1
apt update && apt install -y curl sudo

🛠️ 安装 Docker#

提示
如果你已经安装过 Docker，可以跳过此步骤。

使用官方脚本一键安装docker

1
curl -fsSL https://get.docker.com -o get-docker.sh
2
sudo sh get-docker.sh

🛠️ 安装Substore#

警告
SUB_STORE_FRONTEND_BACKEND_PATH为substore api，是确保安全的唯一凭证，泄露后他人可随意访问你存的订阅
建议至少20位 本人曾有案例刚部署完50分钟内被扫出来，订阅全部泄露

请务必更改!

请务必更改!!

请务必更改!!!
推荐于1password生成*

提示
可选docker run或docker compose形式

Docker run#

1
docker run -d \
2
    --name sub-store \
3
    --restart=always \
4
    # 仅允许本地回环访问，必须配合反向代理使用
5
    -p 127.0.0.1:3001:3001 \
6
    # 设置容器内部时区为上海
7
    -e TZ="Asia/Shanghai" \
8
    # 每日 23:55 自动执行订阅同步任务
9
    -e SUB_STORE_BACKEND_SYNC_CRON="55 23 * * *" \
10
    # 设置 API 访问的安全后缀（路径）
11
    -e SUB_STORE_FRONTEND_BACKEND_PATH="/63PC2UpfxJicqFu84Zk7" \
12
    # 调高 JSON 限制以支持大型备份文件
13
    -e SUB_STORE_BODY_JSON_LIMIT="20mb" \
14
    # 将持久化数据挂载到宿主机目录
15
    -v /root/sub-store:/opt/app/data \
16
    xream/sub-store:latest

Docker Compose#

自行保存为docker-compose.yml后于对应目录运行

1
services:
2
  sub-store:
3
    image: xream/sub-store:latest
4
    container_name: sub-store
5
    restart: always
6
    ports:
7
      - "127.0.0.1:3001:3001" # 仅暴露内网
8
    environment:
9
      - TZ=Asia/Shanghai
10
      - SUB_STORE_BACKEND_SYNC_CRON=55 23 * * *
11
      - SUB_STORE_FRONTEND_BACKEND_PATH=/63PC2UpfxJicqFu84Zk7 # 安全凭证
12
      - SUB_STORE_BODY_JSON_LIMIT=20mb
13
    volumes:
14
      - /root/sub-store:/opt/app/data

1
docker compose up -d

🛠️ 使用caddy反代#

提示
已安装可跳过
请自行解析域名至你的服务器,也可使用宝塔(nginx)等反代

官方方式安装caddy

1
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl && \
2
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg && \
3
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list && \
4
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg && \
5
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list && \
6
sudo apt update && \
7
sudo apt install caddy

打开/etc/caddy/Caddyfile，添加以下字段覆盖原文

1
substore.xxx.com {   #你的域名
2
    reverse_proxy localhost:3001
3
}

重载caddy并查看日志

1
systemctl reload caddy

1
journalctl -u caddy -f

如无报错等问题，则输入如下网址访问你的substore界面

1
https://你的域名/subs?api=https://你的域名/你设置的api