Files
Auto_Bangumi/docs/deploy/docker-cli.md
Estrella Pan b129c4437a chore(release): 准备 4.0.0
- 部署文档、升级指南与 README 改为正式版说法:latest = 4.0,3.3 固定为 3.3.7
- docs/changelog/4.0.md 新增 4.0.0 汇总(升级前必读、破坏性变更、新功能、主要修复),链接改为绝对地址
- 文档站与插件市场改为从 main 发布,插件上架 PR 的目标分支改为 main
- 文档站页脚版本 v4.0.0;en/ja README 的 star history 地址
2026-10-24 11:46:50 +02:00

1.9 KiB

使用 Docker CLI 部署

::: tip 从 3.3 升级 本页命令使用 latest 标签,安装的是 4.0 正式版。正在使用 3.3 时,拉取新镜像前请先阅读 从 3.3 升级到 4.0;暂时不升级,就把标签固定为 3.3.7。4.0 的硬链接插件需要把媒体库目录也挂载进容器,见 番剧管理设置。 :::

新版本说明

从 AutoBangumi 2.6 开始,您可以直接在 WebUI 中配置所有设置。您可以先启动容器,然后在 WebUI 中进行配置。旧版本的环境变量配置将自动迁移。环境变量仍然有效,但仅在首次启动时生效。

创建数据和配置目录

为确保 AB 的数据和配置在更新时持久化,我们建议使用 Docker 卷或绑定挂载。

# 使用绑定挂载
mkdir -p ${HOME}/AutoBangumi/{config,data}
cd ${HOME}/AutoBangumi

选择绑定挂载或 Docker 卷:

# 使用 Docker 卷
docker volume create AutoBangumi_config
docker volume create AutoBangumi_data

使用 Docker CLI 部署 AutoBangumi

复制并运行以下命令。

请确保您的工作目录为 AutoBangumi。

docker run -d \
  --name=AutoBangumi \
  -v ${HOME}/AutoBangumi/config:/app/config \
  -v ${HOME}/AutoBangumi/data:/app/data \
  -p 7892:7892 \
  -e TZ=Asia/Shanghai \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -e UMASK=022 \
  --network=bridge \
  --dns=8.8.8.8 \
  --restart unless-stopped \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  ghcr.io/estrellaxd/auto_bangumi:latest

如果使用 Docker 卷,请相应替换绑定路径:

  -v AutoBangumi_config:/app/config \
  -v AutoBangumi_data:/app/data \

AB WebUI 将自动启动,但主程序处于暂停状态。访问 http://abhost:7892 进行配置。

AB 会自动将环境变量写入 config.json 并开始运行。

我们建议使用 Portainer 或类似的 Docker 管理界面进行高级部署。