ghcr.io/suwayomi/tachidesk:v2.2.2142
ghcr.iolinux/amd64v2.2.2142大小: 340.46 MB更新于 2026年6月21日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Suwayomi-Server Docker容器
| 状态 | 稳定版 | 预览版 | ***支持 |
|---|
以非root用户身份在Docker容器内运行https://github.com/Suwayomi/Suwayomi-Server%E3%80%82%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B0%86%E8%BF%90%E8%A1%8C%E5%9C%A8 http://localhost:4567%EF%BC%8C%E5%9C%A8%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E6%89%93%E5%BC%80%E6%AD%A4URL%E5%8D%B3%E5%8F%AF%E3%80%82
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/%E6%88%96https://docs.docker.com/reference/compose-file/services/#logging%E3%80%82
Docker compose
使用本仓库中的模板 docker-compose.yml 创建并启动Tachidesk Docker容器。
Podman Quadlet
使用本仓库中的模板 suwayomi-server.container 以无root权限的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%E3%80%82
以下是可用于配置Suwayomi的环境变量：
| 变量 | 服务器默认值 | 描述 |
|---|---|---|
| TZ | Etc/UTC | 容器的时区。 |
| ***D_IP | 0.0.0.0 | 容器内监听的接口。几乎无需修改此值。 |
| ***D_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代理的登录密码 |
| DOWNLOAD_AS_CBZ | false | Suwayomi是否以CBZ格式将漫画保存到磁盘 |
| AUTH_MODE | none | Suwayomi是否需要登录。none（无需登录）、basic_auth（基本认证）、simple_login（简单登录）或 ui_login（UI登录） |
| 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 或 Custom |
| WEB_UI_CHANNEL | stable | "bundled"（与服务器版本捆绑的版本）、"stable"（稳定版）或 "preview"（预览版）- 应使用的webUI版本 |
| WEB_UI_UPDATE_INTERVAL | 23 | 时间（小时）- 0表示禁用自动更新 - 范围：1 [!WARNING] |
[!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%E3%80%82
下载文件夹
不允许配置下载文件夹，因为Docker卷可替代实现此功能，以下是包含下载卷配置的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
服务器的最新预览版。可能存在bug！
致谢
https://github.com/Suwayomi/Suwayomi-Server 采用 MPL v. 2.0 许可协议。
许可协议
本源代码形式受Mozilla Public License, v. 2.0条款约束。如果未随本文件一同分发MPL副本，您可以在 http://mozilla.org/MPL/2.0/ 获取。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"