如何部署sub-store

在 bandwagonhost VPS 上部署 Sub-Store（高级订阅管理工具）其实非常简单。Sub-Store 官方提供了非常便捷的 Docker 镜像，通过 Docker 部署是目前最稳定、也是维护成本最低的方式。

以下是为你整理的从“零”开始的部署教程。

第一步：远程登录你的 bandwagonhost VPS

首先，你需要通过 SSH 客户端（如 PuTTY、Termius 或 macOS/Windows 自带的终端）登录到你的服务器。

Bash

ssh root@你的服务器IP

输入密码时屏幕不会显示字符，直接回车即可。

第二步：环境准备（Docker 快速安装）

大多数 Sub-Store 一键脚本或容器化部署都依赖 Docker。如果你的服务器还没安装，可以使用以下官方的一键脚本：

Bash

curl -fsSL https://get.docker.com | bash -s docker
systemctl enable --now docker

安装完成后，确认 Docker 正在运行：

docker version

第三步：一键部署 Sub-Store

Sub-Store 官方支持使用 Docker 命令快速启动。我们将使用 Docker Compose 方式，因为它更方便后续修改配置。

1. 创建工作目录

Bash

mkdir -p /root/sub-store && cd /root/sub-store

2. 创建并编辑配置文件

使用 vi 或 nano 创建一个 docker-compose.yml 文件：

Bash

nano docker-compose.yml

将以下内容复制并粘贴进去：

YAML

version: '3'
services:
  sub-store:
    image: xream/sub-store:latest
    container_name: sub-store
    restart: always
    volumes:
      - ./data:/opt/sub-store/data
    ports:
      - "3001:3001"
    environment:
      - SUB_STORE_FRONTEND_BACKEND_PATH=/你的随机路径

注意： SUB_STORE_FRONTEND_BACKEND_PATH 建议设置一个复杂的随机字符串（例如 /mysecret_2026），防止别人直接扫描到你的后台。

3. 启动容器

按下 Ctrl+O 保存，Ctrl+X 退出，然后运行：

Bash

docker compose up -d

第四步：配置防火墙

VPS 默认可能关闭了 3001 端口，你需要手动开启：

如果使用 UFW (Ubuntu/Debian): ufw allow 3001/tcp
如果使用 CentOS (Firewalld): firewall-cmd --zone=public --add-port=3001/tcp --permanent && firewall-cmd --reload
云服务商控制台： 请务必在腾讯云/阿里云/甲骨文的“安全组”页面，放行 3001 端口。

第五步：访问与使用

部署完成后，你可以通过浏览器访问 Sub-Store 的 Web 界面：

访问地址： http://你的服务器IP:3001
进阶技巧： 如果你设置了 SUB_STORE_FRONTEND_BACKEND_PATH，请在进入页面后，在设置里填入对应的路径，确保前端和后端能够通信。

常见问题小贴士

需求	操作
查看日志	`docker logs -f sub-store`
更新版本	`docker compose pull && docker compose up -d`
停止服务	`docker compose down`

下一步建议：

为了安全起见，建议你使用 Nginx Proxy Manager 为这个地址配置一个 SSL 域名访问（HTTPS），避免订阅链接在明文传输中被拦截。需要我为你补充如何配置 Nginx 反向代理吗？