宝塔安装 | 泡泡 IM 开发文档

适用于已经使用宝塔管理服务器的环境。泡泡 IM 运行在 PHP CLI 常驻进程中，站点通过 Nginx 代理到该进程。
在宝塔“软件商店”中准备 Nginx、MySQL 8.0 或以上、PHP 8.3。PHP 8.1 及以上也可运行，完整要求见选择安装方式。
PHP 设置中安装或启用 pdo_mysql、mbstring、GD 的 JPEG / WebP、pcntl、posix、sockets。这里要检查实际运行的 CLI 配置，不能只看 PHP-FPM 的扩展列表。
Workerman 需要进程与信号函数。若在 PHP 禁用函数中存在 pcntl_fork、pcntl_signal、pcntl_wait、pcntl_alarm、posix_getpid、posix_kill、stream_socket_server 等，应从运行泡泡 IM 的 CLI 配置中移除。通话和媒体相关功能也需要 FFmpeg / FFprobe。
在“数据库”中创建 popoim，字符集使用 utf8mb4，记录专用用户名和随机密码。
进入 MySQL 配置，在 [mysqld] 段增加：
保存并重启 MySQL。安装向导检查 ngram_token_size，不满足时不能继续。
在“网站”中添加 example.com，源码目录使用 /www/wwwroot/example.com。不创建 FTP；使用已有数据库。PHP 版本可选“纯静态”，因为业务请求由独立的 CLI 进程处理。
上传并解压 popoim-web.zip，将其中 im-web/ 的内容放到站点目录，保证 start.php 与 public 直接位于其中，不要再嵌套一层 im-web。打开站点“网站目录”，将运行目录设置为 /public。
在终端安装依赖，确保 Composer 使用相同的 PHP 版本：
若面板环境没有 Composer，先配置 Composer 2 并确认 composer --version。安装生成的配置、运行目录和资源目录需要让项目运行用户 www 可写。
在宝塔终端执行，以第 3 步授权的 www 账号后台运行：
www 和 PHP 路径应与自己的宝塔环境一致；后续 reload、重启和停止也使用相同账号与 PHP。-d 让服务在关闭终端后继续运行，不会自动设置开机启动。若已经交给面板进程管理器维护，继续使用该管理器，启动命令保持前台 start，不要再另起一份后台服务。
打开站点“配置文件”，保留面板管理的日志与证书设置，删除把业务交给 PHP-FPM 的配置，使用如下路由。已有同名 location 先替换，不叠加两份：
保留站点对隐藏文件的拒绝规则。泡泡 IM 不需要 ThinkPHP 等框架的伪静态规则，选择“无”，由上面的 try_files 转给服务端。
在宝塔“SSL”中为实际域名配置有效证书，验证配置后重载 Nginx。访问 /install，按完成安装填写数据库和管理员。
安装后检查 wss://example.com/ws。基础 IM 的公网入口为 HTTP / HTTPS；PHP HTTP 端口和 Gateway / Register 内部端口不需要对外开放。启用语音、视频通话时，继续按音视频服务部署开放中继端口并配置配套服务。