Sub Store 部署教程(2026最新,一键Docker搭建)

一什么是 Sub Store？

Sub Store 是一款专注于订阅转换与节点管理的开源工具，广泛应用于 Clash、Surge、Quantumult X 等代理客户端生态中。它的核心价值在于：

• 将各类机场订阅链接统一转换为目标客户端所需的配置格式
• 支持对节点进行分组、过滤、重命名、排序等精细化管理
• 提供 Web UI，操作直观，无需手动编辑 YAML / JSON
• 自建部署后永久可用，不依赖第三方转换服务，隐私更有保障

相比在线转换服务，自建 Sub Store 的最大优势是稳定性与可控性——订阅不会因为第三方服务关闭而失效。

二部署前的环境准备

本文以 Docker 方式部署为主线，这也是目前最简单、最推荐的方式。在开始之前，请确认以下条件：

2.1 服务器要求

2.2 安装 Docker（已安装可跳过）

执行以下命令，在 Ubuntu / Debian 上一键安装 Docker：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER && newgrp docker

三一键 Docker 部署 Sub Store

Sub Store 官方提供了 Docker 镜像，整个部署过程只需三步，5 分钟内即可完成。

3.1 拉取镜像并启动容器

直接运行以下命令，Docker 会自动拉取最新镜像并后台启动：

docker run -d \
  --name sub-store \
  --restart always \
  -p 3000:3000 \
  -v $HOME/sub-store-data:/opt/app/data \
  xream/sub-store

参数说明：

• -d：后台运行（守护进程模式）
• --restart always：服务器重启后自动拉起容器
• -p 3000:3000：将容器内 3000 端口映射到宿主机 3000 端口
• -v：数据持久化，订阅配置保存在宿主机 ~/sub-store-data 目录

3.2 使用 Docker Compose（推荐生产环境）

新建目录并创建 docker-compose.yml 文件：

mkdir -p ~/sub-store && cd ~/sub-store
nano docker-compose.yml

写入以下内容：

version: '3.8'
services:
  sub-store:
    image: xream/sub-store:latest
    container_name: sub-store
    restart: always
    ports:
      - '3000:3000'
    volumes:
      - ./data:/opt/app/data

保存后执行启动命令：

docker compose up -d

3.3 验证部署状态

查看容器运行状态：

docker ps | grep sub-store

若输出中显示 Up xx seconds/minutes，说明容器运行正常。在浏览器中访问：

http://你的服务器IP:3000

能看到 Sub Store 的 Web 管理界面即部署成功。

四访问与基本安全配置

4.1 设置访问 Token（强烈建议）

默认情况下，Sub Store 无鉴权保护，任何人知道地址都可以访问管理界面。建议通过环境变量设置 Token：

docker run -d \
  --name sub-store \
  --restart always \
  -p 3000:3000 \
  -e SUB_STORE_FRONTEND_BACKEND_PATH=/你的随机字符串 \
  -v $HOME/sub-store-data:/opt/app/data \
  xream/sub-store

4.2 配合 Nginx 反向代理（可选）

如需绑定域名并启用 HTTPS，可在 Nginx 中添加如下配置：

server {
    listen 443 ssl;
    server_name sub.yourdomain.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

五添加订阅与对接 Clash / Surge

5.1 在 Web UI 中添加订阅

打开 Sub Store Web 界面后，点击右上角「+」新建订阅，将机场的订阅链接粘贴进去，支持以下操作：

• 对节点按关键词过滤（如只保留「香港」「日本」节点）
• 批量重命名，统一节点命名风格
• 合并多个机场订阅为一个统一链接
• 设置地区分组，生成规则集

5.2 生成并使用转换链接

配置完成后，Sub Store 会生成一条专属的转换订阅 URL，格式如下：

http://你的IP:3000/download/你的订阅名称?target=clash

target 参数对应目标客户端，常用值包括：

将此 URL 填入对应客户端的订阅地址栏，即可正常使用。

六常见问题排查

docker pull xream/sub-store:latest
docker stop sub-store && docker rm sub-store