Meldry 快速入门 #

这是一份完整的首次使用指南：从"我完全不知道 Matrix 是什么"到"我已经在自己的服务器上和团队聊天"。如果下面某个概念你不熟悉，先看 Matrix 协议——那篇把本页用到的所有词汇都定义好了，还包含完整的客户端对比。

第 1 步——在 Meldry 上创建服务器 #

打开 meldry.com，点击 立即开始。

方案 A——用户名与密码 #

填写：

  • 用户名——3-30 个字符，小写字母、数字、下划线、连字符。它既是你的 Meldry 账户名 也是 你 Matrix 服务器的子域名，所以挑一个你愿意公开露出的词。例如：acme-team。
  • 密码——8-128 个字符。会对照公开的泄漏库自动拒绝常见弱密码。
  • 邮箱 (可选但强烈推荐)——用于密码找回、账单回执与滥用通知。
  • 优惠码 (可选)——有的话贴在这里。详见 计费。

点 创建工作区。背后 Meldry 会依次：

  1. 在我们的数据库里创建你的账户。
  2. 开通一个独立的 Postgres Schema。
  3. 在最近的集群区域启动一个 Matrix 主机服务器容器。
  4. 按套餐安装默认的桥接 / appservice。
  5. 为 <你的名称>.meldry.com 配置 DNS 并签发 Let's Encrypt TLS 证书。

开通流程一般不到 5 秒。当仪表板刷新时，服务器状态会变成 running。

方案 B——用 GitHub、Google 或其他 OAuth 提供商注册 #

  1. 点 使用 GitHub 登录（或 Google、飞书、微信等）。
  2. 在提供商的授权页面同意授权给 Meldry。
  3. 首次登录时你会被要求二选一：
    • 创建新的 Meldry 账户，用提供商返回的建议用户名，或
    • 关联到已有账户，输入你的 Meldry 用户名和密码。
  4. 服务器会按方案 A 的流程自动开通。

完整的账户关联流程见 安全 → OAuth / OIDC。

第 2 步——获取服务器信息 #

当仪表板变绿，你会看到一张卡片，里面列着你后续需要用到的全部信息：

  • 子域名 URL——https://<你的名称>.meldry.com
  • Matrix 主机地址——同上，这是贴到任何 Matrix 客户端里的那段地址
  • Matrix 用户 ID 模板——@<本地名>:<你的名称>.meldry.com（你的第一个 Matrix 用户会自动创建，本地名就是你注册时填的用户名）
  • 会话令牌——Meldry 仪表板的会话，浏览器会自动保存。

Matrix 凭证（注意：它跟你登录 meldry.com 仪表板用的凭证是 分开的）可以在仪表板的 服务器 → Matrix 用户 页面看到。首次开通时，系统会为你预建一个和注册用户名同名的 Matrix 用户——你可以在那个页面重置它的密码。

第 3 步——安装 Matrix 客户端 #

从 Matrix 客户端 子页里挑一个。本教程用 Element，因为它功能最全：

  • 桌面：https://element.io/download
  • 手机：Element X（App Store / 各大应用商店）
  • Web（免安装）：https://app.element.io

第 4 步——登录 #

  1. 启动客户端，进入欢迎页。
  2. 点 登录。
  3. 当出现主机服务器字段时，点 编辑（Element）或 其他（FluffyChat / Cinny）。千万不要直接用默认的 matrix.org——那会登录到 Matrix 公服，而不是你自己的服务器。
  4. 把 https://<你的名称>.meldry.com 粘进去。
  5. 点 继续。客户端会校验是否能访问到你的主机服务器，然后弹出登录表单。
  6. 输入你的 Matrix 用户名（只填本地名，例如 alice，不要填完整的 @alice:server 格式）和 Matrix 密码。
  7. 点 登录。

你现在已经在你自己的 Matrix 服务器上了。

第 5 步——客户端首次运行配置 #

Element（以及大多数客户端）在首次登录时会带你走三个快捷设置：

  1. 设置显示名。 这是别人看到的人类可读名字——例如"Alice Chen"。随时可改。
  2. 上传头像。 可选，但上传后你在群聊里不会看起来那么"匿名"。
  3. 设置加密密钥备份。 Matrix 的加密密钥默认只存在设备上，如果设备丢失且没有备份，你会失去所有加密历史。Element 会邀请你生成一段 恢复密钥（一长串字符）和/或 恢复口令——至少保存其中一个到安全的地方，例如密码管理器。

第 6 步——创建第一个房间 #

  1. 在左侧边栏"房间"分区旁点 + → 新建房间。
  2. 起个名字（例如 综合）。
  3. 选 私密（加密，默认）或 公开（不加密，可搜索）。
  4. 点 创建。

新房间打开。在底部输入框里写一条消息，按回车。恭喜——你刚刚通过自己的 Matrix 服务器发出了第一条端到端加密消息。

第 7 步——邀请成员 #

在房间里点房间标题 → 成员 → 邀请。

  • 邀请 你自己服务器上 的用户：输入 @他的本地名:你的名称.meldry.com。
  • 邀请 其他 Matrix 服务器 的用户（若你的套餐启用了联邦）：输入对方的完整 MXID，例如 @friend:matrix.org。
  • 邀请尚未有 Matrix 账户的人：用 Meldry 仪表板的邀请功能生成一条注册链接，发给对方。

对方接受后，这个房间就会出现在他的客户端里。

第 8 步——启用设备验证 #

如果你在第二台设备登录（例如笔记本 + 手机），Matrix 会提示出现了未验证的会话。验证一下能防止攻击者入侵服务器后偷偷加入自己的设备读你的消息。

  1. 在已经登录的设备上，打开 设置 → 安全与隐私 → 会话。
  2. 找到新会话，点 验证。
  3. 对比两台设备上的 emoji 序列（或扫描对方的二维码）。

验证通过后，所有加密房间的历史会在新设备上解密。完整细节见 安全 → 设备验证。

故障排查 #

  • 仪表板一直卡在 "pending" 超过一分钟。 点 重试，或查看右上角的通知铃铛。集群繁忙时容器创建偶尔会慢一点。
  • Element 提示"无法连接到主机服务器"。 确认你填的是 https:// 开头，而且用的是 <你的名称>.meldry.com（不是 meldry.com）。在浏览器里打开 https://<你的名称>.meldry.com/_matrix/client/versions，应该能看到一小段 JSON。如果看不到，说明工作区还没跑起来，去仪表板检查。
  • "凭证无效"，但密码明明是对的。 记住：你的 Meldry 仪表板 密码（meldry.com）和 Matrix 密码（Element 登录）是两套。需要重置 Matrix 那个，在 服务器 → Matrix 用户 里操作。
  • 恢复密钥丢了，读不了旧的加密消息。 这是协议层的限制——Matrix 的端到端加密决定了即便是 Meldry 运营方也无法帮你恢复。不过之后的新消息在新设备上能正常显示。

下一步 #

  • Matrix 协议——房间、空间、联邦、E2EE 与客户端的深入解释
  • 服务器管理——启停、自定义域名、团队、监控
  • 桥接——连接 Telegram、Slack、Discord 等
  • 安全——2FA、API 密钥、会话、审计日志、数据导出
  • 计费——套餐、支付、发票、优惠码、退款