
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Kopano Core镜像是用于运行Kopano Core仓库中组件的Docker镜像,可启动如kopano-server和kopano-gateway等容器,提供邮件服务器相关服务。默认邮件附件目录为/kopano/data/attachments/,推荐将/kopano/data挂载为数据卷以持久化存储。
KCCONF_SERVER_ATTACHMENT_PATH环境变量自定义KCCOMMENT_前缀环境变量注释/取消注释特定配置项fs.suid_dumpable sysctl值设为2(而非0)scheduler容器或kopano-cli命令完成适用于部署企业级邮件协作系统,提供邮件(IMAP)、日历(CalDAV)等服务,适合需要可靠邮件服务器解决方案的组织或个人。
基本配置格式
通过环境变量调整配置文件中的选项,格式为:
KCCONF_<配置文件名>_<配置项>=<值>
KCCONF:固定前缀<配置文件名>:相关配置文件名称(不含.cfg后缀)<配置项>:配置文件中的具体选项名示例:
server.cfg中的mysql_host:KCCONF_SERVER_MYSQL_HOST=127.0.0.1ldap.cfg中的ldap_search_base:KCCONF_LDAP_LDAP_SEARCH_BASE=dc=example,dc=com配置项注释控制
通过KCCOMMENT_前缀环境变量注释/取消注释配置项,格式为:
KCCOMMENT_<配置文件名>_<任意字符串>=<搜索行>
示例:
ldap.cfg中的!include /usr/share/kopano/ldap.openldap.cfg:KCCOMMENT_LDAP_1=!include /usr/share/kopano/ldap.openldap.cfg推荐挂载/kopano/data目录作为数据卷,以持久化存储附件等数据:
bash-v /host/path/to/data:/kopano/data
首次部署后,建议同步用户列表以创建***:
bash# 通过docker-compose执行(需配合scheduler容器) docker-compose exec kopano_server kopano-cli --list-users
注意:根据系统性能和用户数量,首次执行可能需要一段时间,此命令会触发用户***创建。
http(s)://FQDN/caldav代理至该服务更多信息请参见Kopano Core管理员手册
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






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