Setup Guide

安装聊天工具
连我们自己的服务器

我们用 Element(一个成熟的开源聊天 App)连接团队自建的服务器收发消息。按下面 iPhone / Mac 步骤装好、填对服务器地址即可。

服务器地址 · Homeserver
https://im.myhkserver88.shop
🔑 领取我的账号密码

你要装的是什么

Element = 聊天软件(像 Telegram),装一次就在你设备本地运行。它连的是我们自己的服务器,不是公共服务器——所以登录时一定要先把服务器地址改成我们的,这是最容易漏、最关键的一步。

✓
连对服务器的标志:登录进去后,你的用户名结尾是 @你的账号:im.myhkserver88.shop(域名是我们的),不是 :matrix.org。

账号密码点右上角「领取我的账号密码」自助获取(凭管理员给的口令解锁),或直接找管理员要。

iPhone 安装

App Store 下载 → 改服务器 → 登录。

1
打开 App Store,搜索 Element
找到「Element Messenger」(图标是深色,New Vector / Element 出品),下载安装。
2
打开 App,点「Sign in / 登录」
不要点注册。进入登录页。
3
先改服务器地址
⚠ 最关键的一步
登录页会显示 matrix.org,点它旁边的 Edit / 编辑,改成我们的:
https://im.myhkserver88.shop → 确认。
4
填账号密码登录
用管理员给你的用户名 + 密码登录。改对服务器后,登录框是简单的用户名/密码,不会出现「用 Google / Apple 继续」。
5
完成
进入聊天界面即成功。可在 iPhone 设置里给它开通知,消息到手机。
如果它跳到「以 Google / Apple 继续」或网址栏是 account.matrix.org:说明服务器没改成功,你连的是公共服务器。退出重来,务必在第 3 步把 homeserver 改成 im.myhkserver88.shop。

Mac 安装

两种方式二选一:桌面 App(推荐,本地运行更快)或网页版。

A
桌面 App(推荐)
浏览器打开 element.io → Download → 下载 macOS 版,装好打开。
B
网页版(免安装)
浏览器直接开 https://app.element.io(在国内可能需挂代理才能打开这个网页,打开后连我们服务器就快了)。
3
点「Sign in」→ 先改服务器
⚠ 同 iPhone · 最关键
把 homeserver 从 matrix.org 改成 https://im.myhkserver88.shop。
4
填账号密码登录
用管理员给的账号密码。同一账号 iPhone 和 Mac 都能登,消息自动同步。
✓
iPhone 和 Mac 用同一个账号,两边消息实时同步,随便在哪台回都行。

常见问题

Q怎么确认我连对了我们自己的服务器?
点左上角头像看用户名,结尾是 :im.myhkserver88.shop 就对了;如果是 :matrix.org 就是连错了,退出重登、改服务器。
Q登录报「Can't connect / 无法连接」?
检查服务器地址有没有填错:必须是 https://im.myhkserver88.shop(有 https、无端口、结尾不带斜杠)。
Q提示用户名或密码错误?
用户名只填账号本身(不用加 @ 和域名);密码区分大小写。仍不行找管理员核对,或用「领取我的账号密码」重新确认。
Q网页版 app.element.io 打不开 / 很慢?
这个网页托管在境外,打开它本身可能要挂代理;打开后连我们服务器是直连、很快。嫌麻烦就用 iPhone / Mac 的 App。
Q进去是空的,没有聊天?
正常——等对应的会话接进来就会出现;有邀请就点接受。群会自动出现(见「详细教程」)。

它能做什么

这套中继把通盛的收发桥接到 Element。下表是完整能力与当前状态,触发方式尽量用 Element 原生手势。

通盛 App→连接器→Matrix 服务器→Element
收发文本消息
已上线
在会话里直接打字收发。
被拉进群 → 自动显示
开发中
在通盛被拉进任何群,Element 自动冒出对应房间,无需群里先有人说话。
发图片 / 文件
规划中
会话里直接发图 / 发文件 → 转成通盛媒体消息。
发链接
规划中
发带网址的文本即可,通盛端自动出链接卡片。
建群
规划中
在 Element 新建房间并邀请桥机器人 → 建一个通盛群。
群内拉人
规划中
在群房间里「邀请成员」→ 把对方拉进通盛群。
按群号进群
规划中
在控制台房发群号 → 预览群信息 → 点 ✅ 确认加入。
扫码截图进群
规划中
把群二维码截图拖进控制台房 → 识别群 → 点 ✅ 确认加入。
收图片 / 文件(内联显示)
规划中
群 / 私聊里别人发的图片、文件,在 Element 里内联显示。

排查 / 日志

出问题时,一处看到日志、所有消息、以及每条消息转发了什么:

所有消息
已上线
Element 本身——你就在每个房间里,可直接翻 / 搜。
容器 / 连接器日志 + 转发审计
规划中
Dozzle + frontail:浏览器里 tail 日志;每条消息一行审计(收 / 发 · 哪个群 · 谁 · 桥到哪个房 · 转发结果)。