文档目录
Core Loader 8.0 概述
Core Loader 8.0 是新一代PHP代码加密和授权保护系统,采用军用级加密算法,为您的PHP应用提供全方位的安全保护。
核心特性
1+5层加密保护
多重加密算法组合,确保代码安全性
高性能执行
加密后性能损失小于2%
字节码编译
转换为不可逆的字节码格式
灵活授权
支持域名、IP、时间等多种授权方式
技术规格
| 支持PHP版本 | PHP 7.0 及以上 |
| 加密算法 | AES-256、RSA-4096、SHA-512、ECDSA、ChaCha20、Argon2 |
| 操作系统 | Linux, Windows, macOS |
| Web服务器 | Apache, Nginx, IIS, Lighttpd |
安装扩展
脚本部署
一行命令自动完成下载扩展、写入配置并重载 PHP(PHP 7.0–8.5 · Linux / macOS / Windows)。
Linux / macOS
curl -fsSL https://coreloader.com/core-loader-releases/install.sh | bash
指定 PHP 版本
curl -fsSL https://coreloader.com/core-loader-releases/install.sh | bash -s -- 8.5
Windows(CMD / PowerShell)
cmd /c "curl -fsSL -o %TEMP%\cl-install.cmd https://coreloader.com/core-loader-releases/install.cmd && call %TEMP%\cl-install.cmd"
指定 PHP 版本
cmd /c "curl -fsSL -o %TEMP%\cl-install.cmd https://coreloader.com/core-loader-releases/install.cmd && call %TEMP%\cl-install.cmd 8.5"
脚本会自动:下载扩展 → 写入配置 → 重载 PHP。
手动部署
1下载扩展文件
请从 扩展下载页 或 GitHub 下载与您的操作系统、PHP 版本及 CPU 架构相匹配的扩展文件。
Linux 示例(文件以实际下载为准)
# core_loader-php8.5-linux-x86_64.so
Windows 示例
# php_core_loader-php8.5-win-x64.dll
2配置PHP扩展
将扩展文件复制到PHP扩展目录,并在php.ini中添加配置。
将扩展文件上传到PHP扩展目录(以PHP8.5为例)
# 1Panel
/opt/1panel/runtime/php/PHP85/extensions/no-debug-non-zts-20250925
# 宝塔
/www/server/php/85/lib/php/extensions/no-debug-non-zts-20250925
# 其他环境可通过 php -i | grep extension_dir 查看实际路径
在 php.ini 中添加以下配置(文件以实际下载为准)
Linux 示例:
extension=core_loader-php8.5-linux-x86_64.so
Windows 示例:
extension=php_core_loader-php8.5-win-x64.dll
3重启Web服务器
重启您的Web服务器以加载新的扩展。
# Apache
sudo systemctl restart apache2
# Nginx + PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php-fpm
验证安装
安装完成后,可通过以下命令确认扩展是否已加载。
本机
php -m | grep core_loader
Docker
docker exec <容器名> php -m | grep core_loader
代码加密
第一步:生成授权
访问 授权生成页面 创建授权:
- 生成授权UID(唯一凭证)
- 设置授权时间
- 配置域名、IP、授权方式
- 生成并下载授权文件
第二步:加密代码
使用 代码加密功能 加密您的PHP文件:
- 选择加密方式(粘贴代码或上传文件)
- 设置加密级别
- 执行加密操作
- 下载加密后的文件
第三步:部署运行
将加密后的文件部署到目标服务器
提示:确保目标服务器已安装Core Loader扩展,否则加密文件无法正常运行。
加密说明
| 级别 | 安全性 | 性能影响 | 适用场景 |
|---|---|---|---|
| 1层 - 个人级 | 高 | < 2% | 一般商业应用 |
| 3层 - 企业级 | 很高 | < 4% | 重要商业系统 |
| 5层 - 军用级 | 极高 | < 7% | 高安全要求系统 |
加密算法
- • AES-256 对称加密
- • AES-256-GCM 认证加密
- • RSA-4096 非对称加密
- • SHA-512 哈希验证
- • HMAC-SHA512 消息认证
- • ECDSA 椭圆曲线签名
- • ChaCha20 流加密
- • ChaCha20-Poly1305 AEAD
- • Poly1305 消息认证码
- • Argon2 密钥派生
混淆强度配置
低强度混淆
- • 变量名混淆
- • 函数名混淆
- • 基础字符串加密
中强度混淆
- • 包含低强度所有功能
- • 控制流混淆
- • 常量混淆
高强度混淆
- • 包含中强度所有功能
- • 类结构混淆与代码虚拟化
- • 反调试与反逆向工程
API接口
接口字段说明
| 字段 | 说明 |
|---|---|
UID | 授权唯一标识(UUID);修改时必填 |
Auth | 创建时返回的身份识别码;修改接口必填 |
name | 授权名称 |
domain / ip | 域名、IP 限制列表 |
layers | 加密层数:1 / 3 / 5 |
expire_time | 过期时间(Unix 时间戳) |
network | 是否启用网络验证(0/1) |
接口一览表
| 接口 | 方法 | 说明 |
|---|---|---|
/api/license/create |
POST | 创建授权,返回 JSON(含 Auth、密文等) |
/api/license/query |
GET | 按 uid / domain / ip 查询 |
/api/license/modify |
POST | 修改用户名称 / 过期时间 / 授权域名 / 授权 IP |
1. 创建授权
请求示例
POST /api/license/create
Content-Type: application/json
{
"name": "默认名称",
"uid": "d130b8e3-93cc-4fb1-80f5-96d6258aa43a",
"domain": "demo.example.com",
"ip": "10.0.0.8",
"layers": 3,
"network": 1,
"expire_time": "2028-12-31 23:59:59",
"custom": "{}"
}
成功响应
{
"code": 200,
"msg": "授权创建成功",
"data": {
"UID": "d130b8e3-93cc-4fb1-80f5-96d6258aa43a",
"Auth": "4da866b01d0e22ee9a2aaf723c75d9db",
"license": "eyJ2ZXJzaW9uIjoiOC4wLjAiLCJkYXRhIjoi...",
"filename": "my.license"
}
}
2. 查询授权
请求示例
GET /api/license/query?type=uid&uid=d130b8e3-93cc-4fb1-80f5-96d6258aa43a
# 等价写法
GET /api/license/query?uid=d130b8e3-93cc-4fb1-80f5-96d6258aa43a
GET /api/license/query?domain=demo.example.com
GET /api/license/query?ip=10.0.0.8
UID 查询响应
{
"success": true,
"data": [
{
"uid": "d130b8e3-93cc-4fb1-80f5-96d6258aa43a",
"name": "默认名称",
"domains": ["demo.example.com"],
"ips": ["10.0.0.8"],
"expire_time": 1861891199,
"layers": 3,
"created_time": 1788184138,
"custom": [],
"network": 1,
"Auth": "4da866b01d0e22ee9a2aaf723c75d9db"
}
],
"count": 1
}
域名 / IP 查询响应
{
"success": true,
"data": [
{
"name": "默认名称",
"domains": ["demo.example.com"],
"ips": ["10.0.0.8"],
"expire_time": 1861891199,
"layers": 3,
"created_time": 1788184138,
"custom": [],
"network": 1
}
],
"count": 1
}
3. 修改授权
请求示例
POST /api/license/modify
Content-Type: application/json
{
"uid": "d130b8e3-93cc-4fb1-80f5-96d6258aa43a",
"auth": "4da866b01d0e22ee9a2aaf723c75d9db",
"name": "默认名称-已修改",
"expire_time": "2029-01-01 00:00:00",
"domains": ["new.example.com", "www.example.com"],
"ips": ["10.0.0.8", "10.0.0.9"]
}
成功响应
{
"code": 200,
"msg": "授权信息修改成功",
"data": {
"uid": "d130b8e3-93cc-4fb1-80f5-96d6258aa43a",
"updated_fields": ["name", "expire_time", "domains", "ips"],
"name": "默认名称-已修改",
"domains": ["new.example.com", "www.example.com"],
"ips": ["10.0.0.8", "10.0.0.9"],
"expire_time": 1861920000,
"new_encrypted_content": "eyJ2ZXJzaW9uIjoiOC4wLjAiLCJkYXRhIjoi..."
}
}
常见状态与错误
| HTTP / code | 说明 | 常见原因 |
|---|---|---|
200 |
成功 | create/query/modify 均返回 JSON |
400 |
参数错误 | 缺少 uid/auth,或 UID 格式不正确 |
403 |
禁止修改 | 授权文件未开启网络验证 |
404 |
未找到记录 | uid + auth 不匹配,或记录不存在 |
405 |
方法不允许 | query 需 GET,modify 需 POST |
429 |
查询过于频繁 | 查询间隔不足 10 秒 |
500 |
处理失败 | 加密/解密失败、数据库异常等 |
常见问题
- 检查扩展文件是否存在于 PHP 扩展目录
- 确认 php.ini 中已添加 extension=coreloader
- 重启 Web 服务器
- 使用 php -m 验证扩展是否已加载
- 检查授权是否已过期
- 确认域名 / IP 是否匹配
- 验证网络连接是否正常
- 尝试降低加密强度
- 启用 OPcache 优化
- 提升服务器配置
- 优先使用 SSD 存储
选择加密级别需要平衡安全性和性能:
- 标准加密: 适用于一般商业应用,性能影响最小
- 增强加密: 适用于重要商业系统,推荐选择
- 军用级加密: 适用于高安全要求的系统,如金融、政府等
支持。可通过 Web 界面多文件上传,或使用 API 进行程序化批量处理。