Skip to content

installation.zh-CN.md

Latest commit

 

History

History
236 lines (177 loc) · 6.02 KB

installation.zh-CN.md

File metadata and controls

236 lines (177 loc) · 6.02 KB
Raw

English | 简体中文

安装部署指南

本文档介绍 SublinkPro 的完整安装、更新和卸载方法。

📦 Docker Compose 运行（推荐）

Tip

推荐使用 Docker Compose 部署，便于管理配置、升级和维护。

Important

db/、template/、logs/ 属于运行时持久化目录，请在升级和迁移时保留。

创建 docker-compose.yml 文件：

services:
  sublinkpro:
    # image: zerodeng/sublink-pro:dev # 开发版（功能尝鲜使用）
    image: zerodeng/sublink-pro # 稳定版
    container_name: sublinkpro
    ports:
      - "8000:8000"
    volumes:
      - "./db:/app/db"
      - "./template:/app/template"
      - "./logs:/app/logs"
    restart: unless-stopped

如需扩展更多订阅输出格式，可选部署 Sub-Store sidecar：

services:
  sublinkpro:
    image: zerodeng/sublink-pro
    container_name: sublinkpro
    ports:
      - "8000:8000"
    volumes:
      - "./db:/app/db"
      - "./template:/app/template"
      - "./logs:/app/logs"
    restart: unless-stopped

  substore:
    image: xream/sub-store
    container_name: substore
    environment:
      - SUB_STORE_BACKEND_API_PORT=3000
      - SUB_STORE_BODY_JSON_LIMIT=10mb
    restart: unless-stopped

建议把 Sub-Store 服务仅保留在 Compose 内部网络中，不要直接暴露端口。两个容器启动后，请登录后台进入 用户中心 -> Sub-Store，启用 sidecar、填写类似 http://substore:3000 的 Base URL、选择允许的输出目标并测试连接。Sub-Store 集成只通过该页面管理，不使用环境变量。

如需通过 Cloudflare Tunnel 暴露服务，可在启动后进入 用户中心 -> Cloudflare Tunnel 填写 token 并启动；启用自动连接后会随服务启动连接 Tunnel。完整步骤见 Cloudflare Tunnel 远程访问。

官方 Docker 镜像已内置 cloudflared，非 Docker 部署则需要先按 Cloudflare 官方文档安装 cloudflared。

启动服务：

docker-compose up -d

🐳 Docker 运行

稳定版 
docker run --name sublinkpro -p 8000:8000 \
  -v $PWD/db:/app/db \
  -v $PWD/template:/app/template \
  -v $PWD/logs:/app/logs \
  -d zerodeng/sublink-pro
开发版（功能尝鲜） 
docker run --name sublinkpro -p 8000:8000 \
  -v $PWD/db:/app/db \
  -v $PWD/template:/app/template \
  -v $PWD/logs:/app/logs \
  -d zerodeng/sublink-pro:dev

📝 一键安装/更新脚本

sh -c "$(wget -qO- https://raw.githubusercontent.com/ZeroDeng01/sublinkPro/refs/heads/main/install.sh)"

Note

安装脚本支持以下功能：

  • 全新安装：首次安装时自动完成所有配置
  • 更新程序：检测到已安装时，可选择更新（保留所有数据）
  • 重新安装：可选择是否保留现有数据
  • 恢复安装：检测到旧数据时，可选择恢复安装
  • 支持架构：Linux x64、Linux ARM64、Linux ARMv7 32 位、Linux x86 32 位

🗑️ 一键卸载脚本

sh -c "$(wget -qO- https://raw.githubusercontent.com/ZeroDeng01/sublinkPro/refs/heads/main/uninstall.sh)"

Note

卸载脚本会询问是否保留数据目录（db、logs、template），选择保留可用于后续重新安装时恢复数据。

🔄 项目更新

📝 一键脚本更新

如果您使用一键脚本安装，可以再次运行安装脚本进行更新：

sh -c "$(wget -qO- https://raw.githubusercontent.com/ZeroDeng01/sublinkPro/refs/heads/main/install.sh)"

脚本会自动检测已安装的版本，并提供以下选项：

  • 更新程序：保留所有数据，仅更新程序文件
  • 重新安装：可选择是否保留数据

📦 Docker Compose 手动更新

# 进入 docker-compose.yml 所在目录
cd /path/to/your/sublinkpro

# 拉取最新镜像
docker-compose pull

# 重新创建并启动容器
docker-compose up -d

# （可选）清理旧镜像
docker image prune -f

🐳 Docker 手动更新

# 停止并删除旧容器
docker stop sublinkpro
docker rm sublinkpro

# 拉取最新镜像
docker pull zerodeng/sublink-pro

# 重新启动容器（使用与安装时相同的参数）
docker run --name sublinkpro -p 8000:8000 \
  -v $PWD/db:/app/db \
  -v $PWD/template:/app/template \
  -v $PWD/logs:/app/logs \
  -d zerodeng/sublink-pro

# （可选）清理旧镜像
docker image prune -f

🤖 Watchtower 自动更新

Watchtower 是一个可以自动更新 Docker 容器的工具，非常适合希望保持项目始终最新的用户。

方式一：独立运行 Watchtower

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --cleanup \
  --interval 86400 \
  sublinkpro

Note

  • --cleanup：更新后自动清理旧镜像
  • --interval 86400：每 24 小时检查一次更新（单位：秒）
  • 最后的 sublinkpro 是要监控更新的容器名称，不指定则监控所有容器

方式二：集成到 Docker Compose

在您的 docker-compose.yml 中添加 Watchtower 服务：

services:
  sublinkpro:
    image: zerodeng/sublink-pro
    container_name: sublinkpro
    ports:
      - "8000:8000"
    volumes:
      - "./db:/app/db"
      - "./template:/app/template"
      - "./logs:/app/logs"
    restart: unless-stopped

  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - WATCHTOWER_CLEANUP=true
      - WATCHTOWER_POLL_INTERVAL=86400
    restart: unless-stopped
    command: sublinkpro  # 只监控 sublinkpro 容器

Tip

Watchtower 高级配置：

  • 可以设置 WATCHTOWER_NOTIFICATIONS 环境变量来配置更新通知（支持邮件、Slack、Gotify 等）
  • 更多配置请参考 Watchtower 官方文档