
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
!Docker Image Size (latest) !Docker Pulls
使用 Docker Compose 或 Docker Swarm 进行部署。容器可从 Docker Hub 和 GitHub Container Registry 获取。
提供使用 Caddy 或 NGINX 作为 Web 服务器的示例,以及使用 Caddy、NGINX 或 Traefik 处理 HTTPS 的示例(Traefik 示例还包含反向代理配置)。NGINX 相关示例位于 nginx 文件夹中。
推荐使用 Caddy 作为 Web 服务器,可直接处理 HTTPS 或与 Traefik 配合使用,两者均原生支持 ACME,能能自动从 Let's Encrypt 获取 HTTPS 证书,或为本地使用生成自签名证书。
如果条件允许,建议使用 Docker Swarm 而非 Docker Compose,因其支持 Docker Secrets 和 Docker Configs。
若 Caddy 不适用或追求性能,可参考 NGINX 示例。虽未进行性能测试,但 NGINX 具有高度可配置性,在用户量较大时可能通过优化获得更好性能(详见下文性能调优部分)。
配置通过在 .yml 文件中设置环境变量实现。更多用于配置 BookStack 和 PHP 的环境变量可在 docker-entrypoint.sh 中找到,Caddy 相关配置可在 bookstack_caddyfile 中查看。
设置 DOMAIN 变量会影响 Caddy 使用的协议:HTTP、带自签名证书的 HTTPS,或带 Let's Encrypt/ZeroSSL 证书的 HTTPS。详见 Caddy 文档。
容器启动后,可使用用户名 admin@admin.com 和密码 password 登录。
推荐配合 Traefik) 作为反向代理使用,示例文件 traefik.yml 已包含(非必需)。
需创建相应的 Docker Secrets 和 Docker Configs。
部署命令:
bashdocker stack deploy --compose-file docker-swarm.yml bookstack
启动命令:
bashdocker-compose up -d
通过 127.0.0.1:9080 访问。
设置 POST_MAX_SIZE、UPLOAD_MAX_FILESIZE 和 MEMORY_LIMIT 变量以配置最大文件上传大小(MEMORY_LIMIT 至少应为 128M)。详见 BookStack 文档。
Web 服务器默认设置相关 HTTP 头,使浏览器尽可能长时间缓存文件,同时要求浏览器检查文件是否更新,以在避免缓存旧内容的前提下利用缓存优势。若内容不常变化或可通过其他方式失效,可修改此行为以减少请求次数。
默认 PHP 配置根据需求扩展子进程,适合低资源和轻量使用场景。将其设置为动态或静态模式可提升性能。可在 docker-entrypoint.sh 的 "PHP Configuration" 部分查看并设置相关调优参数。
本项目是 https://github.com/solidnerd/docker-bookstack 的分支,而后者又是 https://github.com/Kilhog/docker-bookstack 的分支。
以下是 zeigren/bookstack 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务