RELAY

AWRelay

轻量自托管的 Telegram 私聊消息中转机器人,用超级群组话题模式构建清晰的私聊收件箱。

PROJECT INTRO

项目介绍

AWRelay 把用户发给机器人的私聊消息转发到启用了 Topics 的超级群组里,每位用户对应一个独立话题。管理员直接在话题内发消息即可回传给用户。

主要功能

话题式收件箱双向消息回传人机验证广告过滤黑名单限流保护

前置条件

  • 一个已开启 Topics 的 Telegram 超级群组
  • Bot 已加入群组并具备管理员权限
  • 准备好 BOT_TOKENADMIN_IDGROUP_ID
  • 如需代理,准备 PROXY_URL

详细搭建方法

  1. 创建 Telegram Bot,并从 @BotFather 获取 BOT_TOKEN
  2. 准备管理员的 Telegram 数字 ID,填入 ADMIN_ID
  3. 创建超级群组并开启 Topics。
  4. 把 Bot 加入群组并授予管理话题权限。
  5. 获取群组的 GROUP_ID
  6. 编辑 docker-compose.yml,填入 BOT_TOKENADMIN_IDGROUP_ID
  7. 如需代理,补充 PROXY_URL
  8. 执行 docker compose pulldocker compose up -d
  9. 使用 docker compose logs -f 查看日志,确认机器人已上线。
  10. 在群中发送 /menu 检查控制面板与过滤规则。

本地运行

  1. 执行 pip install -r requirements.txt
  2. 复制 .env.example.env
  3. 填写 BOT_TOKENADMIN_IDGROUP_ID
  4. 执行 python main.py

管理指令

  • /menu:打开控制面板
  • /ban:拉黑对应用户
  • /unban:解除黑名单
  • /cancel:取消当前输入
  • /help:查看帮助