Documentation / v3.1.0
接入说明
加固不改变调用方写法。产物仍然是一个标准 ELF 共享库,加载方式、导出接口与加固前一致。
01
产物长什么样
加固后的文件在结构上分四层:
外壳 ELFAArch64 · ET_DYN · PIE
私有容器头"Claude-Protector\0" + 版本 + 摘要
加密载荷按 4 KB 分页 · 逐页独立密钥
运行时初始化例程 · mmap 还原 · 重定位修复
容器头位于文件尾部追加段的起始位置,长度 32 字节。校验值为整段载荷摘要与元数据摘要的合并结果, 运行时先校验、后解密;校验不通过则不进入初始化。
02
Android 集成
// 把加固后的 so 放回 jniLibs,其余不动 android { sourceSets["main"].jniLibs.srcDirs("src/main/jniLibs") } // 打包时关闭对 so 的再压缩,避免二次处理 androidResources { noCompress += "so" }
Java 侧调用方式不变:System.loadLibrary("native")。
03
命令行加固
cpprot seal libnative.so --mode virtualize --out libnative.sealed.so
cpprot info libnative.sealed.so
cpprot verify libnative.sealed.so
# 只保护指定函数(select 档)
cpprot seal libnative.so --mode select \
--select Java_com_app_Native_verify,Java_com_app_Native_sign \
--out libnative.sealed.so
--modeselect / detect / virtualize / control
--keep保留的导出符号,逗号分隔
--select仅加密指定函数所在页
--anti-debug调试器与注入框架检测
--anti-hook内联钩子与代码页权限检测
--integrity启动与周期内存摘要校验
--cloud授权登记与吊销检查
04
注意事项
· 只接受 ELF64 共享库。ARM32、x86 与静态可执行文件不做处理,提交时会被拒绝。
· 加固会改变文件摘要,若你依赖自身签名做校验,请在加固后再计算。
· 需要保留给外部解析的符号请写明,未保留的符号名会被裁掉。
· 同一个文件多次加固,产物不会完全一致;这不影响功能,属于正常设计。
· 加固不修改业务逻辑。若原库存在崩溃,加固后同样存在。