具有图片验证码和用户管理功能的 Telegram 消息转发机器人。
- 🔐 图片验证码防垃圾消息
- 💬 主人回复功能（直接回复转发消息）
- 🚫 用户拉黑/解除拉黑（
/block和/unblock命令） - ☁️ Supabase 云数据库（数据永不丢失）
- 🐳 Docker 支持
去除一些无用提醒
- 去除新用户使用提醒
- 去除用户/主人 消息发送成功提醒
graph TB
A[👤 用户发送消息] --> B{是否已验证?}
B -->|否| C[显示提示:<br/>请先发送 /start]
C --> D[用户发送 /start]
D --> E{是否被拉黑?}
E -->|是| F[❌ 提示:<br/>您已被拉黑]
E -->|否| G[📷 发送验证码图片]
G --> H[用户输入验证码]
H --> I{验证是否正确?}
I -->|正确| J[✅ 验证成功]
J --> K[通知主人:<br/>新用户通过验证]
K --> L[用户可以发送消息]
I -->|错误| M{剩余次数?}
M -->|还有机会| N[❌ 提示错误<br/>请重试]
N --> H
M -->|3次全部失败| O[🚫 自动拉黑]
O --> P[记录失败原因]
B -->|是| Q{是否被拉黑?}
Q -->|是| R[❌ 拒绝发送]
Q -->|否| S[📤 转发消息给主人]
S --> T[💾 保存消息映射<br/>message_id → user_id]
T --> U[👨💼 主人收到消息]
U --> V{主人操作?}
V -->|回复消息| W[🔍 查找消息映射]
W --> X[📨 发送回复给用户]
X --> Y[用户收到回复]
V -->|回复 + /block| Z[🚫 拉黑该用户]
Z --> AA[用户无法再发送]
V -->|回复 + /unblock| AB[✅ 解除拉黑]
AB --> AC[用户可以发送]
V -->|/block 用户ID| AD[🚫 直接拉黑]
AD --> AA
V -->|/unblock 用户ID| AE[✅ 直接解除]
AE --> AC
style A fill:#e1f5fe
style B fill:#fff3e0
style E fill:#fff3e0
style F fill:#ffebee
style G fill:#e8f5e8
style J fill:#e8f5e8
style O fill:#ffebee
style R fill:#ffebee
style S fill:#f3e5f5
style U fill:#e8f5e8
style Y fill:#e1f5fe
style Z fill:#ffebee
style AB fill:#e8f5e8
先配置数据库
在 Supabase 创建项目，然后在 SQL Editor 中执行：
-- 消息映射表
CREATE TABLE message_mappings (
id BIGSERIAL PRIMARY KEY,
forwarded_message_id BIGINT UNIQUE NOT NULL,
user_id BIGINT NOT NULL,
username TEXT,
created_at TIMESTAMPTZ DEFAULT NOW()
);
-- 已验证用户表
CREATE TABLE verified_users (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT UNIQUE NOT NULL,
username TEXT,
verified_at TIMESTAMPTZ DEFAULT NOW()
);
-- 待验证用户表
CREATE TABLE pending_verifications (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT UNIQUE NOT NULL,
code TEXT NOT NULL,
attempts INTEGER DEFAULT 0,
expires_at TIMESTAMPTZ NOT NULL,
created_at TIMESTAMPTZ DEFAULT NOW()
);
-- 拉黑用户表
CREATE TABLE blocked_users (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT UNIQUE NOT NULL,
blocked_at TIMESTAMPTZ DEFAULT NOW()
);
-- 创建索引
CREATE INDEX idx_message_mappings_forwarded_id ON message_mappings(forwarded_message_id);
CREATE INDEX idx_verified_users_user_id ON verified_users(user_id);
CREATE INDEX idx_pending_verifications_user_id ON pending_verifications(user_id);
CREATE INDEX idx_blocked_users_user_id ON blocked_users(user_id);docker run -d \
--name telegram-bot \
--restart unless-stopped \
-e BOT_TOKEN="你的Bot_Token" \
-e OWNER_ID="你的用户ID" \
-e SUPABASE_URL="你的Supabase_URL" \
-e SUPABASE_KEY="你的Supabase_Key" \
-v $(pwd)/logs:/app/logs \
ghcr.io/ham0mer/tgbot:latest拉取镜像，重启容器
docker pull ghcr.io/ham0mer/tgbot:latest修改 docker-compose.yml：
services:
telegram-bot:
image: ghcr.io/ham0mer/tgbot:latest
container_name: telegram-bot
restart: unless-stopped
environment:
- BOT_TOKEN=${BOT_TOKEN}
- OWNER_ID=${OWNER_ID}
- SUPABASE_URL=${SUPABASE_URL}
- SUPABASE_KEY=${SUPABASE_KEY}
- LOG_LEVEL=info
volumes:
- ./logs:/app/logs
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"docker compose up -d && docker compose logs -fdocker compose pull && docker compose down && docker compose up -d && docker compose logs -f
docker image prune- 发送
/start获取验证码 - 回复验证码完成验证
- 验证后可正常发送消息
- 回复用户：直接回复转发的消息
- 拉黑用户：回复用户消息并发送
/block - 解除拉黑：回复用户消息并发送
/unblock