TokenHub

统一管理企业 AI 调用，让每一次请求可控可追溯。

TokenHub 是一个面向企业的私有 AI 网关，旨在统一管理企业对各类 AI 模型的访问，并强化治理能力。它解决了企业在使用多个 AI 服务（如 OpenAI、Anthropic 等）时面临的分散管理、难以追踪和缺乏控制的问题。核心能力包括：集中路由请求到不同模型、提供细粒度的访问控制、记录完整的调用日志以实现可追溯性，以及支持按用户或项目进行成本归属。通过该网关，企业可以确保每一次 AI 调用都处于可控、可审计的状态，从而满足合规要求。项目采用 Go 语言开发，性能高效，部署简单，适合作为企业内部 AI 基础设施的入口。

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1328

维护状态活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队astaxie

所属国家

官网地址https://thinkinai-labs.github.io/tokenhome

GitHubhttps://github.com/astaxie/TokenHub

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自由部署使用，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型ai,ai-gateway,enterprise,gateway

GitHub 星标★ 1328

30天Star增速

HF 下载量

上线时间2026-06-10 00:00:00

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

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

环境要求

Linux 主机并使用 systemd（原生安装方式的前提）
具备 sudo/root 权限，可执行安装脚本
Docker 与 Docker Compose 环境，并已获取仓库代码（Docker Compose 方式）
服务器可访问 GitHub（raw.githubusercontent.com 与 Release 包下载）

安装与启动步骤

1选择安装方式

README 提供两种方式：Linux systemd 主机上的原生安装，或仓库代码中的 Docker Compose 部署。二选一即可。
2获取仓库代码

Docker Compose 方式需要在仓库代码目录内执行 deploy 下的脚本，先克隆项目并进入目录。
```
git clone https://github.com/astaxie/TokenHub.git
cd TokenHub
```
3准备环境变量文件

从示例文件复制出 deploy/.env，后续所有部署参数都写在这个文件里。
```
cp deploy/.env.example deploy/.env
```
4替换默认密钥

打开 deploy/.env，把所有 change-me 占位值改成强随机密钥，尤其是初始管理员密码，不修改会有安全风险。
5执行 Docker 部署

在仓库根目录运行部署脚本，脚本会启动后端与控制台（同一托管容器），无需挂载 Docker socket。
```
./deploy/install.sh
```

6原生安装(可选)

若不使用 Docker，可下载原生安装脚本并执行 install，脚本会校验 Release 校验和并注册 systemd 服务。

curl -fsSL https://raw.githubusercontent.com/astaxie/TokenHub/main/deploy/native/install.sh 
  -o /tmp/tokenhub-install.sh
sudo bash /tmp/tokenhub-install.sh install

7登录管理控制台

浏览器打开 http://localhost:3000 进入管理控制台，用户名 admin；密码见下一步说明。

关键配置

配置项	必填	说明	示例
`TOKENHUB_BOOTSTRAP_ADMIN_PASSWORD`	是	Docker 部署时初始 admin 账号的登录密码	`ChangeMe_Str0ng_P@ssw0rd`
`deploy/.env 中的 change-me 值`	是	示例文件中的占位密钥，部署前必须全部替换为强密钥	`change-me-please-replace`

如何确认成功

访问 http://localhost:8080/healthz 返回健康状态，同时 http://localhost:3000 能打开管理控制台并登录成功。

常见问题

Q：初始管理员账号密码是什么？

A：用户名固定为 admin。原生安装的密码由安装脚本打印一次，请注意保存；Docker 部署的密码是 deploy/.env 中 TOKENHUB_BOOTSTRAP_ADMIN_PASSWORD 的值。

Q：三个默认端口分别是什么？

A：管理控制台 http://localhost:3000，后端 API http://localhost:8080，健康检查 http://localhost:8080/healthz。

Q：如何更新或回滚版本？

A：原生安装与默认 Docker 部署都支持在版本面板直接执行更新、回滚和重启；原生安装会校验 Release 校验和并注册 systemd 服务。

Q：多实例 Docker 部署怎么升级？

A：多实例场景保持由运维管理 Compose 更新，这样所有副本会一起切换到同一版本。

注意事项

deploy/.env 中所有 change-me 值必须替换为强密钥后再部署。
默认 Docker 部署把后端与控制台放在同一个托管容器中，且不需要挂载 Docker socket。
Release 包存放在 tokenhub-releases 卷中，普通容器重启或重建不会丢失面板应用的更新。
两种部署模式的更多细节见官方部署文档 docs/deployment.md。

核心亮点

集中管理多个 AI 模型，统一路由和切换，降低集成成本
提供细粒度访问控制和全量日志，满足企业合规审计需求
Go 语言实现，性能好，部署轻量，易于集成到现有基础设施

不足之处

早期项目，功能迭代快，API 可能不稳定
文档/社区待观察

适用场景

企业内部多个团队统一接入 AI 服务，实现权限管控
需要审计和追踪 AI 调用记录，满足合规要求
在多个模型供应商之间灵活切换，避免供应商锁定

替代项目

LiteLLM、OpenRouter、Kong AI Gateway

项目介绍

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

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

近 42 天，它的 GitHub 星标从 989 增加到 1,328，净增 339。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自由部署使用，无付费版本。

它主要面向的使用场景是：企业内部多个团队统一接入AI服务，实现权限管控。同类可对比的替代方案包括 LiteLLM、OpenRouter、Kong AI Gateway。

上一篇：AIHelms

下一篇：CliRelay