KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

Telegram_ChatBot

★ 20 Open GitHub ↗

基于 Cloudflare Pages + Pages Functions + KV / D1 + Vue 3 的 Telegram 双向消息机器人与 Web 管理后台。项目目标是提供一套可直接部署、可视化管理、支持人机验证、支持话题群组转发、支持多语言与 2FA 登录的 Telegram Bot 管理系统。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">🤖 Telegram ChatBot</h1>

Telegram 双向消息机器人 · Web 管理后台 · 多存储后端 · 多种验证方式

<a href="./README_EN.md">English</a>

---

用户私聊 Bot → 自动创建话题 → 管理员回复 → 实时转发回用户。

支持 **Cloudflare Pages** 和 **Docker** 两种部署，存储层支持 **KV / D1 / Hyperdrive（PostgreSQL & MySQL）** 自由切换。

---

---

## ✨ 功能特性

- 双向消息转发（用户 ↔ 管理员话题）
- 独立话题管理（每个用户一个话题）
- 编辑消息同步
- 消息去重（防止重复转发）
- 支持所有消息类型（文字/图片/视频/音频/文件/贴纸/位置/投票等）
- 管理员回复自动转发回用户

</details>

<details>
<summary>🔐 验证系统（8 种验证方式）</summary>

| 类型 | 需要密钥 | 需要站点 URL | 说明 |
|------|:--------:|:----------:|------|
| 数学题 | ❌ | ❌ | 随机加减乘除，按钮选择 |
| 图片数字 | ❌ | ✅ | 4 位数字图片验证码 |
| 图片字母数字 | ❌ | ✅ | 5 位字母数字图片验证码 |
| Cloudflare Turnstile | ✅ | ✅ | Cloudflare 无感验证 |
| Google reCAPTCHA v2 | ✅ | ✅ | "我不是机器人"复选框 |
| Google reCAPTCHA v3 | ✅ | ✅ | 无感评分验证 |
| hCaptcha | ✅ | ✅ | hCaptcha 验证控件 |

所有验证方式均支持：
- 超时自动提示并清理
- 失败次数限制
- 白名单用户跳过验证

</details>

- 封禁 / 解封 / 永久封禁
- 用户申诉流程（管理员审批）
- 斜杠命令过滤（`/xxx` 不转发给管理员）
- Zalgo 异常文本过滤
- 关键词过滤（支持 text 和 regex 规则，ReDoS 防护）

</details>

- 仪表盘（用户数、消息统计、机器人信息）
- 对话记录浏览
- 用户管理（封禁/解封/白名单/删除）
- 白名单管理
- 完整设置页面（Bot/Webhook/验证/功能/过滤/欢迎/存储）
- 个人中心（修改密码/用户名/2FA）

</details>

- **KV** — 开箱即用，适合中小规模
- **D1** — SQLite，支持 SQL 查询
- **Hyperdrive** — PostgreSQL / MySQL，适合大规模生产
- 三向一键切换，自动同步数据
- SQL 导入导出（明文 / Base64 / AES-256-GCM 加密）

</details>

- 简体中文 / 繁體中文 / English
- Bot 消息语言和 WebUI 语言独立配置
- 通过设置页面切换 Bot 语言

</details>

---

## 🚀 快速开始

### 最快方式：Docker Compose

```bash
git clone https://github.com/milangree/Telegram_ChatBot.git
cd Telegram_ChatBot
docker compose up -d
```

访问 `http://localhost:3000`。首次启动会创建临时管理员 `admin`，**随机密码会打印在服务端日志**（请立即登录并完成首次注册以禁用默认账号）。

如需在首次启动时指定管理员密码（避免查看日志），可在 `docker-compose.yml` 的 environment 中添加 `ADMIN_USERNAME` 和 `ADMIN_PASSWORD` 环境变量，详情见下方"环境变量"表格。

### 配置顺序

1. 登录 WebUI → **修改密码** → 开启 **2FA**
2. 设置 **Bot Token**（[@BotFather](https://t.me/BotFather) 获取）
3. 设置 **话题群组 ID**（已开启话题的超级群组，系统提供查询辅助）
4. 设置 **管理员 Telegram ID**
5. 设置 **Webhook URL**：`https://你的域名/webhook`
6. 选择验证方式并配置
7. 测试：用户发消息 → 话题创建 → 管理员回复 → 用户收到

---

## 📦 部署指南

<details>
<summary>☁️ Cloudflare Pages 部署</summary>

### 1. 创建存储资源

**必需 — KV 命名空间：**
Cloudflare Dashboard → Workers & Pages → KV → Create a namespace

**可选 — D1 数据库：**
```bash
npx wrangler d1 create tg-chatbot-d1
```

**可选 — Hyperdrive：**
Dashboard → Hyperdrive → 创建连接（支持 `postgres://` / `mysql://`）

### 2. 创建 Pages 项目

Fork 本仓库 → Workers & Pages → Create → Pages → 连接 GitHub 仓库

| 配置项 | 值 |
|--------|-----|
| 框架预设 | `Vue` |
| 构建命令 | `npm run build` |
| 输出目录 | `dist` |

### 3. 添加绑定

Settings → Bindings → Add binding：

| 变量名 | 绑定类型 | 必需 |
|--------|----------|:----:|
| `KV` | KV namespace | ✅ |
| `D1` | D1 database | ❌ |
| `HYPERDRIVE` | Hyperdrive | ❌ |

> 使用 Hyperdrive 需额外执行 `npm install pg mysql2` 并在 Settings → Compatibility flags 添加 `nodejs_compat`。

### 4. 部署

推送代码后自动部署，得到 `https://your-project.pages.dev`。

### 5. 忘记管理员账号时如何查询 / 恢复（Cloudflare）

> 系统**只存储密码哈希**，无法还原明文密码。忘记密码时只能**重置**。

**查询用户名（Dashboard）：**

1. Cloudflare Dashboard → **Workers & Pages → KV**
2. 打开本项目绑定的命名空间
3. 搜索前缀：
   - `webuser:` → 键名即用户名（如 `webuser:ops`）
   - `webuser_id:` → 账号完整 JSON（含 `username` / `id` / `totp_enabled`）
   - `auth:bootstrap:v2` → 初始管理员状态（`defaultAdminUsername` / `state`）

**如果绑定了 D1：**

```bash
npx wrangler d1 execute <你的-D1名称> --remote --command "SELECT id, username, is_admin, totp_enabled, created_at FROM web_users;"
```

**重置密码（Cloudflare 手工步骤）：**

1. 在本地生成新密码哈希：

```bash
npm run admin -- hash-password 'NewPassw0rd!'
# 输出示例：pbkdf2:100000:<salt>:<hash>
```

2. 找到目标账号：
 - KV：编辑 `webuser_id:<id>` 与 `webuser:<username>` 两份 JSON 中的 `password_hash`
 - D1：

```bash
npx wrangler d1 execute <你的-D1名称> --remote --command "UPDATE web_users SET password_hash='pbkdf2:...' WHERE username='ops';"
```

3. 吊销旧会话（强烈建议）：
 - 在 KV 中写入/覆盖：`auth:session_epoch:<userId>` = 任意随机字符串
 - 可选：删除 `sess_user:<userId>:` 与对应 `sess:` 键

4. 若 2FA 也丢失，把 `totp_enabled` 设为 `0`，`totp_secret` 设为 `null` / 空。

</details>

<details>
<summary>🐳 Docker 部署</summary>

### 使用 Docker Compose（推荐）

```bash
git clone https://github.com/milangree/Telegram_ChatBot.git
cd Telegram_ChatBot
docker compose up -d
```

### 使用 Docker 直接运行

```bash
docker pull kakuwari/tg-chatbot:latest
docker run -d \
  -p 3000:3000 \
  -v telegram-data:/app/data \
  --name telegram-chatbot \
  kakuwari/tg-chatbot:latest
```

### 本地构建

```bash
docker build -t telegram-chatbot .
docker run -d -p 3000:3000 -v data:/app/data telegram-chatbot
```

### 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `PORT` | `3000` | 服务端口 |
| `KV_FILE` | `/app/data/kv-store.db` | KV 存储 SQLite 路径 |
| `D1_FILE` | `/app/data/d1-store.db` | D1 存储 SQLite 路径 |
| `DATABASE_URL` | — | PostgreSQL / MySQL 连接串 |
| `ACTIVE_DB` | `kv` | 存储后端：`kv` / `d1` / `hyperdrive` |
| `COOKIE_SECURE` | `false` | 通过 HTTPS 反向代理时设为 `true` |
| `KV_PERSIST` | `true` | KV 持久化（Docker 模式建议开启） |
| `ADMIN_USERNAME` | `admin` | 初始管理员用户名（Docker/VPS 部署，首次启动有效） |
| `ADMIN_PASSWORD` | — | 初始管理员密码（设置后密码不打印在日志中，支持重启时修改密码） |

> 完整环境变量列表见 `.env.example` 文件。

### 使用 PostgreSQL

编辑 `docker-compose.yml`，取消 PostgreSQL 服务注释：

```yaml
services:
  telegram-chatbot:
    environment:
      - DATABASE_URL=postgresql://telegram:password@postgres:5432/telegram_bot
      - ACTIVE_DB=hyperdrive

postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: telegram_bot
      POSTGRES_USER: telegram
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-telegram_password}
    volumes:
      - postgres-data:/var/lib/postgresql/data
```

### HTTPS 配置

Docker 默认无 HTTPS，需要反向代理：

**Cloudflare Tunnel（推荐）：**
```bash
cloudflared tunnel --url http://localhost:3000
```

**Nginx 反向代理：**
```nginx
server {
    listen 443 ssl;
    server_name bot.example.com;

ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

### 管理员账号恢复（CLI，本地 / Docker）

当**正式管理员用户名 / 密码 / 2FA 全部丢失**时，Web 找回不可用，请使用运维 CLI。

```bash
# 本地
npm run admin -- list
npm run admin -- show <username|id>
npm run admin -- bootstrap
npm run admin -- reset-password <username|id> --yes
npm run admin -- reset-password <username|id> --password 'NewPassw0rd!' --yes
npm run admin -- disable-2fa <username|id> --yes
npm run admin -- create newadmin --password 'NewPassw0rd!' --yes

# Docker
docker exec -it telegram-chatbot node scripts/admin-recovery.js list
docker exec -it telegram-chatbot node scripts/admin-recovery.js reset-password ops --yes
docker exec -it telegram-chatbot node scripts/admin-recovery.js disable-2fa ops --yes
```

说明：

- `list` 会显示用户名、ID、是否开启 2FA、是否被禁用 / 是否为初始管理员
- `reset-password` 会重置密码并吊销该账号全部会话
- 未传 `--password` 时自动生成随机密码，**仅打印一次**
- 系统无法还原明文密码，只能重置
- 已退役的初始管理员（`login=blocked`）通常不是正式登录账号；请重置正式管理员，或 `create` 新建一个

</details>

---

## ⚙️ 配置说明

| 配置项 | 说明 | 必需 |
|--------|------|:----:|
| `BOT_TOKEN` | Telegram Bot Token（@BotFather 获取） | ✅ |
| `FORUM_GROUP_ID` | 话题超级群组 ID（`-100` 开头） | ✅ |
| `ADMIN_IDS` | 管理员 Telegram ID（逗号分隔） | ✅ |
| `BOT_LOCALE` | 机器人语言：`zh-hans` / `zh-hant` / `en` | ❌ |

**获取群组 ID：** 在 WebUI 设置页面使用"查询聊天 ID"辅助工具，输入群组用户名或链接即可解析。

</details>

<details>
<summary>🔗 Webhook 配置</summary>

| 配置项 | 说明 |
|--------|------|
| `WEBHOOK_URL` | Webhook 地址，格式：`https://域名/webhook` |

设置 Webhook 后，系统会自动生成 `WEBHOOK_SECRET` 用于验证请求来源。
Cloudflare Pages 部署时，`CAPTCHA_SITE_URL` 会自动从 Webhook URL 提取 origin。

</details>

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `VERIFICATION_ENABLED` | `true` | 验证开关 |
| `CAPTCHA_TYPE` | `math` | 验证类型（见下方表格） |
| `VERIFICATION_TIMEOUT` | `300` | 超时秒数（60-3600） |
| `MAX_VERIFICATION_ATTEMPTS` | `3` | 最大尝试次数（1-10） |
| `CAPTCHA_SITE_URL` | — | 验证页面站点 URL |

**各验证类型专属配置：**

| 配置项 | 用于类型 |
|--------|----------|
| `TURNSTILE_SITE_KEY` / `TURNSTILE_SECRET_KEY` | Cloudflare Turnstile |
| `RECAPTCHA_SITE_KEY` / `RECAPTCHA_SECRET_KEY` | Google reCAPTCHA v2 |
| `RECAPTCHA_V3_SITE_KEY` / `RECAPTCHA_V3_SECRET_KEY` | Google reCAPTCHA v3 |
| `RECAPTCHA_V3_SCORE_THRESHOLD` | reCAPTCHA v3 最低分数（默认 0.5） |
| `HCAPTCHA_SITE_KEY` / `HCAPTCHA_SECRET_KEY` | hCaptcha |

</details>

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `AUTO_UNBLOCK_ENABLED` | `true` | 允许封禁用户发起申诉 |
| `WHITELIST_ENABLED` | `false` | 白名单功能（跳过验证） |
| `BOT_COMMAND_FILTER` | `true` | 过滤 `/xxx` 指令不转发给管理员 |
| `ADMIN_NOTIFY_ENABLED` | `false` | 管理员私聊消息通知 |
| `ZALGO_FILTER_ENABLED` | `true` | 过滤 Zalgo 异常文本 |
| `MESSAGE_FILTER_RULES` | `[]` | 关键词过滤规则（JSON 数组） |

</details>

<details>
<summary>⏰ 消息管理配置</summary>

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `USER_MSG_DELETE_SECONDS` | `30` | 用户消息自动撤回时间（0=不撤回） |
| `INLINE_KB_MSG_DELETE_ENABLED` | `true` | 带按钮消息自动撤回开关 |
| `INLINE_KB_MSG_DELETE_SECONDS` | `30` | 带按钮消息自动撤回时间 |
| `WELCOME_ENABLED` | `true` | 欢迎消息开关 |
| `WELCOME_MESSAGE` | — | 欢迎消息内容（支持 HTML） |

</details>

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `LOGIN_SESSION_TTL` | `86400` | WebUI 登录过期时长（秒） |

密码使用 PBKDF2（100,000 次迭代 SHA-256）哈希存储，支持 TOTP 两步验证。
忘记用户名/密码/2FA 时，请使用运维 CLI 或 Cloudflare 手工恢复（见上方部署章节），**无法从哈希还原明文密码**。

</details>

---

## 🔐 验证系统

### 验证流程

```
用户首次发消息
    ↓
Bot 发送验证消息（按钮/图片/链接，取决于类型）
    ↓
用户完成验证
    ↓
Bot 标记用户已验证 → 转发之前的消息给管理员
    ↓
后续消息直接转发，无需再次验证
```

### 超时处理

- 超时后 Bot 自动编辑验证消息为"⏳ 验证已超时"
- 清理所有验证相关数据（verify 记录、pending 消息、webverify KV）
- 用户重新发消息即可触发新一轮验证

### 白名单

白名单用户跳过验证，通过 WebUI 或 Bot 命令 `/wl <用户ID>` 添加。

---

## 📝 消息过滤（正则）

支持两种过滤规则类型：

| 类型 | 说明 | 示例 |
|------|------|------|
| `text` | 纯文本匹配（不区分大小写） | `spam`、`广告` |
| `regex` | 正则表达式匹配 | `/https?:\/\/t\.me\/\w+/i` |

### 添加规则

**WebUI：** 设置 → 消息过滤 → 选择类型 → 输入内容 → 添加

**Bot 命令：**
```
/addfilter text 关键词
/addfilter regex /https?:\/\/t\.me\/\w+/i
/delfilter 1
/filters
```

### 正则表达式教程

<details>
<summary>正则基础语法</summary>

| 语法 | 说明 | 示例 |
|------|------|------|
| `.` | 任意单个字符 | `a.c` 匹配 `abc`、`a1c` |
| `*` | 前一个字符重复 0+ 次 | `ab*c` 匹配 `ac`、`abc`、`abbc` |
| `+` | 前一个字符重复 1+ 次 | `ab+c` 匹配 `abc`、`abbc` |
| `?` | 前一个字符可选 | `ab?c` 匹配 `ac`、`abc` |
| `\d` | 数字 `[0-9]` | `\d+` 匹配一个或多个数字 |
| `\w` | 单词字符 `[a-zA-Z0-9_]` | `\w+` 匹配一个单词 |
| `\s` | 空白字符 | `\s+` 匹配一个或多个空格 |
| `[abc]` | 字符集 | `[aeiou]` 匹配任意元音 |
| `[^abc]` | 排除字符集 | `[^0-9]` 匹配非数字 |
| `(abc)` | 分组 | `(ab)+` 匹配 `ab`、`abab` |
| `a\|b` | 或 | `cat\|dog` 匹配 `cat` 或 `dog` |
| `^` | 行首 | `^Hello` 匹配行首的 `Hello` |
| `$` | 行尾 | `end$` 匹配行尾的 `end` |

</details>

<details>
<summary>常用过滤正则示例</summary>

```
# 匹配 Telegram 邀请链接
/addfilter regex /t\.me\/(joinchat\/|\+)\w+/i

# 匹配所有外链
/addfilter regex /https?:\/\/[^\s]+/i

# 匹配包含手机号的消息
/addfilter regex /\b1[3-9]\d{9}\b/

# 匹配包含"加群"或"进群"的消息
/addfilter regex /加群|进群|入群/

# 匹配纯 emoji 消息（5个以上连续 emoji）
/addfilter regex /^[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}]{5,}$/u
```

</details>

<details>
<summary>正则测试与调试</summary>

### 在线测试工具

在添加复杂正则规则前，建议先用在线工具测试：

- **[regex101.com](https://regex101.com/)** — 最流行的正则测试工具，支持语法高亮和解释
- **[regexr.com](https://regexr.com/)** — 可视化正则匹配
- **[debuggex.com](https://www.debuggex.com/)** — 正则表达式可视化（生成状态机图）

### 测试步骤

1. 打开 [regex101.com](https://regex101.com/)
2. 在 "Test String" 中粘贴要匹配的消息文本
3. 在 "Regular Expression" 中输入你的正则（不含首尾 `/` 和 flags）
4. 右侧选择 flags：`g`（全局）、`i`（不区分大小写）、`m`（多行）
5. 确认匹配结果正确后，在 Bot 中添加：`/addfilter regex /你的正则/flags`

### 注意事项

- 正则匹配目标是消息内容的**纯文本提取**（非原始 JSON），包含文字、用户名、标题等
- 避免使用嵌套量词如 `(a+)+`，会导致 ReDoS（正则拒绝服务）
- 系统会在创建时自动检测并拒绝有 ReDoS 风险的正则
- 匹配目标字符串限制为 4096 字符，防止超长消息导致性能问题
- 正则匹配失败（语法错误等）会静默返回不匹配，不会影响消息处理

</details>

<details>
<summary>ReDoS 防护</summary>

系统内置了 ReDoS（Regular Expression Denial of Service）防护：

1. **创建时检测**：添加正则规则时，自动检测嵌套量词模式（如 `(a+)+`、`(a|a)+`），拒绝有风险的正则
2. **匹配时保护**：正则匹配包裹在 try-catch 中，目标字符串限制 4096 字符
3. **错误静默**：匹配失败不会影响正常消息处理

如果你的正则被拒绝，说明它包含可能导致灾难性回溯的模式。请简化正则或使用更具体的字符类。

</details>

---

## 🗄️ 存储系统

| 后端 | 适用场景 | 特点 |
|------|----------|------|
| **KV** | 小中型 | 开箱即用，无需额外配置，键值存储 |
| **D1** | 中大型 | SQLite，支持 SQL 查询，事务 |
| **Hyperdrive** | 大型生产 | PostgreSQL / MySQL，外部数据库 |

### 切换存储

在 WebUI 设置 → 存储管理中一键切换，系统自动同步数据。

> ⚠️ 切换前建议停止 Bot 消息处理，避免同步期间数据不一致。

### SQL 导入导出

支持三种模式：
- **明文** — 直接导出 SQL 文本
- **Base64** — Base64 编码
- **AES-256-GCM** — 加密导出，需设置密码

---

## 🛡️ 安全机制

| 机制 | 说明 |
|------|------|
| 密码哈希 | PBKDF2（600,000 次迭代 SHA-256），兼容旧格式 salt:sha256 |
| 两步验证 | TOTP（RFC 6238），支持登录页恢复 |
| Webhook 验证 | Secret Token 校验请求来源 |
| SQL 注入防护 | 所有查询参数化绑定 |
| 默认管理员 | 首次启动随机密码（日志可见），真实注册后自动禁用 |
| ReDoS 防护 | 正则规则创建时检测、匹配时保护 |
| 正则错误处理 | 匹配异常静默处理，不影响消息流 |

---

## 🛠️ 本地开发

```bash
# 安装依赖（前端 + 后端）
npm install
cd server && npm install && cd ..

# 构建前端
npm run build

# 启动完整服务（静态前端 + API + Webhook）
npm run preview
# 等价于：node server/index.js
# 访问 http://localhost:3000

# 停止本地服务
npm run stop
# 或在启动终端按 Ctrl+C

# 仅预览静态构建产物（不含 API，不适合联调）
npm run preview:static
```

**停止服务的几种方式：**

| 方式 | 命令 / 操作 | 说明 |
|------|-------------|------|
| 推荐 | `npm run stop` | 按 PID 文件 / 端口自动结束本地服务 |
| 前台 | 启动终端按 `Ctrl+C` | 优雅关闭并释放端口 |
| 别名 | `npm run server:stop` | 与 `npm run stop` 相同 |

> `npm run preview` 会启动 `server/index.js`，同时提供前端页面与 `/api`、`/webhook`。  
> 若只运行 `vite preview`（`preview:static`），页面请求 `/api/*` 会拿不到后端 JSON，出现登录/鉴权相关报错。  
> 本机若缺少 Python / 编译工具导致 `better-sqlite3` 安装失败，服务会自动降级为 KV 内存模式（数据不落盘，重启清空），不影响本地联调。

---

## 🩺 常见问题

<details>
<summary>WebUI 500 / 白屏</summary>

检查 KV 是否绑定且变量名为大写 `KV`。绑定后需重新部署。

Docker 模式下检查 `KV_FILE` 路径是否有写入权限。

</details>

<details>
<summary>Webhook 设置失败</summary>

- Bot Token 是否正确（格式：`123456:ABC-DEF...`）
- URL 必须是公网 HTTPS：`https://域名/webhook`
- Docker 用户需要配置反向代理提供 HTTPS

</details>

<details>
<summary>消息不转发</summary>

- 群组是否开启了话题功能（超级群组 → 设置 → 话题）
- Bot 是否为群组管理员（需要管理话题权限）
- `FORUM_GROUP_ID` 是否正确（`-100` 开头的数字）
- 用户是否已通过验证

</details>

- 已启用 2FA：通过登录页"恢复"功能，使用 TOTP 码重置密码
- 未启用 2FA：需手动修改存储（KV/D1/数据库中删除 web_users 记录，重启后自动重建默认管理员）

</details>

<details>
<summary>Docker 无 HTTPS</summary>

使用以下方式之一提供 HTTPS：
- **Cloudflare Tunnel**（推荐）：`cloudflared tunnel --url http://localhost:3000`
- **Nginx 反向代理**（见部署指南）
- **Caddy**：自动 HTTPS，配置最简单

</details>

<details>
<summary>验证超时无响应</summary>

- 检查 `VERIFICATION_TIMEOUT` 设置（默认 300 秒）
- Turnstile/reCAPTCHA 需要正确配置 `CAPTCHA_SITE_URL`
- 未配置密钥时会自动回退到数学题验证
- 查看容器日志：`docker compose logs -f telegram-chatbot`

</details>

<details>
<summary>如何查看容器日志</summary>

```bash
# 实时查看日志
docker compose logs -f telegram-chatbot

# 查看最近 100 行
docker compose logs --tail 100 telegram-chatbot

# 关键日志关键词
# [web_app_verify] — Web 验证回调
# [verify_timeout] — 验证超时清理
# [api/verify] — 验证 API 操作
```

</details>

---

## 📄 License

以仓库根目录 `LICENSE` 文件为准。

Telegram_ChatBot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README