本文档仅针对离线版加密器(Compiler 基础版、高级版、旗舰版),试用版和在线版不需要此操作

准备工作

  • 需要x86_64的Linux机器,推荐CentOS7系统
  • 以root权限执行程序(因为获取硬件的指纹,需要 root 权限)

第一步 获取加密机器的 key

安装前先下载 gen_key 工具,下载地址是:

然后在准备好的机器上执行下面的命令,生成硬件指纹:

chmod a+x gen_key_v2
./gen_key_v2

第二步 申请授权

进入识沃官网 https://business.swoole.com/product/get_compiler/ 点击 “申请新的软件包” ,将上一步 gen_key 执行输出的机器 Key 填入表单中,并提交。

等待 1-2 分钟后构建完成,就可以下载到软件包了。

建议通过“右键另存为”进行下载。若未下载成功,请检查浏览器设置,是否被拦截了

第三步 安装加密器

获取到下载的加密器软件包后解压到当前目录。

  • loader 子目录是 swoole_loader 扩展,加密后代码要执行的机器上必须安装 swoole_loader 扩展

Ubuntu/Debian 系统

dpkg -i swoole-compiler30200.deb

CentOS/RedHat 系统

rpm -i swoole-compiler30200.rpm

第四步 完成安装,进行加密

安装完成后使用 swoole-compiler30200 命令加密 PHP 代码

sudo swoole-compiler30200 -h
  Swoole Compiler version 3.2.0 

  命令 : 
      -h           查看帮助信息
      -t type      设置编译类型为加密代码或证书,可选值为: code/license,默认值为: code
      -c filePath  设置配置文件地址
 
  例子 : 
      swoole-compiler30200 -h
      swoole-compiler30200 -t code -c ~/config.ini
      swoole-compiler30200 -t license -c ~/config.ini

配置文件 config.ini 请参考 配置文件

卸载

Ubuntu/Debian

sudo dpkg --remove swoole-compiler30200

CentOS/RedHat

rpm -e swoole-compiler-30200

常见错误

dpkg 安装失败 Origin Signature check failed

debsig: Origin Signature check failed. This deb might not be signed.
dpkq: error processing archive swoole-compiler30200.deb (--install):
verification on package swoole-compiler30200.deb failed!
Errors were encountered while processing:
swoole-compiler30200.deb

使用下面的命令安装:dpkg --force-bad-verify -i swoole-compiler30200.deb

最后更新:2026-09-15