Docker 镜像
适合大多数场景。一条命令启动，升级、迁移与回滚都更简单。
下载
选择适合你的安装方式
三种安装方式功能一致，个人版与商业授权使用同一套安装包。
Linux 安装包
适合不使用容器的服务器，安装为 systemd 服务，开机自启。
离线安装包
面向无法访问公网的内网环境，包含镜像与依赖，拷贝进内网即可安装。
* 安装包尚未正式发布，下载地址与校验值（SHA256）将随正式版本一同公布。版本号为示例。
快速安装
几分钟跑起来
准备一台满足系统要求的服务器，选择任一方式安装。
- 安装并启动使用示例命令启动服务，默认监听
8080端口。 - 打开
http://localhost:8080首次访问时创建管理员账号，完成初始化。远程服务器请替换为服务器 IP 或域名。 - 接入模型并创建 API Key在你自己的 TokenHub 管理后台添加云端模型 Key 或本地模型地址，然后按快速开始发起第一次调用。
# 镜像地址将在正式发布时公布
docker pull <镜像地址待发布>:2.3.0
# 启动，数据持久化到 ./tokenhub-data
docker run -d --name tokenhub \
-p 8080:8080 \
-v $(pwd)/tokenhub-data:/data \
--restart unless-stopped \
<镜像地址待发布>:2.3.0
# 打开 http://localhost:8080 完成初始化# docker-compose.yml
services:
tokenhub:
image: <镜像地址待发布>:2.3.0
container_name: tokenhub
ports:
- "8080:8080"
volumes:
- ./tokenhub-data:/data
restart: unless-stopped
# 在同一目录下启动
docker compose up -d
# 打开 http://localhost:8080 完成初始化# 安装包下载地址将在正式发布时公布
tar -xzf tokenhub-2.3.0-linux-<amd64|arm64>.tar.gz
cd tokenhub
# 安装为 systemd 服务，默认端口 8080
sudo ./install.sh
sudo systemctl status tokenhub
# 打开 http://localhost:8080 完成初始化* 命令为示意：<镜像地址待发布> 等占位内容将在正式发布时替换，参数以正式安装文档为准。
系统要求
TokenHub 本身很轻量
以下为建议配置（示例），实际资源取决于并发量、知识库规模与日志保留时长。
| 项目 | 最低配置 | 推荐配置（生产环境） |
|---|---|---|
| 操作系统 | 64 位 Linux（x86_64 / ARM64） | Ubuntu 22.04 / Debian 12 / Rocky Linux 9 等主流发行版 |
| CPU / 内存 | 2 核 / 4 GB | 4 核 / 8 GB 及以上 |
| 磁盘 | 20 GB 可用空间 | 100 GB SSD 及以上（随文档量与日志增长） |
| Docker | Docker 20.10+（容器方式） | Docker 24+ 与 Docker Compose v2 |
| 浏览器 | 最新版 Chrome、Edge、Firefox 或 Safari（访问管理后台） | |
TokenHub 本身不需要 GPU。
只有当你要在本地运行模型推理服务（如 Ollama、vLLM）时，才需要为这些推理服务器准备 GPU；只调用云端模型时，普通服务器即可。参见本地模型接入指南。
* 配置为建议值（示例），正式要求以发布说明为准。
授权说明
个人免费，商业使用需授权
TokenHub 是闭源免费软件。个人版与商业授权使用同一安装包，区别只在于使用用途。
个人版
免费适用于个人学习、研究与非商业用途
- 免费下载、安装与使用
- 在个人设备或个人服务器上部署
- 用于学习、测试、研究与个人非商业项目
- 与商业授权使用同一安装包
商业授权
联系获取适用于企业、机构及其他商业用途
- 企业 / 机构内部部署，供员工或业务系统使用
- 用于对外提供的产品或服务
- 授权范围按使用场景、规模与部署方式沟通确定
- 可一并沟通集群、离线内网等部署需求
具体权利与限制以《软件许可协议》（待发布）为准。
什么算商业用途？
仅供参考通常需要商业授权
- 公司、政府部门或其他机构内部部署，供员工使用
- 为企业的业务系统、客服或产品提供模型调用能力
- 将 TokenHub 集成到商业产品或解决方案中交付给客户
- 基于 TokenHub 为客户提供有偿的部署、运维等服务
通常属于个人免费使用
- 个人在自己的电脑或服务器上学习、测试与研究
- 学生、研究人员的非商业学习与研究项目
- 不产生收入的个人业余项目
以上示例仅供参考，是否属于商业用途以《软件许可协议》为准。不确定时，欢迎联系我们确认。
TokenHub 是开源软件吗？
不是。TokenHub 是闭源免费软件：你可以免费下载和使用，但我们不公开源代码，也不允许对软件进行反向工程或再分发。具体条款以《软件许可协议》（待发布）为准。
个人使用收费吗？
不收费。个人学习、研究以及不产生收入的个人项目，都可以免费下载和使用 TokenHub。
什么情况需要商业授权？
在企业、机构内部使用，或将 TokenHub 用于商业产品与服务时，需要获取商业授权。可参考上方「什么算商业用途」，最终以许可协议为准。
调用模型的费用怎么算？
TokenHub 采用自带密钥（BYOK）方式：你在 TokenHub 中配置自己的云端模型厂商 API Key，调用费用由你直接向厂商支付，TokenHub 不经手、不加价。使用 Ollama、vLLM 等本地模型不产生调用费用，只消耗你自己的算力。
我的数据会上传到 TokenHub 吗？
不会。TokenHub 部署在你自己的服务器上，调用内容、知识库文档、日志与厂商密钥都保存在你的环境中。只有你主动配置的云端模型请求，才会发送给对应的模型厂商。
如何升级到新版本？
升级前建议先备份数据目录，并阅读更新日志。Docker 部署时拉取新版本镜像并重新创建容器即可，数据保存在挂载目录中不受影响；Linux 安装包可运行新版本的安装脚本完成升级。具体步骤以正式安装文档为准。
离线 / 内网环境如何安装？
下载离线安装包后，拷贝到内网服务器，导入镜像并运行安装脚本即可，安装过程无需访问公网。在内网中可搭配 Ollama、vLLM 等本地模型与本地 Embedding 模型使用，数据全程不出内网。
如何获取商业授权？
填写商业授权咨询表单，或发送邮件至 hello@tokenhub.example。我们会了解你的使用场景、规模与部署方式，并与你沟通授权方案。