连接我们自己的聊天服务
如果你习惯用 Telegram，可以把 Matrix 理解成类似的即时通讯平台。 我们自建了服务器（homeserver），请按本指南用 Element X（iPhone）或 网页版 连接，而不是默认的 matrix.org。
1iPhone：安装与登录
在 App Store 安装 Element X
打开 App Store，搜索 element，找到并安装 Element X（绿色图标，副标题为「Sovereign. Seamless. On Matrix」）。 请注意不要安装 Element Classic，那是旧版客户端。
选择「创建账户」或「手动登录」
首次打开 Element X 后：新用户点击 「创建账户」；已有账号点击 「手动登录」。 注册时需填写邮箱、用户名、密码，以及管理员发放的注册令牌。
请勿使用「使用二维码登录」。该功能依赖尚未正式落地的 Matrix 扫码登录协议（MSC4108），目前服务端未完整支持，扫码后通常会失败或超时。请改用上方的创建账户 / 手动登录。
更改账户提供方
此时页面默认显示「即将登录 matrix.org」。不要直接点「继续」，请点击下方的 「更改账户提供方」，以便连接我们的服务器。
输入服务器地址
在「主服务器 URL」一栏输入我们的域名，然后点击 「继续」：
yyyy.im
完成注册或 MAS 登录
点击「继续」后，App 会跳转到浏览器打开注册或登录页面（MAS 认证流程）。 新用户请填写邮箱、用户名、密码及注册令牌；已有账号直接登录。 完成后自动返回 Element X，即可进入聊天界面。
若浏览器未自动返回，请手动切回 Element X 查看是否已成功。
matrix.org。务必在步骤 3、4 中改成我们的服务器 yyyy.im，否则看不到我们的群组和联系人。
多设备登录
在新手机上登录后，Element X 会提示验证此设备。请在已登录的旧设备上确认，或使用下方保存的恢复密钥，这样才能看到端到端加密的历史消息。
安全备份与恢复密钥
Matrix 的加密消息与设备密钥绑定，不像 Telegram 那样自动云端恢复。 首次登录成功后，请尽快在 Element X 中设置安全备份并妥善保存恢复密钥（Recovery Key）。
- 打开 Element X → 设置 → 加密（或「Secure backup」）→ 开启安全备份。
- 按提示生成恢复密钥，将其抄写或保存到密码管理器，不要只截图或只留在手机相册里。
- 换手机、重装 App 或旧设备不可用时，在新设备登录后输入恢复密钥，才能解密历史加密消息。
2电脑：网页版与桌面端
网页版
在浏览器打开我们部署的 Element Web，页面已预设我们的 homeserver，直接登录即可：
- 在浏览器访问：https://element.yyyy.im
- 按页面提示完成 MAS 登录（与手机端相同的认证流程）。
- 登录成功后即可在电脑上收发消息，与手机 App 同步。
桌面端（Element Desktop）
Mac / Windows / Linux 可安装官方桌面客户端，连接方式与手机端相同，需手动指定我们的服务器地址。
- 从 element.io/download 安装 Element Desktop。
- 首次打开时，不要直接登录 matrix.org。点击 「编辑」 或 「使用自定义服务器」，将 homeserver 改为： yyyy.im
- 新用户选择注册，填写邮箱、用户名、密码及管理员发放的注册令牌；已有账号直接登录（MAS 认证流程，与手机端相同）。
- 登录成功后，消息与手机、网页版同步。同样建议在设置中开启安全备份并保存恢复密钥。
3和 Telegram 有什么不同？
Matrix 是一个开放的聊天协议，Element X 是其中一个客户端（就像 Telegram 是 Telegram 服务器的客户端）。 我们的账号和数据都托管在自己的服务器上，不依赖 matrix.org 或 Telegram。
Telegram 里你熟悉的
- 私聊、群组、频道
- 发文字、图片、文件
- 手机 + 电脑多端同步
- @用户名 找人
在 Matrix / Element X 里
- 房间（Room） ≈ 群组
- 私信 ≈ 私聊
- Spaces ≈ 文件夹 / 分类
- 用户 ID 形如
@alice:yyyy.im
yyyy.im → 完成登录 → 开始聊天。
4几个容易混淆的概念
-
用户名 vs 显示名
用户名（如@alice）用于登录和 @ 提及；显示名可以随意改，只影响别人看到的昵称。 -
房间 vs 频道
Matrix 的「房间」既可以两人私聊，也可以是几百人的群。没有 Telegram 那种单向广播频道，大群公告通常用置顶消息实现。 -
不要和 matrix.org 用户混淆
@user:matrix.org是公共服务器用户，@user:yyyy.im才是我们服务器上的用户。
5让自己的消息靠右显示
Element 默认的「现代」布局里，所有消息（包括你自己发的）都靠左、带头像排列，和 Telegram 那种「自己发的消息靠右、对方靠左」的气泡样式不一样。 如果你更习惯气泡样式，电脑网页版 / 桌面端可以一键切换。
- 打开设置 → 外观（Settings → Appearance）。
- 找到 「消息布局」（Message layout）一栏，从「现代」改选 「消息气泡」（Modern → Message bubbles）。
- 切换后立即生效：你自己发的消息会靠右显示，对方的消息靠左，呈现与 Telegram 类似的气泡效果。
6用 Space 给联系人 / 房间分组
Space（空间）相当于 Telegram 的文件夹 / 分组，可以把相关的房间和私聊归到一起，方便在左侧侧栏快速切换，避免房间多了之后混在一起。 一个 Space 里可以放多个房间，也可以再嵌套子 Space。
创建一个 Space
- 在最左侧的竖排侧栏底部，点击 「+」 按钮 → 选择 「创建 Space / 空间」。
- 填写 Space 名称（如「技术小组」）、设为私有或公开，然后创建。创建后它会作为一个图标出现在左侧侧栏。
把房间加入 Space
选中刚创建的 Space，在「房间与空间」区域点击 「添加」，即可：
- 添加现有房间：把你已经加入的房间归入这个 Space（最常用，见下图高亮项）。
- 新房间 / 新视频房间：直接在该 Space 下创建新房间。
- 添加空间：在 Space 里再嵌套一个子 Space，做更细的分类。
7常见问题
换手机后看不到以前的加密消息？
恢复密钥是什么？必须设置吗？
「使用二维码登录」为什么不能用？
yyyy.im 完成注册或登录。