ef34b01182b743e6cbd0777080cddf2930baedd1
🤖 TPM - Telegram 管理员转发与防骚扰机器人
TPM 是一个基于 Cloudflare Workers 构建的 Telegram 中转机器人, 支持自动消息转发、管理员回复、屏蔽机制、人机验证、关键词拦截、以及远程拦截词表同步。
🚀 功能简介
- 管理员中转:用户消息自动转发给管理员,管理员可直接回复。
- 人机验证:首次或超过 3 小时未验证的用户需点击按钮验证。
- 屏蔽与解封:管理员可
/block/unblock用户。 - 关键词过滤:支持本地和远程拦截词(自动定时刷新)。
- 多语言提示:支持中英文自动识别。
- 节流提醒:用户等待提示每小时最多出现一次。
- Webhook 自动注册:支持一键注册、注销、查看。
⚙️ 环境变量
| 变量名 | 示例值 | 说明 |
|---|---|---|
ENV_BOT_TOKEN |
XXX:XXXXXX |
Telegram Bot Token |
ENV_BOT_SECRET |
secret_value |
Webhook Secret Token |
ENV_ADMIN_UID |
"123456789" |
管理员的 Telegram UID(纯数字字符串) |
🛠️ 部署步骤
- 打开 Cloudflare Dashboard → Workers & Pages → 新建 Worker
- 将
worker.js全部代码复制进去 - 在 “Settings → Variables → Environment Variables” 添加上述三个环境变量
- 绑定 KV:
- 命名空间名称任意
- 绑定变量名固定为:
KV
- 部署后访问:
https://你的域名/registerWebhook注册 Webhookhttps://你的域名/debugWebhook查看绑定状态
🧩 管理员命令
| 命令 | 说明 |
|---|---|
/block |
屏蔽用户(需回复用户消息) |
/unblock |
解除屏蔽(需回复用户消息) |
/checkblock |
查看屏蔽状态 |
/addkw <关键词> |
添加屏蔽关键词 |
/rmkw <关键词> |
移除屏蔽关键词 |
/listkw |
查看本地关键词 |
/reloadblock |
强制刷新远程拦截词 |
/listkw_remote |
查看远程词表前 100 条 |
/listkw_all |
查看本地 + 远程合并词表 |
/version |
查看当前提示文案版本 |
/notifytest |
测试用户等待提醒内容 |
/resetnotify <userId> |
手动清理某个用户节流键 |
⚡ 调试命令
| 路径 | 功能 |
|---|---|
/registerWebhook |
重新注册 Webhook |
/unRegisterWebhook |
注销 Webhook |
/debugWebhook |
查看当前绑定状态 |
/setMenu |
更新命令菜单 |
Languages
JavaScript
100%