
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像提供了一种轻量级解决方案,可自动为Duck DNS域名生成Let's Encrypt SSL证书,无需暴露端口即可通过DNS挑战完成验证过程。适用于需要为动态IP环境下的Duck DNS域名配置SSL证书的场景。
latest| 环境变量 | 说明 | 必要性 | 默认值 |
|---|---|---|---|
DUCKDNS_TOKEN | Duck DNS账户令牌(从Duck DNS获取) | 必需 | - |
DUCKDNS_DOMAIN | 完整的Duck DNS域名(例如:test.duckdns.org) | 必需 | - |
LETSENCRYPT_DOMAIN | 生成SSL证书的目标域名,默认使用DUCKDNS_DOMAIN | 可选 | DUCKDNS_DOMAIN的值 |
LETSENCRYPT_WILDCARD | 是否生成通配符证书(true表示*.domain,false表示主域名) | 可选 | false |
LETSENCRYPT_EMAIL | 用于证书续期通知的*** | 可选 | - |
TESTING | 是否生成测试环境证书(避免生产环境请求限制) | 可选 | false |
UID | 生成证书文件的用户ID | 可选 | 0(root) |
GID | 生成证书文件的组ID | 可选 | 0(root) |
DUCKDNS_DOMAIN需已指向服务器的动态IP,可配合aazarios/duckdns镜像自动更新IP。
DUCKDNS_DOMAIN格式固定为<子域名>.duckdns.org,与LETSENCRYPT_WILDCARD设置无关。
使用LETSENCRYPT_DOMAIN功能时,需创建以下DNS记录(记录不应启用代理):
| 类型 | 名称 | 值 | 条件 |
|---|---|---|---|
| CNAME | *.<LETSENCRYPT_DOMAIN> | <DUCKDNS_DOMAIN> | LETSENCRYPT_WILDCARD = true |
| CNAME | <LETSENCRYPT_DOMAIN> | <DUCKDNS_DOMAIN> | LETSENCRYPT_WILDCARD = false |
| CNAME | _acme-challenge.<LETSENCRYPT_DOMAIN> | _acme-challenge.<DUCKDNS_DOMAIN> | 始终需要 |
<certs>:/etc/letsencrypt: 用于持久化存储SSL证书的命名卷或主机卷。其他容器需访问证书时,应将此卷挂载为只读模式;本容器需以读写模式挂载。bashdocker run \ -e DUCKDNS_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX \ -e DUCKDNS_DOMAIN=test.duckdns.org \ -e LETSENCRYPT_WILDCARD=false \ -e LETSENCRYPT_EMAIL=your@email.com \ -e TESTING=false \ -e UID=1000 \ -e GID=1000 \ -v ${PWD}/certs:/etc/letsencrypt \ -it aazario/duckdns-letsencrypt
DUCKDNS_TOKEN: 替换为您的Duck DNS账户令牌DUCKDNS_DOMAIN: 替换为您的Duck DNS域名LETSENCRYPT_EMAIL: 可选,设置后将接收证书续期通知UID/GID: 建议设置为非root用户ID,增强安全性${PWD}/certs为本地证书存储路径,可根据实际需求调整您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

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