NGINX Gateway Fabric 是一个开源项目,它使用 NGINX 作为数据平面实现了 Gateway API。该项目的目标是实现核心 Gateway API——Gateway、GatewayClass、HTTPRoute、GRPCRoute、TCPRoute、TLSRoute 和 UDPRoute——以配置 HTTP 或 TCP/UDP 负载均衡器、反向代理或 API 网关,用于运行在 Kubernetes 上的应用。
有关支持的 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.5.1%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 对其版本采用语义化版本控制。有关更多信息,请参见 [***]
[!IMPORTANT] 主版本号为零(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 |
|---|---|---|---|---|---|
| Edge | 1.5.1 | 1.31+ | 1.30.0 | R36 | v3.9.0 |
| 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 | --- |
我们为二进制文件和 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 的版本。
请登录使用轩辕镜像享受快速拉取体验,支持国内访问优化,速度提升
docker pull ghcr.io/nginx/nginx-gateway-fabric/nginx:2.2.1-ubi探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务