青码即时通讯系统 V6.9.2 安装与客户端打包指南

一、取得产品授权与下载源码

1. 打开青码科技官网商城，在对应产品的专属购买页面查看客服联系方式。
2. 与客服确认授权期限、绑定目标、交付范围和售后内容。
3. 取得授权码后进入下载中心，选择“青码即时通讯系统 V6.9.2”，输入授权码验证并下载源码。

二、准备服务器与宝塔环境

购买 Linux 服务器并安装宝塔面板。建议使用全新服务器，避免端口、旧数据库或旧守护进程影响安装。

PHP 8.2 扩展

在宝塔“PHP 8.2 → 安装扩展”中确认以下扩展可用：

• pdo_mysql、mbstring、fileinfo
• openssl、curl、json
• sodium、zip
• Redis 扩展（启用 Redis 功能时）

允许 proc_open

进入“PHP 8.2 → 禁用函数”，如果列表中存在 proc_open，将它从禁用列表移除；列表中没有则无需处理。实时服务控制器需要使用该函数启动后台进程。

三、创建网站与上传源码

1. 先在域名服务商处把域名解析到服务器公网 IP。
2. 在宝塔“网站”中添加站点，把示例域名替换为自己的域名。
3. PHP 版本选择 8.2，数据库选择 MySQL 5.7，并记录数据库名称、用户名和密码。
4. 把下载的源码 ZIP 上传到网站根目录并直接解压。

解压后，网站根目录应直接看到 app、api、admin、install、websocket、uniapp 等目录，不能再套一层项目文件夹。

四、执行网页自助安装

在浏览器打开已经解析的域名，系统会自动进入安装向导。

环境检测未通过

按照页面左侧提示处理缺失项目。如果提示存储目录不存在，在源码根目录创建页面要求的目录，再返回安装器重新检测。

填写数据库配置

填写宝塔创建网站时生成的数据库名称、数据库用户名和数据库密码。数据库主机通常为 127.0.0.1 或 localhost，以安装器提示为准。

填写站点和实时服务配置

按照向导填写站点名称、管理账号、正式域名和 WebSocket 地址。使用 HTTPS 时，客户端实时地址应使用 wss://。默认实时端口为 2346，修改后需要同步调整宝塔反向代理和防火墙。

五、进入管理后台并检查服务

点击“进入管理后台”，使用安装时创建的管理员账号登录。进入后台后重点检查：

• 系统健康检查是否全部通过。
• 数据库结构版本是否与程序版本一致。
• 实时服务是否运行，2346 端口是否只存在一个监听进程。
• 授权状态是否正常，授权绑定目标是否与正式域名一致。
• 推送队列、错误中心和安全事件是否存在红色异常。

六、部署 uni-app 客户端

在源码包中找到 uniapp 文件夹，复制到电脑本地。下载并安装 HBuilderX，然后导入该目录。

HBuilderX 官方下载地址：https://www.dcloud.io/hbuilderx.html

配置应用信息

打开项目的 manifest.json，按实际业务设置应用名称、应用图标、Android 包名、iOS Bundle ID、权限和推送能力。截图中的信息只作为操作位置示例。

统计功能可根据实际需要开启或关闭。

云端打包 Android App

在 HBuilderX 菜单中选择“发行 → App-Android/iOS-云打包”，进入打包配置页面。

选择 Android，配置正式包名和签名证书。正式运营必须使用自己长期保存的签名证书；广告能力没有接入时不要勾选。确认后点击“打包”。

七、上线前检查清单

1. 网站已经开启 HTTPS，证书链完整。
2. 后台、API、WebSocket 和下载目录使用正式域名，不再使用临时 IP。
3. 防火墙和安全组只开放业务需要的端口。
4. 管理后台修改默认密码并开启二次验证。
5. 实时服务、推送任务和计划任务均正常运行。
6. Android 真机完成注册、登录、好友申请、单聊、群聊、图片、文件、已读未读、断线重连和离线推送测试。
7. 完成数据库备份，并把源码、数据库备份和 App 签名证书异地保存。