
如果你使用 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镜像基于官方PostgreSQL镜像构建,专为**BPP(员工出版物目录)**系统设计。BPP是波兰高校图书馆使用的学术出版物目录开源系统,镜像集成了BPP所需的扩展和优化配置。
pl_PL.UTF-8 locale和pl-PL ICU排序规则,确保波兰语字符正确排序。/proc/meminfo及环境变量动态配置PostgreSQL的内存和并行度。pg_isready实现数据库健康状态检测。apt-get upgrade,及时应用Debian系统补丁。无latest标签,避免意外拉取不兼容版本。支持的标签格式:
psql-<MAJOR>.<MINOR>:固定到具体补丁版本(推荐生产环境),如psql-16.13。psql-<MAJOR>:同一主版本内滚动更新(适合开发/CI环境),如psql-16。
当前支持PostgreSQL 16、17、18版本。bashdocker run --rm -d \ --name bpp-db \ -e POSTGRES_PASSWORD=secret \ -p 5432:5432 \ docker.xuanyuan.run/iplweb/bpp_dbserver:psql-16.13
yamlservices: db: image: docker.xuanyuan.run/iplweb/bpp_dbserver:psql-16.13 environment: POSTGRES_PASSWORD: ${DB_PASSWORD:?required} POSTGRES_HOST_AUTH_METHOD: scram-sha-256 # 生产环境不要使用默认的'trust' POSTGRESQL_RAM_THIS_MUCH_GB: 8192 # 可选,覆盖自动检测的内存大小 volumes: - pgdata:/var/lib/postgresql/data ports: - "5432:5432" volumes: pgdata:
| 变量名 | 默认值 | 说明 |
|---|---|---|
| POSTGRES_PASSWORD | — | 超级用户密码,生产环境必填。 |
| POSTGRES_HOST_AUTH_METHOD | trust | 仅开发环境使用,生产环境需设为scram-sha-256。 |
| POSTGRESQL_RAM_PERCENT | 0.95 | PostgreSQL可使用的内存比例。 |
| POSTGRESQL_RAM_THIS_MUCH_GB | 自动检测 | 覆盖内存大小(单位:MB)。 |
| POSTGRESQL_MAX_LOCKS_PER_TRANSACTION | 64 | PostgreSQL默认值,可根据pytest-xdist/Celery需求调整。 |
| POSTGRESQL_UNSAFE_BUT_FAST | — | 仅开发环境使用,关闭fsync/WAL等安全机制,生产环境禁止。 |
完整配置参数请参考:https://github.com/iplweb/bpp-dbserver#parametry-konfiguracyjne
不要在同一数据卷上直接替换主版本标签。PGDATA中的PG_VERSION记录了主版本,新版本二进制文件会拒绝启动或损坏数据。需使用pg_upgrade或pg_dump+pg_restore进行升级。
BPP是MIT协议开源的学术出版物目录系统,用于波兰高校图书馆管理员工出版物。
https://github.com/iplweb/bpp-dbserver/blob/main/LICENSE — Copyright © 2017–2026 Michał Pasternak <***>。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务