热门搜索:
ghcr.io/suwayomi/suwayomi-server:v2.2.2174
ghcr.iolinux/amd64v2.2.2174大小: 未知更新于 2026年6月6日
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：
生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/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，在浏览器中打开此 URL。
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 会无限期存储日志，您可以全局配置日志或使用日志驱动编辑 compose 文件。
Docker Compose
使用此仓库中的模板 docker-compose.yml 创建并启动 Tachidesk Docker 容器。
Podman Quadlet
使用此仓库中的模板 suwayomi-server.container 以无 root 权限的 Podman 容器形式创建并启动 Suwayomi。
环境变量
[!WARNING] 提供环境变量将在启动容器时覆盖当前设置值。
[!Tip] 大多数情况下，您不需要使用环境变量，而是可以在运行时通过 WebUI 修改设置。（提供环境变量会使这些设置失效）
[!Tip] 密码可以通过文件提供，方法是在变量名后附加
_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 | 容器的时区。 |
| 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 代理的密码 |
| DOWNLOAD_AS_CBZ | false | Suwayomi 是否以 CBZ 格式将漫画保存到磁盘 |
| 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 或 Custom |
| WEB_UI_CHANNEL | stable | "bundled"（与服务器版本捆绑的版本）、"stable" 或 "preview" - 应使用的 WebUI 版本 |
| WEB_UI_UPDATE_INTERVAL | 23 | 自动更新间隔时间（小时）- 0 表示禁用自动更新 - 范围：1 |
[!IMPORTANT] 已知此 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 副本，您可以在 [***] 获取。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
用 AI 使用轩辕镜像
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
轩辕镜像是否实时全量同步原仓库的所有镜像？
原仓库同步与拉取
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
轩辕镜像支持 docker push 上传本地镜像吗？
不支持 push
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
拉取老镜像提示 Schema 1 已废弃怎么办？
Schema 1 已废弃
Docker 拉取出现 406 或 OCI index 不支持怎么办？
406 OCI index
docker pull 出现 422 Unknown 怎么办？
422 Unknown
拉取镜像提示 TAG_INVALID 或无效标签（400）怎么办？
400 TAG_INVALID
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"