系统要求
安装 API7 网关前，请确保环境满足以下要求。
硬件要求
硬件要求取决于预期流量和启用的插件数量。
控制面（CP）
控制面负责管理配置并提供控制台。
| 指标 | 最低要求（开发/测试） | 建议配置（生产） |
|---|---|---|
| CPU | 2 核 | 4 核 |
| 内存 | 4 GB | 8 GB |
| 磁盘 | 20 GB | 100 GB（建议使用 SSD） |
可以将上述生产配置作为起点。对于更大规模的部署，控制面容量主要取决于其管理的网关实例数量、配置变更量，以及是否启用内置 Prometheus 等可观测性特性。如果预计配置频繁变更或连接大量数据面，请预留更多 CPU 和内存，并在发布前使用实际工作负载验证部署。
数据面（DP）
数据面负责处理 API 流量。流量增加时，应水平扩展数据面。
| 指标 | 最低要求（开发/测试） | 建议配置（生产） |
|---|---|---|
| CPU | 1 核 | 4 核以上 |
| 内存 | 2 GB | 8 GB 以上 |
| 磁盘 | 10 GB | 40 GB（建议使用 SSD） |
插件数量和类型 会直接影响数据面容量。轻量代理工作负载可以接近上述基线，而身份认证、限流、正文转换、AI、日志及其他策略密集型路由，需要每个实例提供更多 CPU 和内存。请使用计划实际运行的插件、路由和消费者数量，对代表性流量进行性能基准测试，再根据观察到的 CPU、内存和延迟状况，对每个网关节点进行纵向和横向扩展。参考方法和插件影响示例请参阅性能基准。
操作系统要求
API7 网关支持以下 64 位 Linux 发行版：
| 发行版 | 支持的版本 |
|---|---|
| Ubuntu | 22.04 LTS（推荐）、20.04 LTS |
| CentOS | 7.x（已更新内核） |
| RHEL | 7.x、8.x、9.x |
| Debian | 10、11 |
容器运行时要求
如果通过 Docker 或 Kubernetes 部署：
| 组件 | 所需版本 |
|---|---|
| Docker | 20.10.x 或更 高版本 |
| Kubernetes | 1.25 或更高版本 |
| Helm | 3.10.x 或更高版本 |
网络要求
确保以下端口已开放，以供组件通信和外部访问。
控制面端口
| 端口 | 协议 | 方向 | 说明 |
|---|---|---|---|
| 4321 | HTTPS | 入站 | 开发者门户（HTTPS） |
| 7443 | HTTPS | 入站 | 控制台和 Admin API（HTTPS） |
| 7900 | HTTP | 入站 | DP Manager（HTTP） |
| 7943 | HTTPS | 入站 | DP Manager（HTTPS/mTLS） |
| 5432 | TCP | 出站 | PostgreSQL 连接 |
数据面端口
| 端口 | 协议 | 方向 | 说明 |
|---|---|---|---|
| 9080 | HTTP | 入站 | 网关流量（HTTP） |
| 9443 | HTTPS | 入站 | 网关流量（HTTPS） |
| 9091 | HTTP | 入站 | 指标/Prometheus |
数据库要求
API7 网关默认使用 PostgreSQL 存储配置，同时也支持 MySQL 和 Microsoft SQL Server。完整列表请参阅支持的版本和互操作性。
| 要求 | 最低版本 |
|---|---|
| PostgreSQL | 12.0 或更高版本（Helm Chart 提供 15.x） |
| MySQL | 5.7 或 8.x |
| Microsoft SQL Server | 2019 或 2022 |
API7 网关不需要任何 PostgreSQL 扩展。使用专用数据库和用户的默认 PostgreSQL 安装即可。
浏览器要求
API7 控制台支持以下浏览器的最新两个版本：
- Google Chrome
- Mozilla Firefox
- Microsoft Edge
- Apple Safari