私有化部署与安装方式 | 泡泡 IM 开发文档

三种方式运行同一套泡泡 IM 服务端，安装完成后进入相同的数据库与管理员向导。
如果要直接运行独立聊天应用，部署服务端后构建所购版本的客户端；如果已有网站或 App，可以复用现有账号并嵌入带 UI 的聊天 SDK。两种方式都需要部署 IM 服务端。客户端与 SDK 按所购版本交付，安装方式不改变版本范围。
MySQL 的 [mysqld] 必须设置 ngram_token_size=1、innodb_ft_enable_stopword=OFF 并重启。安装向导会检查分词长度。
即时消息、数据库、媒体文件和音视频服务可以部署在自己的服务器或内网。运行条件是客户端能访问 HTTP、WebSocket 和媒体地址，启用通话时还需能访问配套信令与中继；内网使用同样需要配置可解析的地址及客户端信任的 HTTPS / WSS 证书。离线时只能查看已有缓存，发送新消息与同步仍需要连接 IM 服务。
普通消息的实时接收与手机系统推送是不同链路。各端推送和来电支持范围并不相同，尤其 uni-app SDK 目前没有离线系统消息通知接入入口；以对应 SDK 平台说明为准。完全隔离外网前，应先确认业务是否需要这些能力，再按实际网络规划；本文的通话部署教程面向公网，内网需按实际拓扑调整信令、中继地址与网络策略。
全文以 example.com 为示例域名。正式上线请替换为自己的域名并配置 HTTPS；WebSocket 同样使用 WSS。局部预览时，可以在本机 hosts 文件中把域名指向服务器 IP。
基础 IM 公网入口为 SSH、HTTP / HTTPS，以及确有需要的宝塔面板端口。8787、6060、2060 和 Gateway 内部通信端口不需要直接暴露到公网。启用语音、视频通话时，还需按音视频服务部署开放中继入口与 UDP 媒体端口。