部署指南

本指南将帮助您快速在服务器上部署 TGPro Admin 系统。

环境准备

在开始之前，请确保服务器满足以下要求：

1. 操作系统：Linux (推荐 Ubuntu 20.04+ / Debian 10+)
2. 基础软件：已安装宝塔面板（可选，推荐新手使用）或熟悉命令行操作。
3. 容器环境：已安装 Docker 和 Docker Compose。

部署步骤

1. 获取源码

请前往 GitHub Releases 页面下载最新版本的源码包：

下载源码

下载后将文件上传至服务器目录（例如 /www/wwwroot/tgpro-admin），并解压。

权限设置

请务必将解压后的文件目录权限设置为 777，以确保容器能正常读写数据。

chmod -R 777 /www/wwwroot/tgpro-admin

2. 获取关键配置信息

在配置环境变量前，您需要先获取以下关键信息：

A. 波场 (Tron) API

1. 访问 TronGrid 官网 注册并登录。
2. 下载并安装 TronLink 浏览器插件。
3. 在 TronGrid 首页关联您的钱包地址。
4. 申请并升级 API Key（建议申请 50w 访问量的 Key）。

B. Fragment 认证信息 (用于高级功能)

如果您需要使用 Fragment 相关功能（如用户名拍卖、匿名号码等），需要获取 Hash 和 Cookie。

1. 访问 Fragment 官网。
2. 登录您的 Telegram 和 TON 钱包。
3. 在首页点击右上角的“会员界面”或任意交互入口。
4. 按 F12 打开浏览器开发者工具，切换到 Network (网络) 标签页。
5. 在页面上进行任意操作（如输入用户名 @aaaa 并回车搜索）。
6. 在 Network 面板中找到任意以 api 开头的请求。
7. 点击该请求，在 Headers 或 Payload 中找到并复制 hash 和 cookie 值。

3. 配置环境变量

将项目根目录下的 .env.example 文件重命名为 .env，并编辑填入上述信息。

mv .env.example .env
vim .env

重点修改项：

• BOT_TOKEN: 您的机器人 Token。
• TRON_API_KEY: 您的波龙 API Key。
• FRAGMENT_HASH: 刚才获取的 Hash。
• FRAGMENT_COOKIE: 刚才获取的 Cookie。

4. 启动服务

在项目根目录下执行以下命令启动：

docker compose up -d --build

启动成功

当看到所有容器状态为 Up 时，说明部署成功。您可以通过浏览器访问服务器 IP + 端口进入管理后台。

激活授权

重要提示

系统部署完成后，默认处于未激活状态，无法直接使用。请按照以下步骤完成授权。

1. 注册与购买

前往 HFZ.PW 官网 注册账户并登录，在商城中找到对应的产品进行购买。

2. 配置授权 IP

购买成功后，进入 个人资料 页面，在 授权 IP 栏位填写您的服务器 IP 地址。

• 格式: http://IP1,http://IP2,
• 示例: http://113.123.123.123,http://111.222.234.234,
• 注意: 多个 IP 请使用英文逗号 , 分隔。

3. 填写激活码

在系统的激活/授权页面，填写您的 商品订单号 作为激活码。

授权说明

• 标准版限制: 每个授权码最多支持绑定 4 个 服务器 IP。
• 灵活管理: 您可以随时在官网后台自行修改授权 IP，方便切换服务器或进行转卖。