快速开始

本页适用于 3.0.0。详细命令见 Windows 部署或 Linux 部署。

1. 下载并启动

从 3.0.0 发行页下载对应系统的完整包和 SHA256SUMS.txt，校验后解压到独立目录。

系统	安装包	启动程序
Windows AMD64	mengka-3.0.0-windows-amd64.zip	mengka.exe
Linux AMD64	mengka-3.0.0-linux-amd64.tar.gz	mengka

解压目录应直接包含程序、public 和 data，没有额外一层顶级文件夹。在该目录打开终端并启动：

Windows

.\mengka.exe

Linux

chmod +x ./mengka
./mengka

程序运行期间保持终端打开，后续也使用同一工作目录。

2. 注册与初始化

打开终端显示的完整初始化地址。地址也保存在 data/platform-auth/setup-access.txt；保留其中的路径和查询参数，不要只打开端口根地址。

1. 输入注册卡，注册当前实例；一张注册卡只能注册一个实例。
2. 阅读并确认使用协议。
3. 设置本地管理员账号、密码和监听端口，完成初始化。

注册后默认获得永久 Free 权限；保留原 data 后，实例重启或更新不需要重新用卡。初始化地址与管理员凭据请妥善保管。

远程服务器通过 SSH 转发访问初始化地址，端口以终端实际显示为准，方法见 Linux 部署。

3. 添加 QQ 账号

创建设备指纹，再添加 QQ 账号并选择协议与设备。发起登录后按提示完成验证码、短信或扫码确认，检查账号在线状态和运行日志。

框架运行的 Windows／Linux 系统与账号选择的 QQ 协议相互独立，登录时按页面提示完成验证。

4. 连接插件服务

在插件页面导入适配当前框架的 IPC 插件，或创建 HTTP、正向／反向 WebSocket 服务连接外部插件。插件按权限访问当前框架内的账号。

继续阅读插件开发和 API 文档。

从旧版升级

从 2.x 升级时，将安装包解压到独立目录重新初始化，并保留旧程序与完整数据备份。已有新版实例更新前，先按升级检查单备份数据。