已经有 Matrix 账号，却不想被某个客户端的界面绑住，Cinny 的 Matrix聊天提供了一个思路：浏览器打开就能聊，界面简洁现代，想自己托管也可以用静态文件或容器部署。它本身不带后端服务，聊天的账号与消息仍然走你自己的 Matrix 服务器。
本篇先讲清楚 Cinny 是什么、不是什么，再给出在线使用与自托管两条路的版本选择、部署步骤和必改配置，最后列出部署时最容易踩的坑。下载与源码入口在文末的官方仓库链接，本文不提供任何网盘链接。
项目信息
| 项目 | 说明 |
|---|---|
| 软件名 | Cinny |
| 定位 | 面向 Matrix 的现代化 Web 客户端 |
| 开发语言 | TypeScript，据仓库说明为浏览器应用 |
| 使用方式 | 在线 Web 应用、自托管静态部署、容器部署、独立桌面端仓库 |
| 配置入口 | config.json：默认 homeserver 与探索页面 |
| 使用前提 | 需要一个可用的 Matrix 服务器地址与账号 |
| 获取方式 | GitHub 仓库与容器镜像，见仓库说明 |
Matrix聊天先分清：客户端、服务器与部署是三件事
很多人第一次接触 Matrix 会把三件事混在一起：账号与消息存在服务器上，聊天界面是客户端，客户端跑在哪里是部署。Cinny 只解决中间那件：给你一个现代化的聊天前端。它不自带服务器，也不替你注册账号，部署之前要先确认服务器地址、账号和登录方式都已就绪。
适合的人群是：已有 Matrix 服务器的个人用户与团队、想给成员提供一个浏览器聊天入口的运维人员、以及希望把聊天前端放到自己域名或子目录下的开发者。还没有服务器、只想下载一个应用注册即聊的人，Cinny 不是一步到位的选择，要先解决服务器这一步。
版本选择：先用在线版验证，再决定是否自托管
结论先行：第一次接触先用在线 Web 应用验证登录与消息流程，确认界面和服务器都合用，再考虑自托管；已经确定要长期自用、且有 Web 服务器或容器环境的团队，可以直接走自托管。
| 版本来源 | 适合谁 | 注意点 |
|---|---|---|
| 在线 Web 应用 | 只想先试界面与登录的人 | 不用部署，但聊天前端不在自己手里 |
| 自托管静态文件 | 有 Web 服务器、想放在自己域名下的人 | 要配好静态资源重定向，见下文 |
| 容器镜像部署 | 已有容器环境的团队与运维人员 | 固定镜像版本，升级前先在独立环境验证 |
| 独立桌面端 | 偏好桌面应用、不想开浏览器的人 | 以独立桌面端仓库的说明为准 |
安装与部署步骤：两条路按需选一条
- 在线使用：打开 Cinny 的在线 Web 应用，输入自己的服务器地址与账号登录，先验证消息收发正常，再决定是否长期用这条路。
- 自托管静态部署：下载仓库发布的 tarball，解压得到 dist 目录，用自己的 Web 服务器对外提供这些静态文件。
- 自托管容器部署：按仓库说明拉取对应的容器镜像并运行，固定所用镜像版本，不要用浮动标签长期跑生产入口。
- 部署完成后先做三项验证：登录流程、消息收发、页面刷新与直接访问子路径，全部通过再交给成员使用。
- 需要放在子目录时，先按仓库说明修改构建配置中的 base 路径并重新构建，不要只改反向代理就上线，路径不对会导致静态资源找不到。
Matrix聊天装完必改设置：三项配置
- 默认服务器地址：在 config.json 里把默认 homeserver 改成自己的服务器地址。改对了，成员打开页面不用每次手动填服务器；改错了，登录第一步就会卡住，体感差别就是能不能一打开就用。
- 探索页面配置：在 config.json 里核对探索页面的配置，确认公开房间与发现入口指向你想让成员看到的范围。团队内部使用时，这一步决定了成员第一眼看到的是自家房间还是默认推荐。
- 路由与重定向规则：在 Web 服务器里按仓库说明配好静态资源重定向，或者改用 hash routing 减少路由配置。这一项不配好时，首页能打开、刷新或直接访问子路径却会报错，是自托管最常见的坑。
注意事项：这四条部署前要先知道
- 没有服务器就聊不起来：Cinny 不内置服务器与后端消息服务，部署一个前端不等于有了聊天服务，服务器、账号与网络可达性要先于前端准备好。
- 底层实现正在换：据仓库说明，项目正在以自有软件开发包替换原有的 Matrix 软件开发包，升级时要重点看文档与变更说明，别假设旧版行为原样保留。
- 贡献通道有限制：据仓库说明，在软件开发包替换期间暂不接受新的拉取请求，想深度二次开发或提代码贡献的人，要先确认当前阶段的贡献规则。
- 许可影响分发与修改：据仓库说明，项目采用 AGPL-3.0-only 许可，对外分发或提供修改版本前，先核对该许可对源码公开与分发的要求。
适用人群与同类做法对比
与只能装在某一台设备上的聊天客户端相比，Cinny 的优势是浏览器即开即用、部署方式灵活，静态文件与容器两条路都能走；劣势是它对部署者的要求更高，路由、重定向、子目录路径都要自己配对。结论是：已有服务器、重视界面、希望前端掌握在自己手里时选 Cinny；只想注册即聊、不想碰服务器与部署配置时，先解决服务器或选带完整服务的方案，别只装一个前端。
下载与源码请前往 Cinny 的 GitHub 仓库查看，仓库地址以本站记录的 GitHub 链接为准。获取下载链，回复 cinny。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
