跳转到内容

iOS 应用

  • iOS 17 或更高版本。
  • 运营者提供的、运行协议第 3 版(rChat 2.0.0)的 rChat 中继的邀请:一个二维码或一条 rchat://relay 链接。没有邀请时,需要中继的 URL,包含其 WebSocket 路径,例如 wss://chat.example.com/<websocket_path>。

应用即将登陆 App Store。目前还没有 Mac 应用,参见 Mac 应用。

  1. 欢迎。 点击继续进行设置。
  2. 连接。 输入显示名称,然后选择中继:Scan relay invite(扫描运营者的二维码)或 Paste invite。rChat 会显示中继的主机名并请您确认,然后保存地址并固定中继的身份。没有邀请时,可通过 Enter manually 输入服务器 URL。您的显示名称对联系人可见。
  3. 您的身份。 应用在手机上生成您的身份密钥,并将私密部分存储在 iOS 钥匙串中,仅在本机首次解锁后可读。它会显示您公钥的简短预览,用于一眼认出密钥。
  4. 交换代码。 向联系人展示您的二维码,或扫描对方的二维码。也可以跳过,稍后再添加联系人。

连接后,应用会先检查中继的身份,再发布由您身份密钥签名的公钥,并附上与这条连接绑定的证明。每次重新连接后都会再次执行。

中继邀请会在您确认后立即固定服务器的身份。在”设置 → 连接 → Invite someone to this relay”中可以把邀请分享给他人:任何持有邀请的人都能连接到您的中继,但无法阅读消息。没有邀请时,应用会在首次连接后记住服务器的身份。如果身份在没有旧身份签名交接的情况下发生变化,应用会停止连接并提示您。

在连接设置中,您可以输入服务器运营者提供的身份(rk:1:…),并打开 Require a saved server identity,这样应用就不会信任首次连接。

在联系人列表中选择添加联系人,然后:

  • 扫描二维码: 扫描联系人的代码;或
  • 手动输入: 粘贴对方复制给您的联系人代码,或填写姓名、身份密钥和协商密钥。

通过对方的代码添加即表示接受对方并保存其密钥。rChat 不会在密钥不同的情况下与其通信:如果中继出示了其他密钥,该联系人会显示 Keys don’t match,直到您再次扫描对方的代码。

当你们双方都添加了对方,或一方接受了另一方的请求后,会话就会建立。

之后如需分享自己的代码,可在设置中打开,也可以将其复制为文本。

持有您的代码但尚未被您接受的人会出现在聊天列表中一个不显眼的 Requests 行里。他们无法看到您是否在线,在您接受之前也收不到您的任何内容。请求可以附带一条简短的第一条消息。

您可以接受、删除或屏蔽请求。之后联系人信息会显示密钥的来源:Keys from their code 或 Keys from their first message。对于通过请求联系您的人,请核对安全码,或当面扫描对方的代码。

联系人信息中有 Safety number 一行。点击 View 查看全部 60 位数字。请与联系人当面或通过电话逐组核对(不要通过 rChat 发送安全码来核对),然后点击 Mark as compared。

如需用二维码核对,在一部手机上点击 Show code,在另一部手机上点击 Scan their safety number。rChat 会替您比较,数字一致时提供 Mark as compared。

如果联系人的密钥日后发生变化,该标记会被移除。

输入框和聊天标题会告诉您当前状态:

标题输入框占位文字含义
EncryptedMessage已连接到中继,并与该联系人有会话。
Waiting for 姓名姓名 hasn’t connected yet. Messages will send when they do.已连接到中继,与该联系人的会话尚未建立。
Connecting to your relay…Connecting to your relay. Messages will queue.手机正在连接中继。
OfflineYou’re offline. Messages will send when you reconnect.没有连接到中继。

在任何状态下都可以发送。消息会保存在手机上,在连接和会话就绪后发出。

每条发出的消息会显示以下之一:Sending、Sent(中继已接收)、Delivered(已到达联系人的手机)、Read 或 Failed。送达和已读回执是端到端加密的,会稍晚一点、以小批量到达。

  • 文字、照片和最长 60 秒的语音消息,全部端到端加密,并填充到固定的大小档位。
  • 滑动消息即可回复。
  • 消息以加密形式存储在手机上,密钥保存在 iOS 钥匙串中。rChat 的数据库和媒体文件不会包含在设备备份中。
  • 收到的媒体在显示前会经过检查:过大的图片会被拒绝,其他图片会被重新编码;超过 5 分钟的语音消息会被拒绝;过长的文字会被截断。
  • 服务器。 修改服务器 URL 并选择 Save & Reconnect。
  • 身份。 显示您公钥的预览。
  • Rotate keys。 为您的账户生成新密钥,并用由当前密钥签名的通知告知联系人,使会话得以延续。每天可以轮换一次,您与所有人的安全码都会改变。rChat 每天最多向 90 个联系人送达新密钥。轮换无法找回被盗的账户:如果您的手机或密钥可能已被盗,请改用 Reset Identity。
  • Reset Identity。 从手机上删除您的身份、服务器设置和存储的数据。您将在没有联系人的情况下重新开始,联系人需要添加您的新代码。
  • Extra traffic protection(默认关闭)。在 rChat 打开时发送小的虚拟消息。它会消耗更多流量和电量,只能让您消息的时间特征稍难分辨,并且会让与您有打开会话的人看出 rChat 何时处于打开状态。
  • Incognito keyboard(默认关闭)。在聊天中关闭自动更正和输入建议。

应用还会在应用切换器中隐藏内容,在录屏或镜像时遮挡二维码和安全码,并使用系统键盘而不是第三方键盘。

一直显示 “Offline” 或 “Connecting to your relay…”

  • 检查服务器 URL,包括确切的 WebSocket 路径。路径错误时中继会返回伪装网站,应用无法连接。
  • 使用 wss://。
  • 如果中继刚以自动证书方式部署,请等待首张证书签发,并确认它不再处于测试环境。

“This server couldn’t prove its identity”

中继前面有东西在终止 TLS。运营者必须让中继自行终止 TLS(参见 TCP 前端部署)。

服务器身份已改变

中继在没有签名交接的情况下出示了不同的身份。在信任它之前,请先询问运营者。

某个联系人一直显示 “Waiting for 姓名”

  • 你们双方必须使用同一个中继。
  • 你们双方必须已互相接受:扫描了彼此的代码,或一方接受了另一方的请求。
  • 联系人的手机必须至少连接过一次,其密钥才会被发布。

应用在后台后消息延迟到达

iOS 会限制后台活动。应用回到前台时会重新连接,也会向 iOS 申请后台刷新时间,但何时执行由 iOS 自行决定。