Java RMI Codebase 远程代码执行漏洞实战:原理剖析与 Vulhub 复现环境搭建
Java RMI Codebase 远程代码执行漏洞实战:原理剖析与 Vulhub 复现环境搭建
Java Remote Method Invocation(RMI)是 Java 平台内置的远程过程调用机制,而 java.rmi.server.codebase 参数则是其动态类加载能力的关键开关。本篇文章以 Vulhub 仓库中的 java/rmi-codebase 漏洞环境为核心,系统讲解 RMI codebase 远程代码执行漏洞的形成原理、环境搭建步骤,并结合仓库中的 Dockerfile 与 Java 源码逐行剖析漏洞触发条件,帮助读者理解"为何客户端指定 codebase 就能让服务端执行任意字节码"这一经典攻击链路,以及如何通过参数与安全策略进行防护。
RMI 与 codebase:动态类加载机制回顾
RMI(Remote Method Invocation)允许 Java 程序像调用本地方法一样调用远程 JVM 上的对象方法。一次典型的 RMI 调用涉及三个角色:
- Registry(注册中心):维护"名字 → 远程对象 Stub"的绑定关系,默认监听 1099 端口;
- Server(服务端):将远程对象导出并绑定到 Registry,供客户端查找;
- Client(客户端):通过 Registry 查找到 Stub,再经由 Stub 发起远程调用。
Stub 本身是一个实现了远程接口的本地代理类。当客户端从 Registry 获取 Stub 时,如果本地 JVM 中没有 Stub 对应的类文件,Java 会尝试从远程加载——这正是 java.rmi.server.codebase 发挥作用的地方。
codebase 是一个以空格分隔的 URL 列表,用于告知 JVM"需要动态加载的类可以从哪些地址下载"。在 RMI 协议中,codebase 信息会作为对象序列化数据的一部分(annotation)随 RMI 消息在网络中传递。也就是说:
任意一方(客户端或服务端)在发送远程对象或参数时,都可以在消息中附带一个 codebase 注解,指向其自有的类文件托管地址。
如果接收方开启了远程类加载能力,就会按照该 URL 去下载并定义类,随之执行类中的静态初始化逻辑或构造代码。这既是 RMI 分布式能力的基石,也是远程代码执行漏洞的温床。
漏洞原理:服务端为何会"听信"客户端的 codebase
RMI codebase 攻击能否成立,取决于接收方 JVM 同时满足以下三个条件:
- 动态类加载未被禁用:对应系统属性
java.rmi.server.useCodebaseOnly=false。该属性在 JDK 7u21 及之后版本默认值为true,即 JVM 默认只信任自身启动参数(-Djava.rmi.server.codebase=...)中声明的 codebase,忽略网络消息中携带的 codebase 注解; - 安装了 SecurityManager:远程类加载属于受安全策略管制的敏感操作,没有 SecurityManager 时 JVM 会拒绝动态加载远程类;
- 安全策略允许加载:策略文件需要授予对应权限(实践中常为
AllPermission)。
当攻击者能够向目标 JVM 发送带有恶意 codebase 注解的 RMI 数据(如远程对象 Stub 或方法参数对象),且目标 JVM 满足上述条件时,目标就会主动从攻击者控制的 HTTP 服务器拉取恶意 .class 字节码并装载执行,从而在目标主机上实现任意代码执行。
环境搭建:启动 Vulhub RMI Registry 与服务器
本环境位于 java/rmi-codebase,仓库中的 docker-compose.yml 定义了服务编排:
services:
rmi:
image: vulhub/j2ee:8u222
ports:
- "1099:1099"
- "64000:64000"
environment:
- RMIIP=127.0.0.1
在漏洞环境目录下执行如下命令即可编译并启动 RMI Registry 和服务器:
docker compose run -e RMIIP=your-ip -p 1099:1099 -p 64000:64000 rmi
命令参数说明:
| 参数 | 作用 |
|---|---|
-e RMIIP=your-ip |
将 your-ip 替换为你的服务器 IP 地址,客户端将使用此 IP 连接服务器,该值会注入容器的 java.rmi.server.hostname 属性 |
-p 1099:1099 |
映射 RMI Registry 端口,环境启动后 Registry 监听在 1099 端口 |
-p 64000:64000 |
映射远程对象实际导出的端口(详见下文源码分析) |
说明:英文版 README.md 中还包含
docker compose build步骤(基于 base/j2ee/8u222/Dockerfile 构建镜像),使用已发布镜像时可直接执行上述docker compose run命令。
源码级佐证:本仓库中漏洞环境的三个关键设计
本环境对应的基础镜像源码位于 base/j2ee/8u222,其中的 Dockerfile 与 Java 源码恰好完整呈现了"漏洞环境如何刻意满足三个前提条件"。
1. 启动参数:显式关闭 useCodebaseOnly
Dockerfile 中的启动命令是整个环境最核心的一行:
CMD ["bash", "-c", "java -Djava.rmi.server.hostname=${RMIIP} -Djava.rmi.server.useCodebaseOnly=false -Djava.security.policy=client.policy RemoteRMIServer"]
-Djava.rmi.server.hostname=${RMIIP}:将RMIIP环境变量注入 RMI 服务器地址,使客户端可用该 IP 连接;-Djava.rmi.server.useCodebaseOnly=false:关键开关,显式允许服务端信任 RMI 消息中携带的 codebase 注解,从而具备远程加载类的条件;-Djava.security.policy=client.policy:指定安全策略文件。
2. 安全策略:授予 AllPermission
client.policy 内容极为宽松,授予了所有权限:
grant {
permission java.security.AllPermission;
};
结合代码中主动安装的 SecurityManager,远程类加载的权限条件被完全放行。
3. 服务端代码:注册带 codebase 能力的远程对象
RemoteRMIServer.java 启动时主动安装 SecurityManager,创建 1099 端口 Registry 并绑定远程对象:
public class RemoteRMIServer {
private void start() throws Exception {
if (System.getSecurityManager() == null) {
System.out.println("setup SecurityManager");
System.setSecurityManager(new SecurityManager());
}
Calc h = new Calc();
LocateRegistry.createRegistry(1099);
Naming.rebind("refObj", h);
}
...
}
被绑定的 Calc.java 继承 UnicastRemoteObject 并指定导出端口 64000——这就是 docker-compose 中映射第二个端口的由来:
public class Calc extends UnicastRemoteObject implements ICalc {
public Calc() throws RemoteException {
super(64000); // 远程对象实际导出在 64000 端口
}
public Integer sum(List<Integer> params) throws RemoteException {
Integer sum = 0;
for (Integer param : params) {
sum += param;
}
return sum;
}
}
远程接口 ICalc.java 定义了一个简单的求和方法,作为客户端调用的目标接口。从源码结构可以看出,该环境的攻击面并不在于 sum 方法本身,而在于服务端 JVM 已按上述配置具备"从攻击者指定的 codebase 下载并执行字节码"的能力。
漏洞复现思路(原文档该章节标注为"待完善")
需要说明的是,仓库中的 README.zh-cn.md 在"漏洞复现"一节目前标注为待完善,因此以下内容是基于 RMI 动态类加载机制与本仓库源码配置推导出的攻击路径,供安全研究与二次开发 PoC 时参考,而非已验证的完整复现步骤。
结合本环境配置(useCodebaseOnly=false + SecurityManager + AllPermission),攻击者可推演如下链路:
- 准备恶意字节码:编写一个包含恶意逻辑(如
static {}静态初始化块或构造函数中执行命令)的 Java 类,编译后托管到攻击者可控的 HTTP 服务器上; - 构造携带 codebase 的 RMI 消息:作为 RMI 客户端,向目标 Registry 发起绑定或调用,使发送的数据中携带指向恶意类 URL 的 codebase 注解;
- 触发服务端动态加载:服务端在反序列化过程中发现本地缺失对应类,由于
useCodebaseOnly=false且安全策略放行,会依据 codebase 注解从攻击者服务器拉取恶意.class; - 字节码执行:类装载触发恶意代码(静态初始化、构造器或后续方法调用),实现服务端任意命令执行。
判断攻击是否成功,可通过观察服务端日志(是否出现 setup SecurityManager 及类加载记录)、HTTP 服务器访问日志(是否收到来自目标 IP 的 .class 下载请求)以及命令执行结果(如反弹 Shell、写入文件)来确认。
修复与缓解建议
从漏洞形成的三个前提条件出发,可以逐一加固:
| 加固层面 | 具体措施 |
|---|---|
| 禁用远程 codebase | 设置 -Djava.rmi.server.useCodebaseOnly=true(JDK 7u21+ 的默认值,务必确认未被显式覆盖) |
| 收紧安全策略 | 为 SecurityManager 配置最小权限策略,禁止远程类加载相关权限,避免使用 AllPermission |
| 网络隔离 | 限制 RMI 服务(1099 及动态导出端口)仅对可信客户端开放,部署防火墙与访问控制 |
| 依赖与版本升级 | 及时升级 JDK,关注 RMI 相关 CVE 与安全公告 |
| 运行时监控 | 监控目标端口出站请求,异常 HTTP 类下载行为通常是 codebase 攻击的早期信号 |
小结
Java RMI 的 codebase 机制本是为分布式系统动态分发类文件而设计,但一旦 useCodebaseOnly 被关闭、安全策略放行远程类加载,它就转化为一条通向任意代码执行的攻击路径。Vulhub 的 java/rmi-codebase 环境通过 docker-compose.yml、Dockerfile 与 RemoteRMIServer.java 三者的配合,将这一漏洞所需的全部条件浓缩为一个可一键启动的实验环境,是理解 RMI 动态类加载安全边界、验证 codebase 攻击手法的理想靶场。