双向Bot 部署教程

本文档指导你如何在自己的服务器上快速部署并运行 **双向Bot** 项目。

## 环境要求

• 一台可访问外网的服务器（建议使用 Linux 系统，如 Ubuntu 20.04+）
• 理论上windows也可以，请自行编译即可
• 已安装以下软件：
  • git
  • Go 语言环境（如果你需要自己编译）
• 一个可用的 **Telegram Bot Token**

## 步骤一：准备服务器环境

1. 更新系统：

sudo apt update && sudo apt upgrade -y

2. 安装 git：

sudo apt install git -y

3. （可选）如果需要自己编译源码，安装 Go 语言：

sudo apt install golang-go -y

检查 Go 是否安装成功：

go version

---

## 步骤二：克隆项目代码

git clone https://github.com/sswc01/telegram-talkbot-web.git
cd telegram-talkbot-web

---

## 步骤三：配置项目

编辑配置文件 config.json：

vi config.json

将其中的 token 字段替换为你自己的 Telegram Bot Token，例如：

{
  "bot_token": "bot tokan",
  "start_message": "你好！请发送您的问题，客服会尽快回复您。",
  "http_user": "admin",
  "http_password": "123456"
}

保存并退出（编辑器中按 esc，然后 :wq 退出并保存）。

---

## 步骤四：启动项目

### 方法一：使用已有可执行文件（推荐）

项目中自带了已编译好的 tgbot 可执行文件，直接运行：

chmod +x tgbot
./tgbot

如果提示找不到命令，确认当前目录是否正确（pwd查看）。

### 方法二：自己编译源码（可选）

如果你修改过 main.go，或者希望自定义构建，可以手动编译：

go build -o tgbot main.go
./tgbot

不管什么方法，请确保数据库文件以及上传目录存在，可使用命令生成

touch messages.db
mkdir uploads

---

## 步骤五：后台运行（可选）

为了让 Bot 在关闭终端后继续运行，推荐使用 screen 或 nohup。

### 使用 screen

1. 安装 screen：

sudo apt install screen -y

2. 创建一个新的 screen 会话：

screen -S bot

3. 启动 Bot：

./tgbot

4. 要退出 screen 会话而不关闭程序，按下：

`` Ctrl+A，然后按 D ``

5. 恢复 screen 会话：

screen -r bot

---

## 步骤六：设置开机自启（进阶）

如果你希望服务器重启后自动启动 Bot，可以配置 systemd 服务。

创建一个 systemd 文件：

sudo nano /etc/systemd/system/tgbot.service

内容如下：

[Unit]
Description=tgtalkBot Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/telegram-talkbot-web/
ExecStart=/root/telegram-talkbot-web/tgbot
Restart=always

[Install]
WantedBy=multi-user.target

保存退出。

然后执行：

sudo systemctl daemon-reload
sudo systemctl enable tgbot
sudo systemctl start tgbot

检查状态：

sudo systemctl status tgbot

---

## 常见问题

• **Bot无法启动？**
  • 确认 config.json 配置正确
  • 确认 Token 有效
  • 查看日志输出，有无报错信息

• **静态网页访问失败？**
  • 确认 static/index.html 文件存在
  • 确认 Bot 内部是否绑定了正确的监听端口（取决于你代码设定）

---

结束

至此，你已经成功部署并运行了自己的 Telegram 双向Bot！🎉

欢迎继续优化，比如接入反向代理、HTTPS、日志系统等。