
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
此镜像已不再由USSBA维护,且即将被移除。
本项目提供一种简单的方式,用于向Let's Encrypt注册和续期通配符证书,并通过S3备份/恢复Let's Encrypt数据。
适用于需要自动管理Let's Encrypt通配符证书生命周期,并希望将证书数据安全备份到S3的场景,例如企业内部服务或公开网站的HTTPS证书管理。
脚本支持以下环境变量配置:
| 参数 | 默认值 | 描述 | 示例 |
|---|---|---|---|
| CERT_BUCKET_NAME | - | 用于备份证书的S3桶名称 | my-certificate-bucket |
| CERT_BUCKET_PATH | - | 桶内的路径,必须以/开头和结尾 | /certificates/dev/ |
| CERT_HOSTNAME | - | 要注册的主机名,不包含通配符 | my.subdomain.example.org |
| DRY_RUN | false | 是否使用certbot执行 dry-run(验证流程但不生成证书) | true 或 false |
| CERT_REGISTRATION_EMAIL | - | 创建Let's Encrypt证书所用的***地址 | admin@example.org |
| CERT_REGISTER_WILDCARD | true | 是否请求通配符证书(true将生成主域名和通配符域名的证书) | true 或 false |
| SNS_TOPIC_ARN | - | 用于发送续期通知的SNS主题ARN(未提供则不发送通知) | arn:aws:sns:us-east-2:123456789012:MyTopic |
| CERT_ADDITIONAL_HOSTNAMES | - | 逗号分隔的备选域名列表,将添加到证书中 | foo.my.subdomain.example.com,*.bar.my.subdomain.example.com |
用Docker Compose构建
bashdocker-compose build
用Docker Compose运行
修改docker-compose.yml配置所需的环境变量后执行对应运行命令(具体需根据配置调整)。
我们欢迎贡献。请阅读CONTRIBUTING了解贡献方式。
我们致力于为所有SBA项目营造一个欢迎且包容的环境。请在所有互动中遵循以下准则:
请勿在GitHub上提交安全漏洞相关的issue。请通过SBA网站支持联系开发团队,并确保包含所有相关信息。
该机构保留随时更改本政策的权利。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。


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