部署指南

快速部署你自己的 KiroGate 实例

📋

环境要求

🐍
Python 3.10+
📦
pip 或 poetry
🌐
网络连接
⚙️

环境变量配置

# 必填项
PROXY_API_KEY="your-secret-api-key"      # 代理服务器密码

# 可选项（仅简单模式需要）
# 如果使用组合模式（PROXY_API_KEY:REFRESH_TOKEN），可以不配置此项
REFRESH_TOKEN="your-kiro-refresh-token"  # Kiro Refresh Token

# 其他可选配置
KIRO_REGION="us-east-1"                  # AWS 区域
PROFILE_ARN="arn:aws:..."                # Profile ARN
LOG_LEVEL="INFO"                          # 日志级别

# 或使用凭证文件
KIRO_CREDS_FILE="~/.kiro/credentials.json"

💡 配置说明

  • • 简单模式：必须配置 REFRESH_TOKEN 环境变量
  • • 组合模式（推荐）：无需配置 REFRESH_TOKEN，用户在请求中直接传递
  • • 多租户部署：使用组合模式可以让多个用户共享同一网关实例
🐍

本地运行

# 克隆仓库
git clone https://github.com/dext7r/KiroGate.git
cd KiroGate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填写配置

# 启动服务
python main.py
🐳

Docker 部署

Docker Compose（推荐）

# 复制配置文件
cp .env.example .env
# 编辑 .env 填写你的凭证

# 启动服务（自动创建持久卷）
docker-compose up -d

# 查看日志
docker logs -f kirogate

手动 Docker 运行

docker build -t kirogate .
docker run -d -p 8000:8000 \
  -v kirogate_data:/app/data \
  -e PROXY_API_KEY="your-key" \
  -e ADMIN_PASSWORD="your-admin-pwd" \
  --name kirogate kirogate
🚀

Fly.io 部署

# 1. 安装 Fly CLI 并登录
curl -L https://fly.io/install.sh | sh
fly auth login

# 2. 创建应用
fly apps create kirogate

# 3. 创建持久卷（重要！保证数据不丢失）
fly volumes create kirogate_data --region nrt --size 1

# 4. 设置环境变量
fly secrets set PROXY_API_KEY="your-password"
fly secrets set ADMIN_PASSWORD="your-admin-password"
fly secrets set ADMIN_SECRET_KEY="your-random-secret"

# 5. 部署
fly deploy
💾

数据持久化

⚠️ 重要提醒

用户数据（数据库）需要持久化存储，否则每次部署会丢失所有用户、Token 和 API Key！

🐳 Docker Compose

已配置命名卷 kirogate_data:/app/data，使用 docker-compose down 保留数据

🚀 Fly.io

需手动创建卷：fly volumes create kirogate_data --region nrt --size 1

🔐

获取 Refresh Token

🌐 方式一：浏览器获取（推荐）

  1. 1打开 https://app.kiro.dev/account/usage 并登录
  2. 2按 F12 打开开发者工具
  3. 3点击 应用/Application → 存储/Storage → Cookie
  4. 4选择 https://app.kiro.dev
  5. 5复制 RefreshToken 的值

🛠️ 方式二：Kiro Account Manager

使用 Kiro Account Manager 可以轻松管理多个账号的 Refresh Token。