热门搜索:
ghcr.io/suwayomi/suwayomi-server:v2.1.2031-preview
ghcr.iolinux/amd64v2.1.2031-preview大小: 未知更新于 2026年5月23日
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] 提供环境变量会在启动容器时覆盖当前的设置值。
提示：大多数情况下您不需要使用环境变量，而是可以在运行时通过 WebUI 修改设置。（提供环境变量会使这些设置失效）
提示：密码可以通过文件提供，方法是在变量名后附加
_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（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 副本，您可以在 [***] 获取。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
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（解压）
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访问体验非常流畅，大镜像也能快速完成下载。"