部署指南

本指南将帮助您快速在服务器上部署 TGBot-Ultra 系统。

环境准备

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

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

部署步骤

1. 获取源码

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

下载源码

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

权限设置

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

chmod -R 777 /www/wwwroot/tgbot-ultra

2. 配置环境变量

本系统包含两个核心服务：Admin（后台管理）和 Job（任务处理），它们各自有独立的配置文件。

A. Admin 服务配置

# 进入 admin 目录
cd admin
# 复制配置文件
cp .env.example .env
# 编辑配置
vim .env

B. Job 服务配置

# 进入 job 目录
cd ../job
# 复制配置文件
cp .env.example .env
# 编辑配置
vim .env

关键配置一致性

请确保 admin/.env 和 job/.env 中的数据库连接信息 (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) 和 Redis 配置保持一致。

3. 启动服务

回到项目根目录（包含 docker-compose.yml 的目录），执行以下命令启动：

docker compose up -d --build

4. 验证部署

查看容器运行状态：

docker compose ps

如果所有容器状态均为 Up，则说明启动成功。

• 管理后台: http://服务器IP:8080/admin/login
  • 默认账号: trxadmin 或 admin
  • 默认密码: 请查看数据库或初始安装说明（通常为 password 或 123456，建议首次登录后修改）

数据库初始化

首次启动时，系统会自动执行 DB_PostgreSQL.sql 脚本初始化数据库结构。如果启动后无法登录，请检查数据库是否已成功导入数据。

激活授权

重要提示

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

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，方便切换服务器或进行转卖。