Discord 桥接 #

基于 mautrix-discord。把 Discord 服务器（"guild"）映射为 Matrix 空间，频道映射为房间，支持完整傀儡模式——你从 Matrix 发出的消息在 Discord 侧看起来就是你本人发的。

前置条件 #

  • Meldry 套餐： Pro 或 Business
  • 一个 Discord 账户
  • 你的 Discord token（下面有说明），或者一个 bot token（如果你想让 Matrix 用户通过一个共享 bot 身份向 Discord 服务器发消息，即"中继模式"）

⚠️ 注意。 使用个人 Discord token 违反 Discord 服务条款。Discord 目前没有对 Matrix 桥接执行过处罚，但风险自担。生产环境或公司 Discord 服务器建议走 bot token 路线。

启用桥接 #

  1. 仪表板 → 服务器 → 桥接 → Discord → 启用。
  2. 等约 10 秒。机器人出现在 @discordbot:<你的名称>.meldry.com。

关联 Discord 账户 #

方案 A——用户 token（傀儡模式） #

  1. 在 Discord 网页或桌面版打开开发者工具 → Network 标签页。
  2. 在任意频道里发一条消息。找到一个请求 https://discord.com/api/...。
  3. 复制 Authorization: 请求头的值（不含前缀，仅 token 本身）。
  4. 给 @discordbot:<你的名称>.meldry.com 发私聊：
    login-token user <你的 token>
  5. 机器人确认 Logged in as YourDiscordHandle#1234。你的服务器会开始桥接。

方案 B——Bot token（中继模式） #

  1. 访问 https://discord.com/developers/applications → New Application → Bot → Add Bot。
  2. 复制 bot token。
  3. 用 Send Messages 和 Read Message History 权限把 bot 邀请到你的 Discord 服务器。
  4. 给桥接机器人发：login-token bot <你的 bot token>
  5. 机器人只会桥接被明确邀请的服务器。

Bot 模式更安全（合规），但失去每用户傀儡——所有 Matrix 用户在 Discord 侧都显示为 bot。

会被桥接什么 #

  • 服务器（Guild） → Matrix 空间
  • 文字频道 → Matrix 房间
  • DM 和群 DM → Matrix DM 房间（仅用户 token 模式）
  • 线程 → Matrix 线程
  • 语音频道 → 不桥接（不支持语音/视频）
  • Emoji、表情反应、自定义 emoji → 同步，自定义 emoji 自动上传
  • 文件上传、embed、贴纸 → 以 Matrix 媒体形式呈现
  • 编辑与删除 → 双向

命令列表 #

命令作用
login-token user <token>用个人 Discord token 登录
login-token bot <token>用 bot token 登录
logout解绑
guilds列出已加入的服务器
bridge <guild-id>手动桥接某一个服务器
unbridge <guild-id>停止桥接某个服务器
help完整命令列表

故障排查 #

"Token invalid"——Discord token 在你从浏览器登出时或修改密码时会失效。重新抓一个。

Bot 用户看不到频道——在 Discord 里，确认 bot 角色对每个想桥接的频道都有 View Channel 权限。

Emoji 和贴纸不显示——自定义 emoji 要求桥接对主机服务器有上传权限。Meldry 默认已启用，无需额外操作。

"账户被标记"——Discord 会标记来自异常 IP 的账户登录。遇到时，通过 Discord 发到你邮箱的验证完成验证。桥接不会绕过验证。

限制 #

  • 无语音/视频。 Discord 语音用的是私有协议。
  • 不支持 Stage 频道（Discord 的音频优先功能）。
  • Nitro 功能 仅当你关联的账户拥有 Nitro 时可用。
  • 服务器加成 可以看到但不会桥接为事件。

下一步 #