CliRelay

自建 AI 网关，统一管理编码 CLI 的模型调用与花费。

CliRelay 是一个自托管的 AI 网关，专为编码命令行工具（CLI）设计。它提供一个统一的 OpenAI/Claude/Gemini/Codex 兼容端点，让开发者可以通过一个接口访问多家大模型服务。项目解决了多模型切换、密钥管理和成本控制的问题，核心能力包括多租户 Web 控制台、请求日志和消费配额管理。它用 Go 编写，部署简单，适合团队内部统一管理 AI 编码工具的接入。

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1023

维护状态活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队kittors

所属国家

官网地址

GitHubhttps://github.com/kittors/CliRelay

定价模式free

价格说明开源项目，MIT许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型ai-gateway,anthropic,api-gateway,claude-code,gemini-cli,go,llm,llm-proxy,multi-tenant,openai,openai-codex,self-hosted

GitHub 星标★ 1023

30天Star增速

HF 下载量

上线时间2026-02-27 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：Docker 5 步

环境要求

Go 1.26 运行时（使用官方镜像时无需本地安装）
Docker 与 Docker Compose（推荐安装方式，Compose 栈含 PostgreSQL 15、Redis 7、updater sidecar）
PostgreSQL 15+ 与 Redis 7+（运行时依赖，Compose 已内置）
可选：S3 兼容对象存储 / Git 仓库（用于非本地配置与鉴权持久化）

安装与启动步骤

1克隆仓库

从 GitHub 拉取 CliRelay 源码到本地任意目录。
```
git clone https://github.com/kittors/CliRelay.git
```
2进入项目目录

后续所有命令都在该目录内执行。
```
cd CliRelay
```
3按需预置 .env

.env 可选：首次启动时 clirelay-init 会自动生成缺失密钥并保留已有非空值。生产环境想固定自己的密钥或绑定路径时再手动创建。
4启动 Compose 栈

首次执行会拉起 clirelay-init、PostgreSQL、Redis、应用容器和 updater sidecar，并自动从 config.example.yaml 生成 config.yaml。
```
docker compose up -d
```
5检查启动状态

确认各容器处于运行状态且应用通过健康检查，再进入管理面板使用。
```
docker compose ps
```

关键配置

配置项	必填	说明	示例
`CLIRELAY_ADMIN_PASSWORD`	是	为空数据库引导首个 admin 用户；须≥12位且含大小写字母和非字母数字字符	`Str0ng!Passw0rd`
`CLIRELAY_UPDATER_TOKEN`	否	updater sidecar 的令牌，首次启动若缺失由 init 服务自动生成	`auto-generated-token`
`CLIRELAY_POSTGRES_PASSWORD`	否	PostgreSQL 密码，首次启动若缺失由 init 服务自动生成	`auto-generated-password`
`request-log-storage.store-content`	否	是否保存完整请求/响应体，默认关闭	`true`
`request-log-storage.content-retention-da`	否	完整请求体保留天数，0 表示永久保留，默认30天	`30`

如何确认成功

执行 docker compose ps 确认 clirelay-init、PostgreSQL、Redis、应用与 updater 容器均已运行，且应用容器通过健康检查，即可打开 /manage 管理面板。

常见问题

Q：不手动创建 .env 能启动吗？

A：可以。首次 docker compose up -d 时 clirelay-init 会自动生成 .env 中缺失的密钥，并在 config.yaml 缺失时从 config.example.yaml 复制生成。

Q：预置的 CLIRELAY_ADMIN_PASSWORD 为什么被改掉了？

A：密码必须至少12位且同时包含大写字母、小写字母和非字母数字字符。不合规的值会在下次启动时被替换，否则引导会失败导致容器无法启动。

Q：请求和响应正文默认会保存吗？

A：

注意事项

首次启动会自动生成密钥与 config.yaml，请勿把生成的 .env 提交到版本库。
PostgreSQL 是唯一业务数据源，Redis 只承载缓存、锁、限流、队列等可重建状态。
关闭正文存储会清除历史输入输出正文，但保留请求详情与请求记录。
大流量部署建议调整 config.yaml 中 request-log-storage 相关参数，完整正文默认保留30天且上限约1GB。

核心亮点

统一端点兼容主流模型 API，切换模型无需改代码
多租户控制台，方便团队内部分权管理
请求日志和消费配额，成本控制一目了然

不足之处

早期项目，文档和社区生态尚待完善
功能聚焦 CLI 场景，通用网关场景覆盖有限

适用场景

团队统一管理 AI 编程助手（如 Copilot、Codex）的 API 调用
需要精细控制不同成员或项目的 AI 使用额度
希望自建网关，避免依赖单一云厂商或集中式代理

替代项目

LiteLLM、OpenRouter、one-api

项目介绍

CliRelay 是基础设施领域的开源项目，由 kittors 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,023）位列前 30%，在基础设施分类中处于中上游。

近 42 天，它的 GitHub 星标从 907 增加到 1,023，净增 116。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，可自行部署，完全免费。

它主要面向的使用场景是：团队统一管理AI编程助手（如Copilot、Codex）的API调用。同类可对比的替代方案包括 LiteLLM、OpenRouter、one-api。

上一篇：TokenHub

下一篇：codegate