Files
usdt/docs/network-request-trace.md
2026-11-16 02:09:23 -05:00

127 lines
6.4 KiB
Markdown

# Pinggy 外联调用来源定位
## 当前结论与证据边界
`grpc.nile.trongrid.io` 的 AWS ELB CNAME 属于已有 Nile 查询链路。
最初的 DNS 记录不能直接确定 Java 调用者;后续实际调用栈和数据库记录已确认:
`sys_job` 8/12 的恶意任务通过 Quartz → Yaml.load → ScriptEngineManager → URLClassLoader
触发两个 Pinggy 域名的远程 JAR 加载尝试。是否成功下载、执行或外传仍需主机证据。
修复和部署步骤见[安全加固](security-hardening.md)。
已检查的本地动态插件 JAR 和 `D:/configs/license.dll` 中未命中目标域名的明文、
UTF-16 或 Base64 内容。此前识别到 `org.json:json:19970182` 含授权代码,
但没有把它与这两个 Pinggy 域名关联的调用栈;暂不能认定是该包引入。
实际部署目录、数据库、运行环境可能与本机不同,需要在复现进程中采样。
## 开启方式
该功能针对本项目 JDK 8,默认关闭。管理后端和独立执行器均已在 `main` 的
Spring 启动之前调用 `NetworkRequestTrace.installIfEnabled()`,不需要修改业务配置。
IDEA 的 Run/Debug Configuration → VM options 加入:
```text
-Dnetwork.trace.enabled=true
```
部署环境也可以设置 `NETWORK_TRACE_ENABLED=true`。JVM 参数优先于环境变量。
必须重启实际出现异常的 Java 进程,修改当前终端变量不会影响已经启动的进程。
无需把开关放进 `application.yml`;这里是在 Spring 读取 YAML 之前安装。
现有 `java -jar` 启动命令把开关放在 `-jar` 之前,例如:
```bash
java -Dnetwork.trace.enabled=true -jar ruoyi-admin.jar
```
默认匹配 `pinggy-free.link` 和它的子域名。如果只需这两个域名,可以设置:
```text
-Dnetwork.trace.hosts=wzndf-185-244-148-229.run.pinggy-free.link,lmdpj-185-244-148-229.run.pinggy-free.link
```
环境变量等效项为 `NETWORK_TRACE_HOSTS`。需要顺便对照 Nile 调用时,可以把
`grpc.nile.trongrid.io` 加入逗号分隔的列表。不要使用 URL、密码或查询串作为过滤值。
更新主程序时,必须同时更新本轮构建的 `ruoyi-system` JAR;外置 `lib` 部署不能只更新
`ruoyi-admin.jar`,也不能把旧 `ruoyi-system` 留在同一 classpath 中。
主模块已显式声明系统模块依赖,完整 Maven 构建会先编译当前系统模块。
## 查看结果
启动控制台首先应显示:
```text
[NETWORK-TRACE] ENABLED java=1.8... hosts=pinggy-free.link maxEvents=200 output=stderr observation-only
```
日志直接写入标准错误输出,覆盖日志框架尚未初始化的时段。
IDEA 控制台、systemd journal 或容器日志一般会收集 stderr;只看业务 `info.log`
可能看不到。自行启动时可以在原命令后追加 `2>network-trace.log` 收集诊断。
目标域名被解析时,输出形式如下(以下为格式示意,并非已经捕获的可疑调用):
```text
[NETWORK-TRACE] BEGIN event=1 timeMillis=... threadId=... operation=DNS host=lmdpj-185-244-148-229.run.pinggy-free.link port=-1
origin com.example.CallbackWorker source=file:/srv/app/lib/example.jar
at java.net.InetAddress.getAllByName(...)
at com.example.CallbackWorker.send(CallbackWorker.java:123)
[NETWORK-TRACE] END event=1
```
`origin` 显示实际执行类的 CodeSource,而非根据类名推测 JAR;`at` 显示方法和行号。
结合类名与相应栈帧,判断请求来自业务回调、依赖授权逻辑或动态插件。
若栈帧是异步 DNS 工作线程,它只能说明当前解析任务的执行者,仍需沿上游任务入口追查。
重点判读:
| 栈上的业务类 | 后续核查 |
| --- | --- |
| `PaymentCallbackWorker` | `orders.notify_url`、订单 ID、回调次数 |
| `PayoutCallbackService` | `usdt_payout_order.notify_url` |
| `RentalWorkers` | `rent_order.notify_url`、`rent_webhook` 对应明细;域名校验本身也可能触发 DNS |
| `com.license.*` | 日志中实际加载的 JAR、部署环境的授权地址配置及本地 DLL |
| 其他库或插件类 | 以 `origin source=` 指向的实际 JAR 为准,核对该部署文件的哈希及来源 |
## 同步检查数据库中的旧回调地址
当前本机无法连接配置中的数据库,所以没有假定数据库里不存在目标域名。
可以在复现服务实际连接的数据库中执行以下只读查询,只返回记录 ID 和状态,
不返回完整 URL、请求参数、API Key 或私钥。没有租赁表的库跳过相应查询。
```sql
SELECT id, status, callback_num, callback_confirm
FROM orders WHERE LOWER(notify_url) LIKE '%pinggy-free.link%' LIMIT 100;
SELECT id, status, callback_num, callback_confirm
FROM usdt_payout_order WHERE LOWER(notify_url) LIKE '%pinggy-free.link%' LIMIT 100;
SELECT id, status
FROM rent_order WHERE LOWER(notify_url) LIKE '%pinggy-free.link%' LIMIT 100;
SELECT id, status
FROM rent_app WHERE LOWER(notify_url) LIKE '%pinggy-free.link%' LIMIT 100;
```
命中仅代表存在配置,不代表该行正被定时任务执行;需要结合调用栈和任务状态确认。
不要直接删除订单、修改回调状态或清空队列作为定位手段。
## 诊断边界与关闭
- 该钩子基于 JDK 8 `SecurityManager.checkConnect`。`port=-1` 表示解析前检查,
不是 HTTP 已成功发出。诊断本身不访问目标域名,也不改变 DNS 缓存、代理或连接结果。
- 只记录域名、时间、线程 ID、栈帧和类来源,不采集完整 URL、请求头、正文或钱包数据。
- 已存在安全管理器时输出 `NOT_INSTALLED existing-security-manager`,不会覆盖已有策略。
这是观察工具,不是安全沙箱。部分较新 JDK 已禁用此机制,应使用项目 JDK 8。
- 最多输出 200 条事件;出现 `LIMIT_REACHED` 后仍正常执行网络操作,但停止打印。
- JNI、自建 DNS 解析器、原生库、子进程和其他服务的请求不一定经过本钩子。
一直没有日志时,应先核对 `ENABLED`、进程、部署 JAR、事件上限,再用操作系统工具关联 PID。
- 定位后删除 VM 参数/环境变量并重启,或显式设置 `-Dnetwork.trace.enabled=false`。
现有业务任务、回调及链上逻辑均不因该开关而被禁用。
## 验证
`NetworkRequestTraceTest` 在独立 JVM 中验证默认关闭、保留原安全管理器、
通过本地 `localhost` 真实解析记录动态 JAR 来源、域名边界、敏感 URL 拒绝输出和事件上限。
测试不解析 Pinggy 域名,也不启动真实数据库或链上调度。