Element · 基于 Matrix 的去中心化聊天 Web / 桌面客户端｜自托管部署与使用全指南
项目仓库： https://github.com/vector-im/element-web
多许可：AGPLv3 / GPLv3 / 商业许可三选一 · 技术栈：基于 Matrix JS SDK 的 Web 客户端 · 托管版：app.element.io · 自托管文档：docs/install.md · 移动端：element-x-android / element-x-ios
1 项目简介
Element（曾用名 Vector、Riot）是一个基于 Matrix 协议的 Web 与桌面客户端，用 Matrix JS SDK 构建。它是去中心化聊天的前端：你可以连接任意 Matrix homeserver，与其他 Matrix 用户（包括其他客户端）端到端加密互通。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Element（element-web） |
| 仓库地址 | github.com/vector-im/element-web |
| 项目定位 | 基于 Matrix 的去中心化聊天 Web / 桌面客户端 |
| 许可 | AGPLv3 / GPLv3 / Element 商业许可三选一 |
| 技术栈 | Matrix JS SDK |
| 托管版 | app.element.io |
| 开发版 | develop.element.io |
| 桌面端 | Electron 包装 |
| 移动端 | element-x-android / element-x-ios |
1.2 适用场景
- 想使用去中心化、端到端加密聊天，而不被单一厂商锁定。
- 自托管 Matrix homeserver 后，用 Element Web 作为前端访问。
- 作为桌面 / 移动客户端连接到你选择的 Matrix 服务器。
1.3 能力边界（官方口径）
- 支持分级：Supported（Chrome/Firefox/Edge 最近两个大版本、Safari 最近两版、官方桌面端）；Best effort（Firefox ESR、Chrome/Edge Extended Stable）；Community Supported（移动端 Web）；其余不支持。
- Element 是客户端；完整聊天还需要一个 Matrix homeserver（如 Synapse）。
2 功能特性
- Matrix 去中心化：基于开放标准 Matrix，端到端加密。
- 多端：Web（app.element.io）、桌面（Electron）、移动（element-x）。
- 可自托管 Web 前端：见 docs/install.md。
- Monorepo：仓库同时托管 Element Web 及相关项目。
- 多许可：可在 AGPLv3、GPLv3 或商业许可间选择。
3 官方界面预览
Element Web 前台为房间列表 + 消息流界面，支持加密房间、表情包、线程、语音视频（Element Call）。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 托管版 | https://app.element.io | 在线即用 |
| 开发版 | https://develop.element.io | 最新开发版 |
| 仓库主页 | https://github.com/vector-im/element-web | 源码 |
| 安装文档 | docs/install.md | 自托管 Element Web |
| 桌面端 | element.io/get-started | 桌面应用下载 |
| 桌面构建 | apps/desktop | 自构建 |
| 配置文档 | docs/config.md | 客户端配置 |
| 移动端 | element-x-android / element-x-ios | 原生移动 App |
| 许可联系 | licensing@element.io | 商业许可 |
5 前置要求与服务器配置
5.1 软件前提
- 自托管 Element Web 前端：一个静态 Web 服务器（按 docs/install.md）。
- 完整聊天需要 Matrix homeserver（如 Synapse）；Element 只是客户端前端。
5.2 硬件建议
- 静态前端资源占用极低；homeserver 的资源需求按 Matrix 官方文档规划。
5.3 端口与资源
- Web 前端 80/443；homeserver 端口按 Matrix 服务配置。
6 方式一：直接用托管版（最快体验）
直接访问 app.element.io 注册 / 登录任意 Matrix 账号即可使用。
7 方式二：自托管 Element Web 前端
按 docs/install.md 把构建产物部署到静态 Web 服务器；桌面端按 apps/desktop 文档自构建。
8 配置项说明
- 客户端配置见 docs/config.md，可覆盖默认 homeserver 等设置。
9 常用运维命令
- 升级：按官方发布更新构建产物。
- 桌面端：从 element.io/get-started 下载更新。
10 常见故障排查
- 按支持分级确认浏览器在 Supported 范围内；查 Matrix 社区与仓库 Issues。
11 风险与合规说明
- 许可证：多许可（AGPLv3 / GPLv3 / 商业许可）；商用联系 licensing@element.io。
- 架构边界：Element 是客户端；homeserver 需另行部署与运维。
- 本文整理自官方 README，命令与配置以官方文档最新说明为准；不包含 star 数等动态数据。