Element

连接我们自己的聊天服务

如果你习惯用 Telegram,可以把 Matrix 理解成类似的即时通讯平台。 我们自建了服务器(homeserver),请按本指南用 Element X(iPhone)或 网页版 连接,而不是默认的 matrix.org。

1iPhone:安装与登录

1

在 App Store 安装 Element X

打开 App Store,搜索 element,找到并安装 Element X(绿色图标,副标题为「Sovereign. Seamless. On Matrix」)。 请注意不要安装 Element Classic,那是旧版客户端。

App Store 搜索 element 并选择 Element X
2

选择「创建账户」或「手动登录」

首次打开 Element X 后:新用户点击 「创建账户」已有账号点击 「手动登录」。 注册时需填写邮箱、用户名、密码,以及管理员发放的注册令牌

请勿使用「使用二维码登录」。该功能依赖尚未正式落地的 Matrix 扫码登录协议(MSC4108),目前服务端未完整支持,扫码后通常会失败或超时。请改用上方的创建账户 / 手动登录。

Element X 欢迎页,创建账户或手动登录
3

更改账户提供方

此时页面默认显示「即将登录 matrix.org」。不要直接点「继续」,请点击下方的 「更改账户提供方」,以便连接我们的服务器。

点击更改账户提供方,不要直接继续 matrix.org
4

输入服务器地址

在「主服务器 URL」一栏输入我们的域名,然后点击 「继续」

yyyy.im 输入服务器地址 yyyy.im 并点击继续
5

完成注册或 MAS 登录

点击「继续」后,App 会跳转到浏览器打开注册或登录页面(MAS 认证流程)。 新用户请填写邮箱、用户名、密码及注册令牌;已有账号直接登录。 完成后自动返回 Element X,即可进入聊天界面。

若浏览器未自动返回,请手动切回 Element X 查看是否已成功。

提示:Element X 默认会连到 matrix.org。务必在步骤 3、4 中改成我们的服务器 yyyy.im,否则看不到我们的群组和联系人。

多设备登录

在新手机上登录后,Element X 会提示验证此设备。请在已登录的旧设备上确认,或使用下方保存的恢复密钥,这样才能看到端到端加密的历史消息。

安全备份与恢复密钥

Matrix 的加密消息与设备密钥绑定,不像 Telegram 那样自动云端恢复。 首次登录成功后,请尽快在 Element X 中设置安全备份并妥善保存恢复密钥(Recovery Key)。

  1. 打开 Element X → 设置加密(或「Secure backup」)→ 开启安全备份。
  2. 按提示生成恢复密钥,将其抄写或保存到密码管理器,不要只截图或只留在手机相册里。
  3. 换手机、重装 App 或旧设备不可用时,在新设备登录后输入恢复密钥,才能解密历史加密消息。
重要:若未保存恢复密钥且旧设备已不可用,历史加密消息无法找回。请务必在首次登录后完成备份。
注意:恢复密钥只用于解密加密聊天记录,不能用于找回或重置登录密码。忘记密码请联系管理员处理。

2电脑:网页版与桌面端

网页版

在浏览器打开我们部署的 Element Web,页面已预设我们的 homeserver,直接登录即可:

  1. 在浏览器访问:https://element.yyyy.im
  2. 按页面提示完成 MAS 登录(与手机端相同的认证流程)。
  3. 登录成功后即可在电脑上收发消息,与手机 App 同步。
和 Element X 的关系:网页版和手机 App 登录的是同一个账号。在网页发消息,手机上会同步收到;反之亦然。

桌面端(Element Desktop)

Mac / Windows / Linux 可安装官方桌面客户端,连接方式与手机端相同,需手动指定我们的服务器地址。

  1. element.io/download 安装 Element Desktop。
  2. 首次打开时,不要直接登录 matrix.org。点击 「编辑」「使用自定义服务器」,将 homeserver 改为: yyyy.im
  3. 新用户选择注册,填写邮箱、用户名、密码及管理员发放的注册令牌;已有账号直接登录(MAS 认证流程,与手机端相同)。
  4. 登录成功后,消息与手机、网页版同步。同样建议在设置中开启安全备份并保存恢复密钥。

3和 Telegram 有什么不同?

Matrix 是一个开放的聊天协议,Element X 是其中一个客户端(就像 Telegram 是 Telegram 服务器的客户端)。 我们的账号和数据都托管在自己的服务器上,不依赖 matrix.org 或 Telegram。

Telegram 里你熟悉的

  • 私聊、群组、频道
  • 发文字、图片、文件
  • 手机 + 电脑多端同步
  • @用户名 找人

在 Matrix / Element X 里

  • 房间(Room) ≈ 群组
  • 私信 ≈ 私聊
  • Spaces ≈ 文件夹 / 分类
  • 用户 ID 形如 @alice:yyyy.im
一句话:安装 Element X → 选择我们的服务器 yyyy.im → 完成登录 → 开始聊天。

4几个容易混淆的概念

5常见问题

换手机后看不到以前的加密消息?
加密消息与设备密钥绑定。换机后请用旧设备扫码验证新设备,或在新设备上输入此前保存的恢复密钥。 若既无旧设备、也未保存恢复密钥,历史加密消息将无法恢复。
恢复密钥是什么?必须设置吗?
恢复密钥(Recovery Key)用于在新设备上解密历史加密消息。Matrix 的加密消息不会自动云端备份,强烈建议首次登录后在设置中开启安全备份并保存恢复密钥。 请将其存放在密码管理器或安全的地方;丢失后若旧设备也不可用,历史加密消息将无法恢复。 恢复密钥不能用于找回登录密码,二者请勿混淆。
「使用二维码登录」为什么不能用?
Element X 欢迎页的「使用二维码登录」依赖 Matrix 扫码登录协议(MSC4108),需要已登录的设备(如网页版)生成二维码,再由新设备扫描完成登录和加密密钥同步。 该协议目前仍处于实验阶段,尚未纳入正式标准,我们的服务器暂未完整支持此功能,使用时常见失败或超时。 请改用「创建账户」「手动登录」,按本指南输入服务器地址 yyyy.im 完成注册或登录。
忘记密码怎么办?
目前系统暂不支持自助找回密码,登录页也没有「忘记密码」选项。 若忘记登录密码,请联系管理员重置。 重置后可使用新密码正常登录,账号、房间和联系人不受影响;若此前保存了恢复密钥,登录后仍可在新设备上解密历史加密消息。
网页版和手机能同时在线吗?
可以。Matrix 支持多设备同时登录。首次在新设备登录加密房间时,可能需要完成一次设备验证。
Element X 和旧版 Element(Classic)有什么区别?
Element X 是新一代客户端,界面更简洁、速度更快,是我们推荐的手机 App。 旧版 Element 仍可使用,连接方式类似,但新功能优先在 Element X 上提供。
能发多大的文件?
服务器当前限制单个文件最大 2 GB。超过此大小的文件无法上传;若上传失败,请先检查文件大小是否超出限制。
聊天里的文件会永久保存吗?
不会。服务器会定期清理媒体文件:本服务器上传的文件保留 60 天,从其他 Matrix 服务器缓存过来的外部文件保留 10 天。 到期后文件链接可能失效。重要资料请自行备份到本地,不要只依赖聊天记录中的附件。