Tinode 0.25.3 介绍与选型指南

目标：面向「自托管即时消息服务端」选型场景，梳理 Tinode 的项目定位、核心架构、功能边界与生态现状，并与 SimpleX Chat、Mattermost、Rocket.Chat、Movim 四个同类项目做量化对比，帮助读者在动手部署之前快速判断是否适用。本文为认知与选型篇，全部数据均来自官方渠道联网溯源（检索日期 2026-10-26），不包含本地实测数据。

一、环境信息

本文是 A1 认知篇，写作过程只做联网取证、不做本地部署实验，因此本节给出的是「信息来源清单」而非软硬件环境，所有关键数据都可按下列出处复核：

• 版本取证：GitHub Releases Atom 流 https://github.com/tinode/chat/releases.atom（检索日期 2026-10-26）。最新稳定版为 v0.25.3，发布时间 2026-07-04T14:48:44Z。
• 热度与许可证取证：GitHub 仓库页 https://github.com/tinode/chat（检索日期 2026-10-26），星数 13.5k，GitHub 识别的许可证为 GPL-3.0。
• 功能与架构取证：随 v0.25.3 发布的官方 README.md、INSTALL.md 与 server/tinode.conf（GitHub 仓库，检索日期 2026-10-26），下文涉及默认端口、数据库版本要求、功能清单的内容均出自这三个文件。
• 竞品取证：SimpleX Chat（simplex-chat/simplex-chat）、Mattermost（mattermost/mattermost-server）、Rocket.Chat（RocketChat/Rocket.Chat）、Movim（movim/movim）四个项目的 GitHub 仓库页与 releases.atom（检索日期均为 2026-10-26）。

💡 说明：官方在 README.md 开头对自身成熟度的定性原话是「beta-quality software: feature-complete and stable」（beta 质量的软件：功能完整且稳定，但可能仍有少量缺陷）。选型时应把这句自我定位与本文第七章的版本节奏数据放在一起解读：它意味着核心功能可用、API 形态稳定，但也意味着不要期望企业级商业支持的开箱即用体验。

二、软件概述

2.1 项目定位

Tinode 是一个用 Go 语言编写的即时消息服务端，配套提供 Android（Java）、iOS（Swift）、Web（ReactJS）三端官方客户端，以及基于 gRPC 的多语言客户端绑定（C++、C#、Go、Java、Node、PHP、Python、Ruby、Objective-C 等）。传输层采用「JSON over WebSocket（也支持长轮询）」或「Protobuf over gRPC」（来源：README.md 首段，检索日期 2026-10-26）。

项目自述的目标非常明确：兑现 XMPP 当年未能兑现的「联邦即时消息」愿景，做一个现代的、面向移动通信的开放 IM 平台。README 中有两句定位原话值得在选型时反复品味：

• 「Tinode is not XMPP/Jabber. It is not compatible with XMPP. It's meant as a replacement for XMPP.」（Tinode 不是 XMPP，也不兼容 XMPP，它的定位是 XMPP 的替代品。）
• 「An explicit NON-goal: we are not building yet another Slack replacement.」（明确的非目标：我们不做又一个 Slack 替代品。）

这两句话划出了 Tinode 与后文对比对象（尤其是 Mattermost 与 Rocket.Chat）的本质差异：Tinode 做的是即时消息基础设施（类似 WhatsApp/Telegram 的开源底座），而不是团队协作工作区（频道、话题、集成市场那一套）。许可证方面，服务端为 GPL-3.0，各官方客户端为 Apache-2.0（来源：README.md 与仓库 LICENSE 文件，检索日期 2026-10-26）——这意味着对服务端做二次开发并对外分发的场景需要遵守 GPL 义务，商业选型时应请法务确认。

💡 技术拓展：自托管 IM 服务端的协议生态不止 Tinode 的「自有协议」一条路线，常见选择对比如下——

协议路线	代表实现	特点	适用场景
自有协议	Tinode、SimpleX Chat	协议为产品量身定制，客户端 API 一致性好，但没有第三方生态	自建闭环 IM、给自有产品嵌入消息能力
XMPP	ejabberd、Prosody（服务端），Movim（前端）	历史悠久的联邦标准，服务器间可互连，生态碎片化	需要跨域联邦、接入既有 XMPP 网络
Matrix	Synapse、Dendrite	现代联邦协议，支持桥接其他网络	去中心化协作、跨网络互通
团队协作 API	Mattermost、Rocket.Chat	REST/WebSocket 驱动，围绕频道与集成生态	企业内部协作平台

Tinode 选择自有协议路线，换取了三传输端点（WebSocket/长轮询/gRPC）与统一 JSON 数据模型；本文后续架构分析均基于这一选择。

2.2 版本与发布节奏

依据 releases.atom（检索日期 2026-10-26），Tinode 近期版本线如下：

从节奏看，稳定版大约每 1～4 个月出一个 patch（v0.24.7 → v0.25.0 间隔约 7 周，v0.25.2 → v0.25.3 间隔 4 个月），主线大版本（0.24 → 0.25 → 0.26）按季度级推进。服务端源码对客户端协议版本有最低要求：会话握手时校验客户端版本号不低于 0.20（来源：v0.25.3 源码 server/session.go 的 checkVers 逻辑，检索日期 2026-10-26），这为老客户端留出了兼容窗口。发布附件按数据库拆分（tinode-alldbs/mysql/postgres/mongodb/rethinkdb.linux-amd64.tar.gz），另附 tn-cli.tar.gz 管理命令行与 py-chatbot.tar.gz 聊天机器人示例（来源：GitHub Releases 页附件清单，检索日期 2026-10-26）。

三、核心架构

3.1 总体形态与传输层

Tinode 服务端是单个 Go 进程：对客户端暴露三种传输端点，对后端通过存储适配器访问数据库，对扩展通过插件与推送处理器挂接（来源：README.md「Features」与 tinode.conf，检索日期 2026-10-26）。默认监听端口有两个：6060 承载 HTTP/WebSocket/长轮询与 Web 静态资源，16060 承载 gRPC（来源：server/tinode.conf 中 listen 与 grpc_listen 默认值）。

💡 技术拓展：三种传输端点的定位与取舍——

传输方式	载荷格式	特点	典型场景
WebSocket	JSON 文本帧	全双工长连接，实时性最好，服务端可主动推送	浏览器/移动端在线聊天
HTTP 长轮询	JSON	无需 WebSocket 基础设施，兼容性最好，实时性弱于 WS	受限网络、简单脚本接入
gRPC	Protobuf 二进制	强类型、多语言代码生成，性能好	服务端集成、聊天机器人、非 JS 客户端

Tinode 三者同时内置、共享同一套会话与业务逻辑；本文后续篇章的接口演示以 WebSocket 与长轮询为主。

3.2 存储层：适配器模式

存储层采用适配器（adapter）抽象，官方内置四个适配器，版本要求如下（来源：INSTALL.md，检索日期 2026-10-26）：

💡 技术拓展：「存储适配器」是服务端软件常见的可插拔设计——业务层只依赖接口，具体落库由适配器实现。同类方案对比：直接绑单一数据库（如 Rocket.Chat 绑 MongoDB）实现简单、优化充分，但迁移成本高；多适配器（Tinode、Mattermost 支持 PostgreSQL/MySQL 双库）部署灵活，但各适配器的成熟度会有差异。Tinode 官方推荐 MySQL 8.x（-tags mysql 构建与发行包最常用），本专栏后续篇章的实测也基于 MySQL 8 后端。

3.3 大文件、推送与扩展机制

• 大文件传输：消息正文上限默认 128KB（tinode.conf 的 max_message_size: 131072），图片、文档等大对象走「带外（out of band）」通道，落本地文件系统或 Amazon S3，其他对象存储可通过实现 media handler 接口扩展（来源：README.md「Features」与 tinode.conf 注释，检索日期 2026-10-26）。
• 推送通知：服务端支持配置推送处理器（push handlers），官方文档以 Google FCM 为例说明配置方法（来源：INSTALL.md「Enabling Push Notifications」指向的官方 FAQ）。
• 插件与认证：支持自定义认证后端（authentication backends）、服务端插件扩展（如内容审核、聊天机器人挂接），并内置脚本化的管理命令行 tn-cli（来源：README.md「Administration」小节）。

3.4 集群能力

Tinode 支持分片集群（sharded clustering）与故障转移（failover）：集群至少两个节点，官方建议三个起步；failover 配置由心跳（heartbeat）、选举阈值（vote_after）与节点失联阈值（node_fail_after）三个参数控制，官方标注该特性为 experimental（实验性）（来源：INSTALL.md「Running a Cluster」，检索日期 2026-10-26）。集群节点间通信端口独立于客户端端口，无需对外暴露。

四、功能特性

以下功能清单整理自官方 README.md「Features/Supported」（检索日期 2026-10-26），是 v0.25.3 时点已实现的能力：

4.1 用户端功能

• 点对点（一对一）与群组消息；频道（channels）支持无限量只读订阅者。
• 音视频通话与语音消息（WebRTC，需自备 ICE TURN/STUN 服务器，见 6.2 节）。
• 全端多设备同步：所有会话在登录设备间保持一致。
• 细粒度访问控制：按动作（读取、写入、分享、删除等）授权。
• 用户搜索与发现：基于标签（tags），支持 email:、tel: 等前缀检索。
• Markdown 风格富文本：*样式* 转粗斜体，支持内联图片、视频与文件附件。
• 表单与模板回复（面向聊天机器人的交互形态）。
• 消息状态通知：送达、已收、已读与「正在输入」。
• 转发、回复、编辑已发送消息；会话与消息置顶；聊天壁纸自定义；亮/暗/跟随系统三套主题。
• 账户标记体系：verified/staff/untrusted 标识；支持匿名用户（官方特别注明适用于客服聊天场景）。
• 备忘自聊（notes to self）与消息收藏。

4.2 管理与运营功能

• 管理命令行 tn-cli：可脚本化的服务端管理（建号、订阅、发消息、搜索等）。
• 服务端屏蔽（block unwanted communication server-side）与细粒度权限体系。
• 自定义认证后端接入；插件机制扩展审核/机器人能力。
• 分片集群与故障转移（见 3.4 节）。

4.3 国际化

官方翻译矩阵中，简体与繁体中文在服务端、Web、Android、iOS 四端全部就绪，另有俄语、西语、乌克兰语等十余种语言全端或部分覆盖（来源：README.md「Translations」表格，检索日期 2026-10-26）。对中文团队而言，Tinode 是自托管 IM 里中文化完成度较高的一个。

五、快速开始（官方最小路径）

本节内容为官方 INSTALL.md（v0.25.3）给出的最小安装路径，仅供选型阶段预估上手成本；完整的逐命令实测安装流程见本专栏安装指南篇。

官方二进制路径共五步（来源：INSTALL.md「Installing from Binaries」，检索日期 2026-10-26）：

1. 到 Releases 页下载与你所用数据库匹配的发行包（如 MySQL 后端选 tinode-mysql.linux-amd64.tar.gz），解压到任意目录；
2. 确认数据库已启动并接受本机连接——MySQL 默认尝试以无密码 root 连接本机库，PostgreSQL 默认尝试 postgres/postgres，生产环境应在 tinode.conf 的对应 dsn 中改掉默认凭据；
3. 运行数据库初始化器（仅首次需要）：

./init-db -data=data.json

4. 启动服务端（无参数即可按 tinode.conf 默认值运行）：

./tinode

5. 浏览器访问 http://localhost:6060/ 验证安装——发行包内置了构建好的 Web 客户端静态资源，无需单独部署前端。

官方还提供在线试用环境：公网服务 https://web.tinode.co/ 与每晚重置数据的沙箱 https://sandbox.tinode.co/（沙箱演示账号 alice/bob 等，密码为「用户名+123」，验证码可用 123456，来源：README.md「Demo/Sandbox」，检索日期 2026-10-26）。想在不落地的条件下先体验产品形态，用沙箱最快。

六、适用场景与限制

6.1 适用场景

结合官方定位与能力清单，Tinode 适合以下场景：

• 给自有产品/内部系统做消息底座：三协议接入 + gRPC 多语言绑定 + 统一 JSON 数据模型，适合在其上自研客户端或嵌入现有应用；
• 替代 XMPP 的新一代自托管 IM：想要 WhatsApp 式的现代聊天体验（多端同步、已读回执、音视频通话、频道）而非团队协作工作区；
• 中文团队自托管 IM：简繁中文全端就绪，发行包一键起服务；
• 需要细粒度权限与匿名客服场景：服务端权限体系与匿名会话是官方明确支持的能力。

6.2 已知限制

以下限制均有官方出处，选型前应逐条对照自身需求：

• 无端到端加密：README「Planned」清单明确列有端到端加密（E2E，一对一拟采用 OTR），v0.25.3 尚未实现；消息在服务端是明文可读的。这是与 SimpleX Chat 最本质的能力差距。
• 无联邦：跨服务器互连（Federation）在「Planned」清单中，当前版本不能与其他 Tinode 服务器互通，也与 XMPP/Matrix 网络不通。
• 无消息全文搜索：同样在「Planned」清单中，目前检索能力限于用户/群组的标签发现。
• 音视频通话需自备 ICE 服务器：官方明确「Tinode does not provide ICE servers out of the box」，必须在 tinode.conf 的 webrtc 段配置 TURN/STUN，否则通话不可用（来源：INSTALL.md「Enabling Video Calls」）。
• GPL-3.0 服务端许可：二次开发对外分发需遵守 GPL 义务（客户端 Apache-2.0 不受此限）。
• RethinkDB 后端将于 2027 年停止支持：新部署不应再选它。

七、同类选型对比

7.1 量化对比

五个项目的热度、版本与许可证数据如下（检索日期均为 2026-10-26，来源为各自 GitHub 仓库页与 releases.atom）：

能力矩阵对比（依据各自官方文档与仓库说明，检索日期 2026-10-26）：

关键差异解读：五者中只有 SimpleX Chat 把端到端加密作为默认且唯一形态，也只有 Movim 天然具备跨域联邦。Tinode 的差异化在「可编程性」——三协议 + 多语言绑定 + 可插拔存储与认证，是五个项目中最像「IM 中间件」的一个；Mattermost 与 Rocket.Chat 星数虽高，但它们解决的是「团队协作工作区」问题，与 Tinode 并不完全同赛道。

7.2 选型建议

按需求对号入座（「如果…则…」）：

• 如果要给自有产品或内部系统嵌入消息能力（自研客户端、服务端间集成、聊天机器人），选 Tinode：gRPC/JSON 双协议与多语言绑定让接入成本最低，GPL 义务仅约束服务端二次分发。
• 如果隐私与匿名是硬性要求（无手机号/邮箱等全局标识、默认 E2E），选 SimpleX Chat：Tinode 当前没有端到端加密，不满足此类需求。
• 如果目标是替代 Slack/Teams 的团队协作平台（频道、话题、集成市场、审批流），选 Mattermost（更工程化、Go 栈易运维）或 Rocket.Chat（全渠道客服与插件市场更强）——它们不是 Tinode 的替代品，Tinode 官方也明确把「Slack 替代」列为非目标。
• 如果已有 XMPP 基础设施（ejabberd/Prosody），想补一个现代化 Web 前端与门户，选 Movim。
• 从维护活跃度看，五者在 2026-10 时点均处于活跃发布状态：Mattermost/Rocket.Chat/Movim 保持周级到双周级的 patch 节奏，SimpleX Chat 主线推进激进（稳定版之外持续出 beta），Tinode 最慢（约季度级）但版本线清晰、协议向下兼容窗口明确（客户端最低 0.20）。

八、参考链接

• Tinode GitHub 仓库：https://github.com/tinode/chat
• Releases（v0.25.3 及附件下载）：https://github.com/tinode/chat/releases
• 官方安装文档 INSTALL.md：https://github.com/tinode/chat/blob/master/INSTALL.md
• API 协议文档：https://github.com/tinode/chat/blob/master/docs/API.md
• 项目官网与商业支持：https://tinode.co/
• 公网体验服务：https://web.tinode.co/ ；沙箱：https://sandbox.tinode.co/
• 官方客户端仓库：Web https://github.com/tinode/webapp 、Android https://github.com/tinode/tindroid 、iOS https://github.com/tinode/ios
• 服务端许可证（GPL-3.0）：https://github.com/tinode/chat/blob/master/LICENSE
• 竞品仓库：SimpleX Chat https://github.com/simplex-chat/simplex-chat 、Mattermost https://github.com/mattermost/mattermost-server 、Rocket.Chat https://github.com/RocketChat/Rocket.Chat 、Movim https://github.com/movim/movim

说明：本专栏其余三篇（Ubuntu 22.04 安装指南、配置参数详解、常用 CLI 命令详解）基于同一版本 v0.25.3 的实测展开，可在专栏目录中按序阅读。