ghcr.io/suwayomi/tachidesk:v2.4.2378
ghcr.iolinux/amd64v2.4.2378大小: 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 容器
| 状态 | 稳定版 | 预览版 | *** 支持 |
在 Docker 容器中以非 root 用户身份运行 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 镜像为多架构构建（支持 linux/amd64、linux/arm64/v8、linux/ppc64le、linux/s390x、linux/riscv64），基于 Ubuntu Linux 构建，体积小巧。
日志将输出到 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: # 挂载顺序至关重要！请确保下载目录卷排在卷列表的第一位，否则配置将不生效
- /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 v. 2.0 许可协议开源。
许可协议
本源代码形式受 Mozilla 公共许可 2.0 版本约束。如果您未随本文件一同收到 MPL 2.0 协议副本，可访问 http://mozilla.org/MPL/2.0/ 获取。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"