如何部署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 反向代理嗎？