适用版本
本教程按青码即时通讯系统 V7.6.0 所有者完整源码结构整理，适合第一次使用宝塔部署的用户。
在线演示
H5 演示：https://gw.kcxugzs.cn/h5/
后台演示：https://gw.kcxugzs.cn/admin
后台账号：admin
后台密码：12345678
一、安装宝塔环境
- Linux 服务器安装宝塔面板。
- 软件商店安装 Nginx、PHP 8.2、MySQL 5.7、Redis。
- PHP 8.2 确认 pdo_mysql、mbstring、fileinfo、openssl、curl、json 等扩展。
- 如果实时服务启动需要
proc_open，请确认它没有被 PHP 禁用。
二、创建网站与数据库
- 先把正式域名解析到服务器。
- 宝塔添加站点，PHP 选择 8.2，同时创建数据库。
- 给站点申请 SSL 并开启 HTTPS。
- 记下数据库名、账号和密码。
三、上传源码
- 把 V7.6.0 服务端完整包上传到网站根目录并直接解压。
- 根目录应直接看到
app、admin、api、install、websocket、pc等目录。 - 确保
storage、uploads等运行目录可写。
四、运行自助安装
访问网站根地址，进入安装器后按页面顺序操作：
- 填写数据库。
- 填写站点名称、管理员与正式访问地址。
- 配置 WebSocket/实时服务。
- 填写商业授权码。
- 确认信息并执行安装。
安装完成后进入后台检查系统健康、授权、实时服务和推送状态。
五、配置实时通信
HTTPS 网站应使用 wss://。如果通过 Nginx 反向代理 WebSocket，需要正确转发 Upgrade/Connection 请求头，并保证同一实时端口只有一个服务进程。
六、HBuilderX 打包移动端/H5
- 在完整源码中找到 uni-app 客户端目录，用 HBuilderX 打开。
- 配置接口地址、WebSocket 地址、manifest.json 中的 AppID/包名/图标/权限。
- 需要 UniPush 2.0 时，在 DCloud 和厂商平台完成对应推送参数。
- H5 通过“发行 → 网站-H5手机版”生成。
- Android/iOS 通过“发行 → App 云打包”，正式运营使用自己的签名证书。
七、上线前测试
- 注册、登录、好友申请和通讯录红点。
- 单聊/群聊、文字、图片、文件、已读未读、撤回。
- 断网重连、跨设备同步、前后台切换。
- 在线/离线推送。
- 语音/视频通话与设备权限。
- 后台用户、群聊、举报、安全、版本和推送管理。
- 数据库备份、实时服务守护和日志轮转。