
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像提供了一系列预构建的Nginx动态模块,旨在简化Nginx功能扩展过程。当前支持的Nginx程序版本为1.21.0,包含多种实用模块,可满足动态管理上游服务器、自定义HTTP头、实现缓存、增强安全防护等需求。
| 模块名称 | 作者 | 模块描述 | 模块版本 | Docker拉取命令 |
|---|---|---|---|---|
| https://github.com/cubicdaiya/ngx_dynamic_upstream | @cubicdaiya | 用于通过HTTP API(如ngx_http_upstream_conf)动态操作上游服务器的模块 | 0.1.6 | docker pull soulteary/prebuilt-nginx-modules:dynamic-upstream-1.21.0 |
| https://github.com/openresty/echo-nginx-module | @openresty | 为Nginx配置文件带来"echo"、"sleep"、"time"、"exec"等类shell功能 | 0.62 | docker pull soulteary/prebuilt-nginx-modules:echo-1.21.0 |
| https://github.com/openresty/encrypted-session-nginx-module | @openresty | 用于加密和解密Nginx变量值的模块 | 0.08 | docker pull soulteary/prebuilt-nginx-modules:encrypted-session-1.21.0 |
| https://github.com/openresty/headers-more-nginx-module | @openresty | 用于设置和清除输入输出HTTP头的模块,功能比"add_header"更丰富 | 0.33 | docker pull soulteary/prebuilt-nginx-modules:headers-more-1.21.0 |
| ngx_http_redis | @Sergey A. Osokin | 可用于执行简单缓存的模块 | 0.3.9 | docker pull soulteary/prebuilt-nginx-modules:http-redis-1.21.0 |
| https://github.com/openresty/memc-nginx-module | openresty | 标准memcached模块的扩展版本,支持set、add、delete等更多memcached命令 | 0.19 | docker pull soulteary/prebuilt-nginx-modules:memc-1.21.0 |
| https://github.com/openresty/set-misc-nginx-module | openresty | 为Nginx的rewrite模块添加多种set_xxx指令(如md5/sha1、SQL/JSON转义等) | 0.32 | docker pull soulteary/prebuilt-nginx-modules:set-misc-1.21.0 |
| https://github.com/openresty/redis2-nginx-module | openresty | 支持Redis 2.0协议的Nginx上游模块 | 0.15 | docker pull soulteary/prebuilt-nginx-modules:redis2-1.21.0 |
| https://github.com/openresty/srcache-nginx-module | openresty | 基于子请求的透明缓存布局,适用于任意Nginx location | 0.32 | docker pull soulteary/prebuilt-nginx-modules:srcache-1.21.0 |
| https://github.com/ADD-SP/ngx_waf | ADD-SP | 实用、高性能的Nginx防火墙模块 | 3.1.6 | docker pull soulteary/prebuilt-nginx-modules:waf-1.21.0 |
soulteary/prebuilt-nginx-modules:headers-more-1.21.0-alpine后缀,如 soulteary/prebuilt-nginx-modules:headers-more-1.21.0-alpine除1.21.0外,还支持以下Nginx版本:1.20.0、1.19.10、1.19.9、1.19.8、1.19.7(模块拉取命令格式相同,只需替换版本号)。
适用于需要扩展Nginx功能的各类场景,包括但不限于:
根据所需模块和基础系统,使用以下命令拉取镜像:
bash# Debian基础镜像示例(headers-more模块) docker pull soulteary/prebuilt-nginx-modules:headers-more-1.21.0 # Alpine基础镜像示例(echo模块) docker pull soulteary/prebuilt-nginx-modules:echo-1.21.0-alpine
拉取镜像后,需在Nginx配置中通过load_module指令加载模块,例如:
nginx# 加载headers-more模块 load_module /path/to/modules/ngx_http_headers_more_filter_module.so; http { # 模块配置示例 more_set_headers "X-Content-Type-Options: nosniff"; }
(注:具体模块路径需根据镜像内模块存放位置调整)
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

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