如果你使用 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 Gateway Fabric 是一个开源项目,它使用 NGINX 作为数据平面实现了 Gateway API。该项目的目标是实现核心 Gateway API(Gateway、GatewayClass、HTTPRoute、GRPCRoute、TCPRoute、TLSRoute 和 UDPRoute),以便为 Kubernetes 上运行的应用配置 HTTP 或 TCP/UDP 负载均衡器、反向代理或 API 网关。
有关支持的 Gateway API 资源和功能列表,请参见 Gateway API 兼容性 文档。
了解我们的 设计原则 和 架构。
NGINX Gateway Fabric 使用 https://github.com/nginx/agent 配置 NGINX。
您可以在 NGINX 文档 网站上找到全面的 NGINX Gateway Fabric 用户文档。
我们在 GitHub 上发布 NGINX Gateway Fabric 版本。请参见我们的 https://github.com/nginx/nginx-gateway-fabric/releases%E3%80%82
最新版本是 https://github.com/nginx/nginx-gateway-fabric/releases/tag/v2.6.3%E3%80%82
edge 版本适用于试验尚未发布的新功能。要使用 edge 版本,请选择基于 main 分支 https://github.com/nginx/nginx-gateway-fabric/commits/main 构建的 edge 版本。
下表总结了有关镜像、清单、文档和示例的选项,并提供指向正确版本的链接:
| 版本 | 描述 | 安装清单 | 文档和示例 |
|---|---|---|---|
| Edge | 用于实验性使用和最新功能 | https://github.com/nginx/nginx-gateway-fabric/tree/main/deploy | https://github.com/nginx/nginx-gateway-fabric/tree/main/examples |
NGF 对其版本采用语义化版本控制。有关更多信息,请参见 [***]
主版本号为零
(0.Y.Z)保留用于开发阶段,任何内容都可能随时更改。公共 API 不稳定。
下一个版本将包含的功能反映在相应的 https://github.com/nginx/nginx-gateway-fabric/milestones 中。有关问题创建和分配到版本的信息,请参阅 Issue 生命周期 文档。
下表列出了 NGINX Gateway Fabric 支持的软件版本。仅显示每个次要版本的最新补丁版本。
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus | NGINX Agent | F5 WAF for NGINX |
|---|---|---|---|---|---|---|
| Edge | 1.5.1 | 1.31+ | 1.31.1 | R37.0 | v3.10.4 | 5.13.1 |
| 2.6.3 | 1.5.1 | 1.31+ | 1.31.1 | R37.0 | v3.10.3 | 5.13.1 |
| 2.5.1 | 1.5.1 | 1.31+ | 1.29.7 | R36 | v3.8.0 | --- |
| 2.4.2 | 1.4.1 | 1.25+ | 1.29.5 | R36 | v3.7.1 | --- |
| 2.3.0 | 1.4.1 | 1.25+ | 1.29.3 | R36 | v3.6.0 | --- |
| 2.2.2 | 1.3.0 | 1.25+ | 1.29.2 | R35 | v3.6.0 | --- |
| 2.1.4 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.3.1 | --- |
| 2.0.2 | 1.3.0 | 1.25+ | 1.28.0 | R34 | v3.0.1 | --- |
| 1.6.2 | 1.2.1 | 1.25+ | 1.27.4 | R33 | --- | --- |
| 1.5.1 | 1.2.0 | 1.25+ | 1.27.2 | R33 | --- | --- |
| 1.4.0 | 1.1.0 | 1.25+ | 1.27.1 | R32 | --- | --- |
| 1.3.0 | 1.1.0 | 1.25+ | 1.27.0 | R32 | --- | --- |
| 1.2.0 | 1.0.0 | 1.23+ | 1.25.4 | R31 | --- | --- |
下表列出了与 NGINX Gateway Fabric 兼容的 OpenShift 版本和 Operator 版本。
| NGINX Gateway Fabric | Operator | 推荐的 Gateway API | 兼容的 Gateway API | 支持推荐 GWAPI 的 OCP 版本 | 支持的 OCP 版本 |
|---|---|---|---|---|---|
| 2.6.x | v1.4.x | v1.5.x | v1.2.1-v1.5.x | --- | 4.19 - 4.21 |
| 2.5.x | v1.3.x | v1.5.x | v1.2.1-v1.5.x | --- | 4.19 - 4.21 |
| 2.4.x | v1.2.x | v1.4.x | v1.2.1-v1.4.x | 4.20 & 4.21 | 4.19 - 4.21 |
| 2.2.x | v1.0.x | v1.3.0 | v1.2.1 | --- | 4.19 |
我们为二进制文件和 Docker 镜像生成 SBOM。
二进制文件的 SBOM 可在版本页面获取。SBOM 使用 https://github.com/anchore/syft 生成,格式为 SPDX。
Docker 镜像的 SBOM 可在 https://github.com/nginx/nginx-gateway-fabric/pkgs/container/nginx-gateway-fabric 仓库中获取。SBOM 使用 https://github.com/anchore/syft 生成,并作为证明存储在镜像清单中。
例如,要获取 linux/amd64 的 SBOM 并使用 https://github.com/anchore/grype 进行分析,可运行以下命令:
docker buildx imagetools inspect ghcr.io/nginx/nginx-gateway-fabric:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}' | grype
有关故障排除帮助,请参见 故障排除 文档。
我们希望听到您的反馈!如果您在使用网关控制器时遇到问题,请在 GitHub 上 https://github.com/nginx/nginx-gateway-fabric/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=。如果您有任何建议或增强请求,请在 GitHub Discussions 上 https://github.com/nginx/nginx-gateway-fabric/discussions/categories/ideas。您也可以在 NGINX 社区论坛 直接联系我们。
每周二,交替时区,分别为太平洋时间上午 9:30/格林威治时间下午 5:30 或格林威治时间中午 12:00。
有关会议链接、更新、议程和会议记录,请查看以下链接:
https://github.com/nginx/nginx-gateway-fabric/discussions/1472
如果您有 NGINX Gateway Fabric 尚未满足的用例、bug、问题、成功案例,或者只是想更多地参与项目,欢迎加入!
如果您想为项目做出贡献,请阅读我们的 贡献指南。
如果您的团队需要在环境中获得 NGINX Gateway Fabric 的专属支持,或者希望利用我们的 高级 NGINX Plus 功能,可以通过 此处 联系我们。
要试用带有 NGINX Plus 的 NGINX Gateway Fabric,您可以开始免费的 30 天试用,然后按照 安装指南 安装带有 NGINX Plus 的版本。
来自真实用户的反馈,见证轩辕镜像的优质服务