如果你使用 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%A8http://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会无限期存储日志,你可以全局配置日志或使用日志驱动编辑compose文件。
使用本仓库中的模板docker-compose.yml创建并启动Tachidesk Docker容器。
使用本仓库中的模板suwayomi-server.container以无root权限的Podman容器形式创建并启动Suwayomi。
[!IMPORTANT] 提供环境变量会在启动容器时覆盖当前设置值。
[!NOTE] 大多数情况下无需使用环境变量,可在运行时通过WebUI更改设置(若提供环境变量,这些设置将失效)。
[!NOTE] 密码可通过文件提供,方法是在变量名后追加
_FILE。例如,设置SOCKS_PROXY_PASSWORD_FILE=/path/to/myfile,Suwayomi将使用"myfile"的内容作为SOCKS代理密码。
[!NOTE] 有关默认值,请参见https://github.com/Suwayomi/Suwayomi-Server%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84https://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 Duration格式 |
| JWT_REFRESH_EXPIRY | 60d | JWT刷新令牌过期时间,采用ISO-8601 Duration格式 |
| 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
ghcr.io/suwayomi/suwayomi-server:latest
服务器的最新稳定版。也标记为:stable。
ghcr.io/suwayomi/suwayomi-server:preview
服务器的最新预览版。可能存在bug!
https://github.com/Suwayomi/Suwayomi-Server%E9%87%87%E7%94%A8%60MPL v. 2.0`许可协议。
本源代码形式受Mozilla Public License, v. 2.0条款约束。如果未随本文件一同分发MPL副本,你可以在[***]
来自真实用户的反馈,见证轩辕镜像的优质服务