kiro-gateway

环境要求

• Docker（使用 Docker 部署方式时）或本机 Python 环境（使用原生 Python 方式）
• 已登录 Kiro IDE / kiro-cli，能获取刷新令牌或凭据文件
• 一个自定义的代理访问密码（PROXY_API_KEY）
• 可选：docker-compose（使用 compose 方式启动）

安装与启动步骤

1. 1准备 Kiro 凭据

   先在 Kiro IDE 或 kiro-cli 完成登录，取得 REFRESH_TOKEN，或拿到凭据文件路径（如 ~/.aws/sso/cache/kiro-auth-token.json）。

2. 2安装 Python 依赖

   原生 Python 部署方式下，进入项目目录安装 requirements.txt 中的依赖。

   pip install -r requirements.txt

   复制

3. 3生成配置文件

   把示例配置复制为 .env，之后在里面填入代理密码与令牌等参数。

   cp .env.example .env

   复制

4. 4填写 .env 参数

   在 .env 中设置 PROXY_API_KEY，并按需填 REFRESH_TOKEN 或 KIRO_CREDS_FILE。

5. 5Docker Compose 启动

   先编辑 docker-compose.yml，按操作系统取消对应 volumes 挂载注释，再后台启动。

   docker-compose up -d

   复制

6. 6Docker 环境变量运行

   不想用 compose 时，直接用环境变量传入密码与刷新令牌启动容器，映射 8000 端口。

   docker run -d -p 8000:8000 -e PROXY_API_KEY="my-super-secret-password-123" -e REFRESH_TOKEN="your_refresh_token" --name kiro-gateway ghcr.io/jwadow/kiro-gateway:latest

   复制

7. 7挂载凭据文件运行

   Linux/macOS 下把 Kiro 凭据目录只读挂载进容器，并用 KIRO_CREDS_FILE 指向令牌文件。

   docker run -d -p 8000:8000 -v ~/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json -e PROXY_API_KEY="my-super-secret-password-123" --name kiro-gateway ghcr.io/jwadow/kiro-gateway:latest

   复制

8. 8Windows 下挂载运行

   Windows 用 PowerShell 的 ${HOME} 变量挂载凭据目录，反引号表示换行，需一行行复制执行。

   docker run -d `
     -p 8000:8000 `
     -v ${HOME}/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro `
     -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json `
     -e PROXY_API_KEY="my-super-secret-password-123" `
     --name kiro-gateway `
     ghcr.io/jwadow/kiro-gateway:latest

   复制

关键配置

如何确认成功

执行 docker ps 看到 kiro-gateway 容器处于运行状态，且 8000 端口已映射，即表示服务已启动。

常见问题

注意事项

• 模型可用性由你的 Kiro 订阅等级决定，网关只能转发你账号实际可用的模型
• 挂载凭据目录时加 :ro 只读，避免容器改写本机 Kiro 凭据
• 示例密码 my-super-secret-password-123 仅为占位，正式使用请改成自己的强密码
• Docker Compose 方式需先编辑 docker-compose.yml，按操作系统取消对应 volumes 注释（Linux/macOS 与 Windows 路径不同）