用 SafeRelay 搭一个防骚扰 Telegram 私聊机器人

访客只接触机器人，消息在后台进入独立话题；不用公开个人账号，也不用再养一台 VPS。

工程笔记 · 2026-07-26 · 约 8 分钟阅读 · 标签：Telegram、Cloudflare Workers、Turnstile、安全

公开 Telegram 用户名很方便，但也等于把私聊入口直接暴露出去。广告、推广、陌生链接和没有上下文的“在吗”会一起挤进个人会话。SafeRelay 的定位很直接：在访客和管理员之间放一个 Bot，先验证、再过滤、最后中转。

用户端依然只是私聊机器人；管理员端可以选择个人私聊，也可以把每位访客分配到 Telegram 论坛群组中的独立话题。后者更像一个轻量工单箱，图片、文件、编辑记录和回复不会混在一起。

上游项目：qianqi32/SafeRelay。实际部署基于我维护的 SafeRelay Personal Edition，个人维护仓库当前保持私有；上游归属与 GPL-3.0 许可仍完整保留。

最终架构

访客
  ↓ 私聊
Telegram Bot
  ↓ Webhook
Cloudflare Worker + KV + Turnstile
  ↓
管理员论坛群组
  └─ 每位访客一个独立话题

这套架构不需要常驻服务器。Worker 处理 Telegram Webhook 和验证页面，KV 保存验证状态、黑白名单、消息映射、话题映射及工单状态。

我实际启用的功能

  • Turnstile 人机验证：新访客先验证，再进入对话。
  • 话题工单模式：每个用户自动创建独立话题。
  • 内容保护：中转消息可限制继续转发和保存。
  • 编辑同步：文字、图片说明、视频说明和文件说明都能处理。
  • 媒体更新保留历史：管理员替换附件时发送新版本，不无痕覆盖用户收到的旧附件。
  • 工单状态：管理员用表情回应更新处理中、等待用户和已完成状态。
  • 广播、黑白名单和自动回复：适合低流量个人联系入口。

编辑同步是最值得修的细节

普通文字可以直接调用 Telegram 的编辑接口，但图片、视频和文件不是一回事。原版已经支持文字和 caption 编辑，但用户修改媒体说明时有机会被识别成“无文本内容”；管理员更新媒体本体时，也不能简单把它当成文字覆盖。

我的处理规则是：

  1. 访客编辑文字或媒体说明：管理员看到的原消息保持不变，Bot 回复一条带 ✏️ 的更新提示；继续编辑时更新这条提示。
  2. 管理员编辑纯文字：同步编辑用户侧的对应消息。
  3. 管理员替换图片、视频或文件：保留用户侧旧附件，复制发送更新后的新附件，并把后续映射切换到新版本。

这样不会发生附件被无痕替换，也保留了完整上下文。

部署前做的安全加固

能运行不等于适合直接公开。我在部署前补了几处：

  • /registerWebhook 和 /unRegisterWebhook 增加独立管理密钥，阻止陌生人远程注销 Webhook。
  • 上游远程欺诈 UID 列表默认关闭，只有显式配置地址才启用。
  • 联合封禁默认关闭，避免无意中把访客 UID 发送给第三方。
  • Turnstile 同时校验 hostname 和 action。
  • Bot Token、管理员 UID 和各类密钥全部使用 Cloudflare Secrets，不写进 Git。
  • 加入 Node 回归测试、Wrangler dry-run 和 GitHub Actions。

仓库中的 wrangler.toml 只是可复用模板，不包含真实 KV ID、群组 ID 或 Worker 生产名称；本机使用被 Git 忽略且权限为 0600 的生产配置，秘密保存在本地变量文件和 Cloudflare Worker Secrets 中。

群组模式还是直接转发到个人私聊

对用户来说没有区别，他们永远只是在私聊 Bot。区别只在管理员后台。

  • 个人私聊模式：部署最简单，适合偶尔只有一两条消息，但所有访客内容会混在一个会话里。
  • 论坛话题模式：每位访客一个话题，适合图片、文件、长期沟通和工单状态，也是我最终采用的方式。

论坛群组不需要公开，也不需要把访客拉进群。群里只保留管理员和 Bot，把它当作后台收件箱即可。

成本和维护

低流量个人使用基本可以放在 Cloudflare 免费额度内。真正需要留意的是 KV 写入：消息映射、话题映射、编辑和表情同步都会产生写操作。它适合个人联系、反馈和轻量客服，不适合直接当作高并发商业工单平台。

当前部署采用固定审核版本，不自动追随上游 main。上游更新时先看 diff、跑测试，再决定是否同步。

使用体验

部署完成后，访客先看到欢迎语，再完成 Turnstile。验证后的消息会进入对应话题，我可以直接在话题里回复。自动回复用于确认消息已收到，广播功能则可以向所有已验证用户发送维护公告。

第一天使用下来，核心链路已经稳定：Webhook 没有积压，话题权限正常，内容保护和 Turnstile 已开启。后续重点观察媒体组、连续编辑、KV 写入量以及工单状态在长期会话中的表现。

适合谁

  • 需要公开联系入口，但不想暴露个人 Telegram 账号的人。
  • 想接收反馈、投稿、合作联系或自托管服务故障报告的人。
  • 希望每位访客独立归档，又不想部署完整客服平台的小团队。

如果平时只有熟人联系，直接私聊更简单；如果要把 Telegram 放到公开网站上，SafeRelay 这种“先验证再中转”的模式就很实用。

全部文章 · 返回 OneMJJ 首页

OneMJJ · 少踩坑，多留传家宝 · Public tools first.