AiKey Server Edition

服务端快速开始

本文档面向服务端管理员（部署控制面、接入 Provider、批量签发 Key）及开发者用户（安装 CLI、使用虚拟 Key）。

前置条件

  • 操作系统：Linux (amd64 / arm64)。已验证：Rocky Linux 9, CentOS Stream 9, Ubuntu 22.04
  • 权限：root 或 sudo 权限
  • Docker + Compose plugin：必须是 docker compose (plugin 形态)
  • GitHub 认证：需先执行 gh auth login 获取私有仓库访问权限

服务端管理员：安装流程

固定版本号安装 (v1.0.0-rc.3)：

# 1. GitHub 认证
gh auth login
export GITHUB_TOKEN=$(gh auth token)

# 2. 下载并安装特定版本
gh release download v1.0.0-rc.3 -R aikeylabs/launch-master -p 'server-install.sh' -D /tmp
sh /tmp/server-install.sh --version v1.0.0-rc.3 --yes

登录 Control Panel

访问地址：http://SERVER_IP:3000

默认邮箱

admin@aikey.local

默认密码

Admin123456!

首次登录后请立即修改默认密码。

管理动作：

Provider Accounts

添加上游 Provider 凭证（Claude/Codex 等）。

Seats

按开发者邮箱批量邀请席位。

Virtual Keys

为席位批量签发虚拟 Key (aikey_vk_*)。

开发者用户：安装与登录

1. 在开发机一键安装 CLI：

curl -fsSL https://github.com/aikeylabs/launch/releases/latest/download/local-install.sh | sh
source ~/.zshrc  # 或 source ~/.bashrc

2. 启动本地 Vault 控制台：

aikey web

3. 登录到企业服务端：

aikey login --email your-email@example.com --control-url http://SERVER_IP:3000

使用虚拟 Key

登录成功后，在 aikey web 浏览器页面的 Vault 中可看到管理员签发的虚拟 Key。

关键步骤：

  • 点击 Vault 页面顶部的 "install hook" 横幅确认安装。
  • 打开 新的 Terminal 以使 hook 生效。
  • 直接运行 claude 进入交互界面。

验证与维护

服务端健康检查：

curl http://SERVER_IP:3000/health

高级用法

OAuth 登录

使用 aikey auth login <provider> 添加个人 OAuth 账号。

配置查看

使用 aikey list 查看 Key，或 aikey route 查看路由配置。

临时激活

使用 aikey activate <key-name> 在当前终端临时切换 Key，aikey deactivate 恢复。