Java RMI Codebase 远程代码执行漏洞实战:原理剖析与 Vulhub 复现环境搭建

原创2026-09-13 23:48:421,842 阅读
文章标签:网络安全应用安全容器编排

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 同时满足以下三个条件:

  1. 动态类加载未被禁用:对应系统属性 java.rmi.server.useCodebaseOnly=false。该属性在 JDK 7u21 及之后版本默认值为 true,即 JVM 默认只信任自身启动参数(-Djava.rmi.server.codebase=...)中声明的 codebase,忽略网络消息中携带的 codebase 注解;
  2. 安装了 SecurityManager:远程类加载属于受安全策略管制的敏感操作,没有 SecurityManager 时 JVM 会拒绝动态加载远程类;
  3. 安全策略允许加载:策略文件需要授予对应权限(实践中常为 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),攻击者可推演如下链路:

  1. 准备恶意字节码:编写一个包含恶意逻辑(如 static {} 静态初始化块或构造函数中执行命令)的 Java 类,编译后托管到攻击者可控的 HTTP 服务器上;
  2. 构造携带 codebase 的 RMI 消息:作为 RMI 客户端,向目标 Registry 发起绑定或调用,使发送的数据中携带指向恶意类 URL 的 codebase 注解;
  3. 触发服务端动态加载:服务端在反序列化过程中发现本地缺失对应类,由于 useCodebaseOnly=false 且安全策略放行,会依据 codebase 注解从攻击者服务器拉取恶意 .class;
  4. 字节码执行:类装载触发恶意代码(静态初始化、构造器或后续方法调用),实现服务端任意命令执行。

判断攻击是否成功,可通过观察服务端日志(是否出现 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 攻击手法的理想靶场。

登录后查看全文
vulhub