桥接 #

桥接（Bridge） 是一种运行在你的 Matrix 服务器与外部聊天网络（Telegram、Slack、Discord 等）之间的程序，负责双向翻译消息。从你的 Matrix 客户端里看，所有人都"在 Matrix 上"；从 Telegram / Slack / Discord 那边看，你就是他们网络里的普通用户。

结果是：所有聊天都收到同一个收件箱。不用在六个应用之间来回切换。

为什么用桥接？ #

  • 统一客户端。 用 Element（或任何你喜欢的 Matrix 客户端）作为唯一的聊天界面，即便你的同事在用 Telegram、客户在用 WhatsApp。
  • 自有聊天历史。 经桥接流转的消息都会落入你 Matrix 服务器的数据库——由你控制保留策略、导出和删除。
  • 自身端到端加密不丢。 Matrix 用户之间的房间保持 E2EE。跨到外部网络的消息在桥接处解密，再按对方网络的规则重新加密（大多数桥接支持"双向傀儡"以保证加密房间在两端都保持加密）。
  • 随时可退。 桥接按网络单独开关，从仪表板干净地卸载。

桥接工作原理 #

桥接实现为一个 Matrix Appservice——Matrix 协议允许第三方程序注册一段命名空间，在其中创建虚拟用户和房间。实际流程：

  1. 在 Meldry 仪表板 → 服务器 → 桥接 里启用桥接。
  2. Meldry 在你的主机服务器旁启动桥接进程（例如 mautrix-telegram），并将配置指向你的服务器。
  3. 桥接在你的服务器上注册一个机器人用户，通常是 @telegrambot:你的名称.meldry.com。
  4. 在任意 Matrix 客户端给这个机器人发私聊并发送 login。
  5. 机器人会引导你关联外部账户——通常是 OAuth 流程、扫二维码或从外部应用粘贴 Session Token。
  6. 关联完成后，桥接会生成"傀儡"Matrix 用户和房间，分别对应你在外部网络的联系人和聊天。

你在被傀儡化的 Matrix 房间里发消息，桥接会把它推送到外部网络；外部网络的消息则作为 Matrix 事件推回给你。

Meldry 支持的桥接 #

桥接网络所需套餐说明
mautrix-telegramTelegramPro全面覆盖——1 对 1、群、频道、媒体
mautrix-slackSlackPro工作区 → 空间，频道 → 房间，线程同步
mautrix-discordDiscordPro服务器 → 空间，频道同步，语音除外
mautrix-whatsappWhatsAppBusiness需要手机扫码
mautrix-signalSignalBusiness需要从 Signal Desktop 关联
dingtalk钉钉Business中国区、基于 webhook
feishu飞书（Lark）Business需要飞书应用凭证

其他桥接（IRC 通过 Heisenbridge、微信、Google Chat 等）可按需启用——提交工单即可。

套餐限制 #

  • Free——不支持桥接。
  • Starter——2 个桥接。
  • Pro——5 个桥接，并启用联邦。
  • Business——桥接数量不限，优先支持。

完整套餐对比见 计费。

傀儡模式 vs 中继模式 #

大多数桥接支持两种运行模式：

  • 傀儡模式（Puppeting，推荐）。 你关联 自己 在外部网络的账户。你从 Matrix 发出的消息在外部网络显示为你本人发的。加密房间能在两端都保持端到端加密。
  • 中继模式（Relay）。 一个机器人账户代表 所有 Matrix 用户出现在外部网络里。外部网络看到的消息是 [Alice] 来自 Matrix 的消息 这种格式。配置更简单（无需每人登录），但 DM 和表情回应会丢失，外部网络的 E2EE 也不复存在。

傀儡模式要求每一个想用桥接的用户都关联自己的账户。中继模式适合有大量 Matrix 用户参与的公开房间，而他们不想每人都去注册外部网络的账户。

通用设置流程 #

本小节里每篇桥接指南都遵循相同的步骤：

  1. 启用桥接：仪表板 → 服务器 → 桥接。
  2. 给桥接机器人发私聊（@telegrambot:…、@slackbot:… 等）。
  3. 用 login 命令关联账户——每个桥接流程略有差异（二维码、OAuth、Token 等）。
  4. 把具体房间绑定上：!bridge <room-id>（或该桥接等价的命令）。

按需查看每篇指南：

故障排查 #

桥接启动不了。 确认你的套餐配额（Free 0 个，Starter 2 个，Pro 5 个，Business 不限）。在 仪表板 → 通知 里查看启动日志。

无法给机器人发私聊。 机器人用户在桥接成功启动之后才会出现。启用后等 10 秒左右，再刷新客户端联系人。

消息不同步。 在与桥接机器人的私聊里发送 status，它会报告外部账户的关联状态。如果显示"未登录"，重新跑一次 login。

外部网络速率限制。 Telegram、WhatsApp、Signal 都有较严格的速率限制。如果你在桥接房间里发消息过快，桥接会被临时限流。等几分钟即可。

加密报错。 如果在桥接的加密房间里读不到消息，说明傀儡用户可能没有你的设备密钥。在房间中点 成员 → 验证本会话，或从仪表板重启桥接。

安全提示 #

  • 桥接对两端的消息都有完整访问权限。请了解你启用的桥接镜像来源。
  • Meldry 对多数网络直接使用上游 mautrix 镜像。钉钉和飞书桥接由我们自行构建。
  • 外部网络的凭据（Telegram session、Signal 链接、Slack token）会 加密保存 在你工作区的私有存储里，不会跨工作区共享。
  • 在仪表板删除桥接会同时删除凭据并关闭所有傀儡房间。已经投递到 Matrix 房间的消息仍然保留；尚未同步的外部消息不会再补回来。

下一步 #

挑一个你想要连接的网络：

  • Telegram——最容易上手的桥接
  • Slack——需要你是工作区管理员
  • Discord——Discord 服务器 → Matrix 空间
  • WhatsApp——从手机扫码关联
  • Signal——从 Signal Desktop 关联
  • 钉钉——给中国区团队
  • 飞书 (Lark)——给字节跳动内部工作区