SaveXTube Server 部署教程：Docker 三步跑起来

在 NAS 或服务器上新建一个目录，之后所有数据都会落在这里。例如下面的 ~/savextube：

mkdir -p ~/savextube && cd ~/savextube

• 建议放在共享盘：如果希望家人也能访问下载好的媒体，把目录建在 NAS 的共享文件夹里，而不是系统盘。
• 注意磁盘配额：视频体积较大，确认目标卷剩余空间充足。

在该目录下新建 docker-compose.yml，把下面的内容原样粘贴进去并保存。五段 volumes 分别对应下载内容、Cookies、静态配置、数据库与日志：

services:
  savextube:
    image: savextube/savextube-pro:latest
    container_name: savextube
    restart: unless-stopped
    ports:
      - "8530:8530"
    volumes:
      - ./data/downloads:/downloads
      - ./data/cookies:/app/cookies
      - ./data/config:/app/config
      - ./data/db:/app/db
      - ./data/logs:/app/logs

• restart: unless-stopped：设备重启或容器异常退出后自动恢复运行，保证 7×24 常驻。
• 端口冲突：如果 8530 已被占用，改冒号左侧的宿主机端口即可，例如 "9530:8530"；右侧容器内端口不要动。

在同一目录执行下面的命令，拉取镜像并后台运行：

docker compose up -d

首次启动会自动拉取镜像并初始化数据库，看到控制台登录页即部署成功。浏览器打开 http://设备IP:8530 即可：

• 首次登录：首次启动会创建默认管理员账号 admin / admin，登录后请立即修改密码。
• 局域网访问：手机、平板只要和 NAS 在同一网络，输入同样的地址就能直接提交下载任务。
• 查看启动日志：如果页面打不开，先执行 docker compose logs -f savextube 看实时输出。

容器本身是无状态的，所有重要数据都在宿主机的 ./data/ 下。备份时只要备份这五个目录即可：

• ./data/downloads —— 下载内容落盘位置，建议指向 NAS 的共享盘，媒体按来源自动分类。
• ./data/cookies —— 各平台登录凭证，浏览器导出后放进这里，会员与高清内容也能下。
• ./data/config —— TOML 静态配置与环境变量，功能开关在线修改，配置热更新。
• ./data/db —— 任务、历史与用户账户数据库，建议随 NAS 备份一起定期备份。
• ./data/logs —— 运行日志目录，下载异常时第一时间查这里。

后续维护只需要这几条命令，都在 docker-compose.yml 所在目录执行：

# 升级到最新版本
docker compose pull && docker compose up -d

# 实时查看运行日志
docker compose logs -f savextube

# 停止 / 重新启动
docker compose down
docker compose up -d

• 升级不丢数据：镜像更新只替换容器层，./data/ 下的下载内容、账户与配置保持原样。
• 页面打不开：先确认容器在运行（docker compose ps），再看是否被宿主机防火墙或 NAS 安全策略拦截了端口。
• 计划中的安装方式：后续会以 fnOS 飞牛与群晖 DSM 应用包的形式分发，届时无需手动编辑 compose 文件。