部署指南
本指南将帮助您快速在服务器上部署 TGBot-Ultra 系统。
环境准备
在开始之前，请确保服务器满足以下要求：
- 操作系统：Linux (推荐 Ubuntu 20.04+ / Debian 10+)
- 基础软件：已安装宝塔面板（可选，推荐新手使用）或熟悉命令行操作。
- 容器环境：已安装 Docker 和 Docker Compose。
部署步骤
1. 获取源码
请前往 GitHub Releases 页面下载最新版本的源码包：
下载源码下载后将文件上传至服务器目录（例如 /www/wwwroot/tgbot-ultra），并解压。
权限设置
请务必将解压后的文件目录权限设置为 777，以确保容器能正常读写数据。
bash
chmod -R 777 /www/wwwroot/tgbot-ultra2. 配置环境变量
系统包含两个核心服务：Admin（后台管理）和 Job（任务处理），它们共享相同的数据库和缓存层，但各自拥有独立的运行环境。
配置文件说明
项目根目录提供 .env.example 作为配置模板，服务启动时会自动加载环境变量。
推荐做法
首次配置时，建议从 .env.example 复制并重命名为 .env：
bash
# 在项目根目录执行
cp .env.example .env关键配置项说明
| 配置项 | 说明 | 示例值 |
|---|---|---|
APP_NAME | 应用名称 | TGBot Ultra |
APP_URL | 站点访问地址（需与实际域名一致） | https://your-domain.com |
DB_HOST | 数据库主机（Docker 内部网络） | postgres |
DB_DATABASE | 数据库名称 | tgbot |
DB_USERNAME | 数据库用户名 | root |
DB_PASSWORD | 数据库密码 | your_password |
REDIS_HOST | Redis 主机（Docker 内部网络） | redis |
TIMEZONE | 系统时区 | Asia/Shanghai |
ADMIN_PORT | 后台管理端口（宿主机映射） | 8080 |
JOB_PORT | Job 服务端口（宿主机映射） | 9501 |
3. 启动服务
完成配置后，在项目根目录（包含 docker-compose.yml 的目录）执行以下命令启动所有服务：
bash
# 构建并启动所有容器
docker compose up -d --build
# 查看容器运行状态
docker compose ps4. 访问系统
容器启动成功后，您可以通过以下地址访问系统：
管理后台
http://服务器IP:8080/admin/loginBot 接口
http://服务器IP:9501默认账号
首次访问管理后台时，请使用以下凭据登录（建议首次登录后立即修改密码）：
- 账号:
trxadmin或admin - 密码:
password（或123456，具体以系统提示为准）
安全提醒
- 首次部署后请立即修改默认密码
- 建议通过 Cloudflare Tunnel 或 Nginx 反向代理访问，避免直接暴露端口
- 记得在服务器防火墙/安全组中放行必要端口（8080, 9501, 5432, 6379）