如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
| 状态 | 稳定版 | 预览版 | *** 支持 |
以非 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.yml 创建并启动 Tachidesk Docker 容器。
使用此仓库中的模板 suwayomi-server.container 以无 root 权限的 Podman 容器形式创建并启动 Suwayomi。
[!WARNING] 提供环境变量将在启动容器时覆盖当前设置值。
[!NOTE] 大多数情况下,您不需要使用环境变量,而是可以在运行时通过 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 代理的登录密码 |
| 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] 此 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
ghcr.io/suwayomi/suwayomi-server:latest
服务器的最新稳定版。也标记为 :stable。
ghcr.io/suwayomi/suwayomi-server:preview
服务器的最新预览版。可能存在 bug!
https://github.com/Suwayomi/Suwayomi-Server 采用 MPL v. 2.0 许可。
本源代码形式受 Mozilla Public License, v. 2.0 条款约束。如果未随本文件一同分发 MPL 副本,您可以在 [***] 获取。
来自真实用户的反馈,见证轩辕镜像的优质服务