大聲公是一个 Telegram 匿名收信机器人:发送者私聊 bot,消息复制给 owner;owner 回复收到的消息,回复复制回发送者。双方不交换任何身份信息。

ownerbot发送者ownerbot发送者fwdMap[转发 ID] = {发送者, 原消息 ID}revMap[发送者侧副本 ID] = 转发 ID私聊消息copyMessage,加署名头回复该条转发消息copyMessage + ReplyParameters

实现:Go + gotgbot v2(长轮询)+ modernc.org/sqlite。单文件 main.go 集中 handler,store.go 负责数据层,texts.go 承载文案。

前提与约束

以下 Bot API 的固有行为决定了实现路径:

  1. bot 无法主动私聊未与之交互的用户(403)。发送方向只能由对方先发起。
  2. 隐私模式下 bot 只能收到群内 @ 它与回复它的消息。本 bot 只处理私聊,群消息一概不转。
  3. 转发消息(ForwardOrigin 非空)一律拒绝并回执,防止冒用他人聊天记录。
  4. 复制消息用 copyMessage:不携带来源,且可被 EditMessageText 编辑。署名头依赖该可编辑性。

数据模型

owner 侧消息 ID 到发送者:

go
var fwdMap = map[int64]fwdEntry{}
type fwdEntry struct {
Sender int64 // 发送者 chatID
Orig int64 // 发送者原消息 id
}

发送者侧消息 ID 到 owner 侧转发 ID,用于续接会话线程:

go
var revMap = map[senderKey]int64{} // {chatID, messageID} -> owner 侧转发消息 id

两张表驻留内存加速查表,并同步追加写入 SQLite 持久化;服务启动时自动加载热数据,并淘汰 30 天前的过期记录。

收发流程

来信:

  1. copyMessage 复制到 owner 侧,得到新消息 ID;
  2. 登记映射 fwdMap[新ID] = {发送者, 原消息ID},同步持久化到 SQLite;
  3. EditMessageText 在转发消息头部注入署名栏:📮 显示名 (@用户名) · 时间 · chatID。

回复:

  1. 提取 msg.ReplyToMessage.MessageId 检索 fwdMap;未命中时即刻给 owner 明确回执「该消息无法解析」,杜绝静默吞消息;
  2. 调用 copyMessage 将回复送还发送者,附带 ReplyParameters{MessageId: ent.Orig} 并指定 AllowSendingWithoutReply: true,确保即使原消息已被发送者撤回也能正常送达;
  3. 记录反向映射 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:

ini
[Service]
User=dsg
MemoryMax=128M
NoNewPrivileges=yes
CapabilityBoundingSet=
ProtectSystem=strict
ReadWritePaths=/srv/docker/daaiSengGung
ProtectHome=yes
PrivateTmp=yes
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX AF_NETLINK
UMask=0077

进程运行完全剥离 root 与外溢特权;/root、/home 目录对服务进程沙盒化不可见(运行环境 .env 由 systemd 提前载入);新建文件 umask 设为 0077(仅属主 0600 可读写),确保保存全部私密来信的数据库文件无法被同机未授权进程窥探。服务整机常驻内存仅约 10 MB。

GitHub Actions 流程:

② VPS · systemd① CI · GitHub Actions不一致失败存活产物

gofmt -l .

go vet ./...

go test -race ./...

静态编译

SHA-256

scp .new

校验哈希

原子替换

重启

健康检查

❌ 中止

❌ 回滚

✅ 上线

  • 二进制更名上传为临时文件 .new,再经远端原子化 mv 覆盖:避免直接覆写正在运行的文件触发系统内核 ETXTBSY(Text file busy)。
  • 替换前自动归档备份上一运行版本;重启后轮询两次 systemctl is-active(间隔 1 秒),一旦状态异常即刻回滚旧版二进制。
  • SSH 主机指纹由仓库 VPS_HOST_KEY secret 强校验固定,未显式配置时回退至 TOFU(Trust on First Use)模式并打出警告日志。

测试

  • TestCatchAllGroupSeparatedFromCommands:验证 handler 分组隔离机制,防止命令穿透回归。
  • entitiesToHTML 属性测试(property-based test),断言三条核心不变量:任意恶意或异常输入绝不 panic;输出中所有的 HTML 尖括号 < 均且仅属于代码生成的安全结构标签;将输出标签完全剥离并反转义后,必须与用户原始输入无损一致。
  • store 读写往返测试(round-trip test):验证 SQLite 写入后读取重构的对象完整无损。

已知限制

  • 明文不可复制的消息类型(服务消息、付费媒体、发票、quiz 投票等)无法转发,只能回执。
  • 单条消息包含多张图片时,会拆成多条消息分别复制。