选择安装方式

三种方式运行同一套泡泡 IM 服务端，安装完成后进入相同的数据库与管理员向导。

方式	适合谁	环境由谁管理
普通安装	熟悉 Linux，希望直接管理服务	系统软件包、Nginx 与 systemd
宝塔安装	已使用宝塔管理站点和数据库	宝塔面板
Docker 安装	希望隔离运行环境、方便迁移	Docker Compose

环境要求

• Linux 服务器；普通安装示例采用 Ubuntu 24.04。
• PHP 8.1 或以上，建议使用 PHP 8.3 CLI。
• MySQL 5.7.8 或以上；新部署建议 MySQL 8.0 / 8.4。使用原生 JSON 和 ngram 全文索引，不用 MariaDB 替代。
• Composer 2、Nginx；媒体处理需要 FFmpeg 与 FFprobe。
• PHP 扩展：pdo_mysql、mbstring、gd（含 JPEG / WebP）、pcntl、posix、sockets；Linux 下不得禁用 Workerman 使用的进程与信号函数。

MySQL 的 [mysqld] 必须设置 ngram_token_size=1、innodb_ft_enable_stopword=OFF 并重启。安装向导会检查分词长度。

访问地址

全文以 example.com 为示例域名。正式上线请替换为自己的域名并配置 HTTPS；WebSocket 同样使用 WSS。局部预览时，可以在本机 hosts 文件中把域名指向服务器 IP。

公网仅开放 SSH、HTTP / HTTPS，以及确有需要的宝塔面板端口。8787、6060、2060 和 Gateway 内部通信端口不需要直接暴露到公网。