Codex可图形化配置Kong网关限流与鉴权:先安装启动Codex并连接本地Kong实例;再为Route添加rate-limiting插件(支持ip/consumer维度限流)和key-auth插件(启用header校验与凭据隐藏);最后创建Consumer并绑定API Key,实现双重防护。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Mac上用Codex(Kong官方桌面客户端)配置微服务网关的API限流与鉴权插件,避免手动敲curl命令、跳转Konga或直接操作REST API,能大幅降低误配风险和学习门槛。
安装并启动Codex
访问 Kong官网Codex下载页 → 下载 macOS 版 dmg 文件 → 双击挂载 → 将 Codex 拖入 Applications 文件夹 → 首次运行时允许“系统偏好设置”中“安全性与隐私”→“通用”里点击“仍要打开”。
启动后若提示“无法验证开发者”,需右键→“显示简介”→勾选“仍要打开”;【未执行此步会导致App闪退无法登录】。
连接本地Kong实例
打开Codex → 点击左下角“+ Add Kong Instance” → 填写名称(如 local-kong)→ Host 输入 http://localhost:8001 → 点击 Connect。
如果连接失败,请先确认Kong容器已运行:docker ps | grep kong;若无输出,执行 docker-compose up -d 启动Kong服务(需提前准备好含kong.yml的docker-compose.yml)。
为Route添加rate-limiting限流插件
在左侧导航栏展开你的Kong实例 → 点击“Routes” → 选择目标路由(如 user-api-route)→ 点击右侧“Plugins”标签页 → 点击“Add Plugin”按钮 → 在插件列表中搜索“rate limiting” → 点击“Rate Limiting”卡片 → 点击“Configure”。
填写配置项:
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
- Consumer:留空(全局限流)或选择具体Consumer(按用户限流)
-
Limit by:选
ip(按IP限流)或consumer(按用户限流) -
Second limit:填数字,例如
10(每秒最多10次) -
Minute limit:填数字,例如
60(每分钟最多60次) -
Hour limit:可选,填
3600(每小时最多3600次)
点击 Save → 插件立即生效,无需重启Kong。
为同一Route叠加Key Auth鉴权插件
仍在该Route的Plugins页 → 再次点击“Add Plugin” → 搜索“key auth” → 选择“Key Authentication” → Configure。
关键参数设置:
-
Key names:填
apikey(默认值,客户端请求头需带apikey: xxx) -
Key in header:启用(✔)→ 请求必须携带
apikey头 - Hide credentials:启用(✔)→ 上游服务收不到apikey字段,更安全
- Anonymous:留空 → 认证失败直接返回401,不降级
保存后,该Route同时具备限流+密钥校验双重防护。测试时若漏传apikey头,会收到 401 Unauthorized;若传了但超频,会收到 429 Too Many Requests。
创建Consumer并绑定API Key
回到Codex主界面 → 左侧导航切换到“Consumers” → 点击“+ Create Consumer” → 填写 username(如 mobile-app)→ 点击 Create。
在刚创建的Consumer详情页 → 切换到“Credentials”标签 → 点击“+ Add Credential” → 选择“Key Auth” → 自动生成key(或手动填入自定义key,仅含字母数字-_)→ Save。
此时,mobile-app Consumer拥有了唯一apikey,后续请求必须携带该key,且受前述rate-limiting规则约束。

















