超级订阅找资源
超级订阅/安装/使用 Docker

安装指南

使用 Docker

在服务器、NAS 或家用主机上运行 superSubscription。
推荐使用 Docker Compose

配置文件更容易保存和修改，后续更新也只需要两条命令。想快速试用，也可以直接使用 Docker CLI。

安装前准备

你的设备需要安装 Docker Engine，并能够访问 GitHub 和 GitHub Container Registry。当前镜像支持常见的 amd64 和 arm64 设备。

bash
  1. docker --version
  2. docker compose version

两个命令都能正常显示版本号，就可以继续安装。

安装

下面两种方式二选一即可。无论使用哪一种，账号、订阅和任务记录都会保存在 Docker 数据卷中。

Docker CLI

适合快速启动。复制整段命令到终端运行：

bash
  1. docker run -d \
  2. --name super-subscription \
  3. --restart unless-stopped \
  4. -p 3000:3000 \
  5. -e WEB_PORT=3000 \
  6. -e DATAFINDER_URL=https://data.woca.fun \
  7. -v super-subscription-data:/app/data \
  8. ghcr.io/achievehf/super-subscription:latest

Docker Compose

这是当前公开发布使用的完整 Compose 配置：

yaml
  1. services:
  2. super-subscription:
  3. image: ghcr.io/achievehf/super-subscription:latest
  4. container_name: super-subscription
  5. ports:
  6. - "${APP_PORT:-3000}:3000"
  7. environment:
  8. - WEB_PORT=3000
  9. - DATAFINDER_URL=${DATAFINDER_URL:-https://data.woca.fun}
  10. - WEB_ADMIN_USERNAME=${WEB_ADMIN_USERNAME:-}
  11. - WEB_ADMIN_PASSWORD=${WEB_ADMIN_PASSWORD:-}
  12. - WEB_ADMIN_USERNAME_RESET=${WEB_ADMIN_USERNAME_RESET:-}
  13. - WEB_ADMIN_PASSWORD_RESET=${WEB_ADMIN_PASSWORD_RESET:-}
  14. volumes:
  15. - super-subscription-data:/app/data
  16. restart: unless-stopped
  17. healthcheck:
  18. test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
  19. interval: 30s
  20. timeout: 5s
  21. retries: 3
  23. volumes:
  24. super-subscription-data:

可以手动保存为 docker-compose.yml，也可以运行下面的命令直接下载并启动：

bash
  1. mkdir -p supersubscription && cd supersubscription
  2. curl -fsSLO https://raw.githubusercontent.com/AchieveHF/superSubscription-docker/main/docker-compose.yml
  3. echo "APP_PORT=3000" > .env
  4. docker compose up -d
启动完成

浏览器访问 http://设备IP:3000。例如设备 IP 是 192.168.1.20，地址就是 http://192.168.1.20:3000。

配置说明

大多数用户只需要修改访问端口，其余配置保持默认即可。

名称默认值说明
APP_PORT3000设备上访问管理后台的端口，只用于 Compose。
DATAFINDER_URLhttps://data.woca.fun超级订阅服务地址，通常不需要修改。
WEB_ADMIN_USERNAME空可选。留空时在第一次打开页面时设置管理员账号。
WEB_ADMIN_PASSWORD空可选。建议留空并在页面中设置，避免密码留在终端记录中。
WEB_ADMIN_*_RESET空仅用于旧版本的管理员恢复，正常安装不需要设置。
数据卷super-subscription-data保存管理员、网盘登录、订阅和任务数据。

如果 3000 端口已被占用，把 .env 中的 APP_PORT=3000 改为其他端口，例如 APP_PORT=3080，然后重新运行 docker compose up -d。

首次使用

  1. 1
    设置管理员账号

    第一次打开管理后台时，按照页面提示创建登录账号和密码。

  2. 2
    添加网盘

    登录需要自动转存的夸克、阿里云盘或 115 账号。

  3. 3
    绑定微信

    绑定你登录 supersub.top 时使用的微信账号。

  4. 4
    添加订阅

    回到资源站订阅影视；发现更新后，Docker 设备会自动处理。

更新

Docker Compose 用户进入安装目录后，拉取新镜像并重新启动容器：

bash
  1. cd supersubscription
  2. docker compose pull
  3. docker compose up -d

使用 Docker CLI 的用户先执行 docker pull ghcr.io/achievehf/super-subscription:latest，删除旧容器后，再重新运行上面的 Docker CLI 安装命令。数据卷不会随容器删除。

常用命令

docker compose ps查看运行状态
docker compose logs -f --tail=100查看最近日志，按 Ctrl+C 退出
docker compose restart重启服务
docker compose stop暂停服务
docker compose up -d启动或应用新配置

卸载

停止并删除容器，但保留账号和订阅数据：

bash
  1. docker compose down
谨慎删除数据

docker compose down -v 会连同数据卷一起删除。只有确认不再需要管理员、网盘登录、订阅和任务记录时才能执行。

常见问题

关闭 SSH 或终端后还会运行吗？

会。安装命令使用后台运行模式，关闭终端不会停止容器。

设备重启后需要手动启动吗？

通常不需要。容器设置了 restart: unless-stopped，Docker 启动后会自动恢复。

一定要有公网 IP 吗？

不需要。设备能够正常联网即可，管理后台可以只在局域网中访问。

为什么管理后台打不开？

先运行 docker compose ps 确认容器状态，再检查设备防火墙是否允许访问所设置的端口。