TokenHub

环境要求

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

安装与启动步骤

1. 1选择安装方式

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

2. 2获取仓库代码

   Docker Compose 方式需要在仓库代码目录内执行 deploy 下的脚本，先克隆项目并进入目录。

   git clone https://github.com/astaxie/TokenHub.git
   cd TokenHub

   复制

3. 3准备环境变量文件

   从示例文件复制出 deploy/.env，后续所有部署参数都写在这个文件里。

   cp deploy/.env.example deploy/.env

   复制

4. 4替换默认密钥

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

5. 5执行 Docker 部署

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

   ./deploy/install.sh

   复制

6. 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. 7登录管理控制台

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

关键配置

如何确认成功

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

常见问题

注意事项

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