ghcr.io/suwayomi/suwayomi-server:v2.4.2376
ghcr.iolinux/amd64v2.4.2376大小: 649.10 MB更新于 2026年10月7日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Suwayomi-Server Docker 容器
| 状态 | 稳定版 | 预览版 | *** 技术支持 |
以非 root 用户身份在 Docker 容器中运行 https://github.com/Suwayomi/Suwayomi-Server，服务默认运行在 http://localhost:4567，可直接在浏览器中打开该地址访问。
Docker 镜像发布地址：https://github.com/Suwayomi/Suwayomi-Server-docker/pkgs/container/suwayomi-server Dockerfile 地址：https://github.com/Suwayomi/Suwayomi-Server-docker
Suwayomi 数据存储路径：/home/suwayomi/.local/share/Tachidesk
本 Docker 镜像基于 Ubuntu Linux 构建，体积轻量，支持多架构：linux/amd64、linux/arm64/v8、linux/ppc64le、linux/s390x、linux/riscv64。
容器日志会直接输出到 stdout，便于 Docker 统一管理日志。你可以使用命令 docker logs --tail=1000 查看日志，若使用 docker-compose 部署则可执行 docker compose logs --tail=1000 suwayomi 查看。
默认情况下 Docker 会永久存储日志，你可以参考官方文档https://docs.docker.com/engine/logging/configure/，或者在 Compose 文件中通过https://docs.docker.com/reference/compose-file/services/#logging。
Docker Compose 部署
你可以使用本仓库内的 docker-compose.yml 模板创建并启动 Tachidesk Docker 容器。
Podman Quadlet 部署
你可以使用本仓库内的 suwayomi-server.container 模板，以无根 Podman 容器模式创建并启动 Suwayomi。
环境变量
[!WARNING] 启动容器时如果传入对应环境变量，将会覆盖服务的当前设置值。
[!NOTE] 绝大多数场景下你无需手动配置环境变量，所有设置都可以在服务运行时通过 WebUI 修改；如果通过环境变量强制指定参数，WebUI 内对应的设置项将会失效。
[!NOTE] 支持通过文件形式传入密码类配置：只需在对应变量名后追加
_FILE后缀即可。例如设置SOCKS_PROXY_PASSWORD_FILE=/path/to/myfile后，Suwayomi 会自动读取myfile文件的内容作为 SOCKS 代理的密码。
[!NOTE] 如需查看所有参数默认值，请参考 https://github.com/Suwayomi/Suwayomi-Server 仓库中的 https://github.com/Suwayomi/Suwayomi-Server/blob/master/server/src/main/resources/server-reference.conf 文件。
可用于配置 Suwayomi 的环境变量清单如下：
| 变量名 | 服务默认值 | 说明 |
|---|---|---|
| TZ | Etc/UTC | 容器内部使用的时区 |
| BIND_IP | 0.0.0.0 | 容器内服务监听的网卡地址，几乎不需要修改此参数 |
| BIND_PORT | 4567 | Suwayomi 服务监听的端口 |
| SOCKS_PROXY_ENABLED | false | 是否允许 Suwayomi 通过 SOCKS5 代理建立连接 |
| SOCKS_PROXY_VERSION | 5 | SOCKS 代理的版本号 |
| SOCKS_PROXY_HOST | 空值 | SOCKS 代理的 TCP 主机地址 |
| SOCKS_PROXY_PORT | 空值 | SOCKS 代理的端口 |
| SOCKS_PROXY_USERNAME | 空值 | SOCKS 代理登录用户名 |
| SOCKS_PROXY_PASSWORD | 空值 | SOCKS 代理登录密码 |
| AUTH_MODE | none | Suwayomi 服务的登录校验模式，可选值：none、basic_auth、simple_login、ui_login |
| AUTH_USERNAME | 空值 | Suwayomi 服务的登录用户名 |
| AUTH_PASSWORD | 空值 | Suwayomi 服务的登录密码 |
| JWT_AUDIENCE | suwayomi-server-api | ui_login 模式下 JWT 令牌的受众标识 |
| JWT_TOKEN_EXPIRY | 5m | JWT 访问令牌的有效期，采用 ISO-8601 持续时间格式 |
| JWT_REFRESH_EXPIRY | 60d | JWT 刷新令牌的有效期，采用 ISO-8601 持续时间格式 |
| DEBUG | false | 是否开启调试级详细日志，适用于开发调试与故障排查场景 |
| MAX_LOG_FILES | 31 | 日志文件的最大保留天数，超出天数的旧日志会被自动删除 |
| MAX_LOG_FILE_SIZE | 10mb | 单个日志文件的最大容量，支持的单位：1（字节）、1KB（千字节）、1MB（兆字节）、1GB（吉字节） |
| MAX_LOG_FOLDER_SIZE | 100mb | 所有存储日志文件的总容量上限，支持的单位：1（字节）、1KB（千字节）、1MB（兆字节）、1GB（吉字节） |
| WEB_UI_ENABLED | true | 服务是否对外提供 WebUI 界面 |
| WEB_UI_FLAVOR | WebUI | WebUI 类型，可选值：WebUI、Custom |
| WEB_UI_CHANNEL | stable | 要使用的 WebUI 版本通道，可选值：bundled（服务发布包内置的版本）、stable（稳定版）、preview（预览版） |
| WEB_UI_UPDATE_INTERVAL | 23 | WebUI 自动更新的间隔时长（单位：小时），设置为 0 可关闭自动更新，取值范围：最小值为 1 |
[!WARNING] 已知本 Docker 镜像偶尔会出现启动异常，该问题通常由资源下载故障导致。如果日志输出仅终止在
LD_PRELOAD=/opt/catch_abort.so /home/suwayomi/.local/share/Tachidesk/bin/kcef/libcef.so，请删除本地已拉取的镜像后重新拉取；如果重新拉取后问题仍然存在，请提交https://github.com/Suwayomi/Suwayomi-Server-docker/issues/new 反馈。
下载文件夹配置
我们不支持通过环境变量修改下载文件夹路径，该需求可以完全通过 Docker Volume 实现。以下是包含下载卷配置的 docker-compose.yaml 示例：
suwayomi_server:
image: ghcr.io/suwayomi/suwayomi-server:stable
container_name: Suwayomi-Server
volumes: # 挂载顺序至关重要！请确保 downloads 路径配置在卷列表的首位，否则配置不会生效
- /example/suwayomi-server/downloads:/home/suwayomi/.local/share/Tachidesk/downloads
- /example/suwayomi-server/files:/home/suwayomi/.local/share/Tachidesk
ports:
- 4568:4567
restart: unless-stopped
Docker 标签说明
Latest 标签
ghcr.io/suwayomi/suwayomi-server:latest
对应服务的最新稳定版本，同时也被标记为 :stable。
Preview 标签
ghcr.io/suwayomi/suwayomi-server:preview
对应服务的最新预览版本，该版本可能存在功能缺陷。
版权说明
https://github.com/Suwayomi/Suwayomi-Server 采用 MPL v2.0 许可证开源。
许可证
本源代码文件遵循 Mozilla 公共许可证 MPL 2.0 版本的条款约束。如果您未随本文件一同获得 MPL 2.0 许可证副本，请访问 http://mozilla.org/MPL/2.0/ 获取。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"