查看“︁如何部署sub-store”︁的源代码



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

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

== 第一步：远程登录你的 bandwagonhost VPS ==
首先，你需要通过 SSH 客户端（如 PuTTY、Termius 或 macOS/Windows 自带的终端）登录到你的服务器。

Bash
 <code>ssh root@你的服务器IP</code>
''输入密码时屏幕不会显示字符，直接回车即可。''
----

== 第二步：环境准备（Docker 快速安装） ==
大多数 Sub-Store 一键脚本或容器化部署都依赖 '''Docker'''。如果你的服务器还没安装，可以使用以下官方的一键脚本：

Bash
 <code>curl -fsSL <nowiki>https://get.docker.com</nowiki> | bash -s docker
 systemctl enable --now docker</code>
安装完成后，确认 Docker 正在运行：

<code>docker version</code>
----

== 第三步：一键部署 Sub-Store ==
Sub-Store 官方支持使用 Docker 命令快速启动。我们将使用 '''Docker Compose''' 方式，因为它更方便后续修改配置。

=== 1. 创建工作目录 ===
Bash
 <code>mkdir -p /root/sub-store && cd /root/sub-store</code>

=== 2. 创建并编辑配置文件 ===
使用 <code>vi</code> 或 <code>nano</code> 创建一个 <code>docker-compose.yml</code> 文件：

Bash
 <code>nano docker-compose.yml</code>
将以下内容复制并粘贴进去：

YAML
 <code>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=/你的随机路径</code>
<blockquote>'''注意：''' <code>SUB_STORE_FRONTEND_BACKEND_PATH</code> 建议设置一个复杂的随机字符串（例如 <code>/mysecret_2026</code>），防止别人直接扫描到你的后台。</blockquote>

=== 3. 启动容器 ===
按下 <code>Ctrl+O</code> 保存，<code>Ctrl+X</code> 退出，然后运行：

Bash
 <code>docker compose up -d</code>
----

== 第四步：配置防火墙 ==
VPS 默认可能关闭了 3001 端口，你需要手动开启：

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

----

== 第五步：访问与使用 ==
部署完成后，你可以通过浏览器访问 Sub-Store 的 Web 界面：

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

----

== 常见问题小贴士 ==
{| class="wikitable"
|'''需求'''
|'''操作'''
|-
|'''查看日志'''
|<code>docker logs -f sub-store</code>
|-
|'''更新版本'''
|<code>docker compose pull && docker compose up -d</code>
|-
|'''停止服务'''
|<code>docker compose down</code>
|}
'''下一步建议：'''

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