
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像基于 https://hub.docker.com/r/linuxserver/bookstack 修改,针对中文PDF导出功能进行优化。原版BookStack默认使用Dompdf导出PDF时存在中文乱码问题,本镜像通过集成 wkhtmltopdf 及中文字体,并配置相应环境变量,实现中文文档的正常导出。
docker-compose.yml 配置
yamlversion: "2" services: bookstack: image: successage/bookstack container_name: bookstack environment: - PUID=1000 # 用户ID,用于文件权限控制 - PGID=1000 # 组ID,用于文件权限控制 - DB_HOST=bookstack_db # 数据库主机名 - DB_USER=bookstack # 数据库用户名 - DB_PASS=bookstack123 # 数据库密码 - DB_DATABASE=bookstackapp # 数据库名称 - APP_LANG=zh_CN # 应用语言设置为中文 - WKHTMLTOPDF=/usr/bin/wkhtmltopdf # 指定wkhtmltopdf路径 volumes: - /home/cherokee/project/docker-bookstack/config:/config # 配置文件持久化路径 ports: - 6875:80 # 端口映射(主机端口:容器端口) restart: unless-stopped # 重启策略 depends_on: - bookstack_db # 依赖数据库服务 bookstack_db: image: linuxserver/mariadb # MariaDB数据库镜像 container_name: bookstack_db environment: - PUID=1000 # 用户ID - PGID=1000 # 组ID - MYSQL_ROOT_PASSWORD=root # 数据库root密码 - TZ=Asia/Shanghai # 时区设置 - MYSQL_DATABASE=bookstackapp # 数据库名称 - MYSQL_USER=bookstack # 数据库用户名 - MYSQL_PASSWORD=bookstack123 # 数据库密码 volumes: - /home/cherokee/project/docker-bookstack/config:/config # 数据库数据持久化路径 restart: unless-stopped # 重启策略
在docker-compose.yml文件所在目录执行以下命令启动服务:
bashdocker-compose up -d --build
该命令会同时启动BookStack应用和MariaDB数据库服务。
如需停止服务,执行以下命令:
bashdocker-compose down
ports配置中的主机端口部分以下是 successage/bookstack 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





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