大聲公是一个 Telegram 匿名收信机器人:发送者私聊 bot,消息复制给 owner;owner 回复收到的消息,回复复制回发送者。双方不交换任何身份信息。
实现:Go + gotgbot v2(长轮询)+ modernc.org/sqlite。单文件 main.go 集中 handler,store.go 负责数据层,texts.go 承载文案。
前提与约束
以下 Bot API 的固有行为决定了实现路径:
- bot 无法主动私聊未与之交互的用户(403)。发送方向只能由对方先发起。
- 隐私模式下 bot 只能收到群内 @ 它与回复它的消息。本 bot 只处理私聊,群消息一概不转。
- 转发消息(
ForwardOrigin非空)一律拒绝并回执,防止冒用他人聊天记录。 - 复制消息用
copyMessage:不携带来源,且可被EditMessageText编辑。署名头依赖该可编辑性。
数据模型
owner 侧消息 ID 到发送者:
var fwdMap = map[int64]fwdEntry{}
type fwdEntry struct { Sender int64 // 发送者 chatID Orig int64 // 发送者原消息 id}发送者侧消息 ID 到 owner 侧转发 ID,用于续接会话线程:
var revMap = map[senderKey]int64{} // {chatID, messageID} -> owner 侧转发消息 id两张表驻留内存加速查表,并同步追加写入 SQLite 持久化;服务启动时自动加载热数据,并淘汰 30 天前的过期记录。
收发流程
来信:
copyMessage复制到 owner 侧,得到新消息 ID;- 登记映射
fwdMap[新ID] = {发送者, 原消息ID},同步持久化到 SQLite; EditMessageText在转发消息头部注入署名栏:📮 显示名 (@用户名) · 时间 · chatID。
回复:
- 提取
msg.ReplyToMessage.MessageId检索fwdMap;未命中时即刻给 owner 明确回执「该消息无法解析」,杜绝静默吞消息; - 调用
copyMessage将回复送还发送者,附带ReplyParameters{MessageId: ent.Orig}并指定AllowSendingWithoutReply: true,确保即使原消息已被发送者撤回也能正常送达; - 记录反向映射
revMap[发送者侧副本ID] = owner 侧转发 ID,维持多轮会话线程不断链。
对于贴纸、语音、图片等无文本载体的消息,无法直接在头部追加文字,改为在该条下方紧随补发一条署名标签,该标签消息 ID 同样纳入映射管理。
实现要点
handler 分组
gotgbot 的 handler 按 group 顺序执行:同一 group 内只运行第一个命中的 handler,后续 group 一定会执行。命令注册在 group 0,收信总入口在 group 1。
- 命令 handler 必须返回
ext.EndGroups,否则命令文本会被收信入口当作普通消息再转发一次; - 非 owner 的斜杠消息不吞掉:命令包装器对非 owner 返回
ext.ContinueGroups,交给收信入口按普通消息处理; - 缺少
EndGroups曾导致/later、/done、/top、/export失效且命令文本被重复转发,现由回归测试TestCatchAllGroupSeparatedFromCommands固定。
实体转换
署名栏由 EditMessageText 动态拼入原文头部,因此必须无损保留原文的粗体、超链接和行内代码等富文本格式。Telegram 的 MessageEntity 中 offset 与 length 是以 UTF-16 码元(code units)计数的,既非字节偏移,也非 Unicode rune。当中英文与 emoji 等辅音字符混排时,直接按 Go 原生字符串切片必然产生字符截断错位,甚至越界 panic。本实现的方案是先将 UTF-16 码元边界精确映射为 UTF-8 字节偏移,再按区间切片拼接并输出 HTML。
日志脱敏
gotgbot 传输层出现网络或请求异常时,默认会将包含 bot token 的完整请求 URL 拼进错误信息;由于系统日志接入 journald 并持久化两周,存在凭证泄漏隐患。处理方式落在日志底层出口:封装一层自定义 io.Writer,在数据落盘前通过正则把 token 统一重写为 <redacted>,slog 与标准库 log 均挂载该 writer。
限流与容错
Telegram API 中 copyMessage 失败即意味着消息静默丢失。gotgbot 框架并未自带 429 退避重试,此处封装了 copyRetry:仅对返回 ResponseParams.RetryAfter > 0 的限流错误执行重试,至多 3 次;若 retry_after 超过 30 秒则视为系统瓶颈直接放弃,并双向回执告知发送者与 owner。
启动参数固定 DropPendingUpdates: false,保证维护或重启期间积压的来信在恢复运行后继续完整转递。
发送频次防御:以 60 秒滑动窗口为限,放行 15 条消息;达到第 16 条时下发警告,第 17 条直接丢弃,第 18 条自动封禁该用户并向双方发送通知。封禁触发时立即重置该用户的限流窗口计数,防止后续 /unban 解封后在残余窗口内被二次误封。用户编辑已发送消息的行为同样扣除该频次额度。
命令
| 命令 | 说明 |
|---|---|
/history <id> | 某用户最近对话(默认 10 条,上限 50) |
/search <关键词> | 跨用户全文搜索 |
/export <id> | 导出某用户全部对话为 txt |
/later /done | 回复转发消息标记待办、销号 |
/canned [编号] | 预置回复模板,一键回传 |
/away <内容> | 自动回复,同一用户 5 分钟一次 |
/msg <id> <内容> | 定向单发 |
/top /stats /broadcast | 活跃排行、统计、群发 |
/ban /unban | 封禁、解封,支持回复转发消息或直接给 id |
对方编辑已发送消息时,owner 侧转发同步更新(SetAllowEdited)。
部署
modernc.org/sqlite 为纯 Go 实现,CGO_ENABLED=0 静态编译出单个二进制,运行于 systemd:
[Service]User=dsgMemoryMax=128M
NoNewPrivileges=yesCapabilityBoundingSet=ProtectSystem=strictReadWritePaths=/srv/docker/daaiSengGungProtectHome=yesPrivateTmp=yesRestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX AF_NETLINKUMask=0077进程运行完全剥离 root 与外溢特权;/root、/home 目录对服务进程沙盒化不可见(运行环境 .env 由 systemd 提前载入);新建文件 umask 设为 0077(仅属主 0600 可读写),确保保存全部私密来信的数据库文件无法被同机未授权进程窥探。服务整机常驻内存仅约 10 MB。
GitHub Actions 流程:
- 二进制更名上传为临时文件
.new,再经远端原子化mv覆盖:避免直接覆写正在运行的文件触发系统内核ETXTBSY(Text file busy)。 - 替换前自动归档备份上一运行版本;重启后轮询两次
systemctl is-active(间隔 1 秒),一旦状态异常即刻回滚旧版二进制。 - SSH 主机指纹由仓库
VPS_HOST_KEYsecret 强校验固定,未显式配置时回退至 TOFU(Trust on First Use)模式并打出警告日志。
测试
TestCatchAllGroupSeparatedFromCommands:验证 handler 分组隔离机制,防止命令穿透回归。entitiesToHTML属性测试(property-based test),断言三条核心不变量:任意恶意或异常输入绝不 panic;输出中所有的 HTML 尖括号<均且仅属于代码生成的安全结构标签;将输出标签完全剥离并反转义后,必须与用户原始输入无损一致。- store 读写往返测试(round-trip test):验证 SQLite 写入后读取重构的对象完整无损。
已知限制
- 明文不可复制的消息类型(服务消息、付费媒体、发票、quiz 投票等)无法转发,只能回执。
- 单条消息包含多张图片时,会拆成多条消息分别复制。
评论
GitHub 登录后可评论。
评论区会在滚动到这里时自动加载。