# 关于 CVE-2026-114938 的影响说明及 Halo 部署处理方案

原文：<https://www.halo.run/archives/java-cve-2026-114938>

## 结论

-   Halo 应用代码本身不需要修改，风险来自运行 Halo 的 JDK。
-   只有同时满足「x86-64 CPU 向 JVM 暴露 AVX-512 VBMI」和「JDK 未修复」时才需要按本文处理（Halo 的登录等未认证路径会把外部 Base64 送入解码）；ARM64 不受影响。
-   使用 `java -jar` 部署：把实际运行 Halo 的 JDK 升级到修复版本并重启即可。
-   使用官方容器镜像：截至 2026-11-20，上游 `eclipse-temurin:21-jre` 尚未更新到修复版本，可先用 `JVM_OPTS="-XX:-UseBASE64Intrinsics"` 临时规避，待基础镜像更新后重建容器并移除该参数。
-   安装 Halo 或对外提供网站访问，并不意味着已经遭到攻击。

## 背景

2026 年 11 月 17 日，OpenJDK 与 Oracle 披露并修复了 CVE-2026-114938（代号 Java4Shell）。该漏洞位于 OpenJDK 的 Base64 解码优化路径：特制的 Base64 输入会使 AVX-512 解码路径的长度计算下溢，造成堆越界写，进而可能被利用读取进程内存或执行代码。各厂商给出的 CVSS 评分在 8.1–9.8 之间。

该漏洞的触发依赖 CPU 指令集，并非所有 Java 服务都受影响。当前 Halo 版本使用 Java 21 构建和运行，官方容器镜像基于 Eclipse Temurin 21；2025-05-20 之前的 Halo 版本可能使用 Java 17，请以实际运行版本为准，而不能只看 Halo 版本号。

截至 2026 年 11 月 18 日，JPCERT/CC 表示尚未确认在野利用。

## 影响范围

需要同时满足以下三个条件：

### 1\. CPU 向 JVM 暴露 AVX-512 VBMI

宿主机为 x86-64，且 CPU 特性对 JVM 可见。Linux 上执行：

```bash
grep -m1 -o avx512vbmi /proc/cpuinfo
```

有输出表示满足 CPU 条件；没有输出表示 JVM 不会启用该加速路径，当前配置下不受影响。ARM64（Apple Silicon、Graviton、鲲鹏等）不受影响。

虚拟机中 `/proc/cpuinfo` 反映的是宿主机暴露给虚拟机的 CPU 特性；如果 hypervisor 屏蔽了 AVX-512，JVM 同样不会走受影响路径。反之，如果以后变更 CPU 模型或迁移到暴露 AVX-512 VBMI 的宿主机，需要重新评估。

### 2\. 实际运行 Halo 的 JDK 属于受影响版本

OpenJDK 17.0.6 及之后的部分版本受影响，修复版本以各发行版公告为准，例如 Temurin 的 17.0.21.1、21.0.13.1、25.0.5.1、27.0.1.1 及更高版本。检查：

```bash
java -version
```

注意要检查 Halo 实际使用的 JDK，而不是 `PATH` 中的默认 `java`。使用 systemd 时可以先看服务配置：

```bash
systemctl cat halo | grep ExecStart
```

如果启动命令使用绝对路径，请直接对该路径下的 `java` 执行 `-version`。

### 3\. 请求能够到达 Base64 解码

Halo 处理外部请求时，会在多个位置解码 Base64：登录表单密码、remember-me Cookie、HTTP Basic 认证、个人访问令牌（PAT）校验。其中多条路径不需要登录即可到达，因此不能简单地认为「只有登录后才可能受影响」。

三条同时满足时，建议按本文处理；缺少任意一条，当前环境不满足该漏洞的触发条件。Halo 的数据库、文章、附件和插件数据不需要迁移或修改；插件后端与 Halo 运行在同一个 JVM 中，不需要单独处理，主题和前端资源不受影响。

本文适用于 Halo 2.x。Halo 1.x 已停止维护，不在本文处理范围。

## 通过 java -jar 直接部署

### 1\. 确认实际使用的 JDK

```bash
systemctl cat halo | grep ExecStart
/path/to/java -version
```

### 2\. 升级 JDK

在同一大版本内升级到发行版公告列出的修复版本（Halo 官方使用 Java 21，Temurin 21 线为 21.0.13.1 及更高版本），然后确认 Halo 的启动脚本或 systemd 配置指向新的 JDK。

如果使用发行版自带的 OpenJDK 包，请先确认该发行版是否已经发布修复版本；尚未发布时，可以改用 Adoptium Temurin 等已发布修复版本的构建。

### 3\. 重启并验证

```bash
sudo systemctl restart halo
sudo systemctl status halo
journalctl -u halo -n 100 --no-pager
```

确认 Halo 正常启动、登录页可访问、常用接口正常。

### 无法立即升级时

在 Halo 的 JVM 参数中加入：

```text
-XX:-UseBASE64Intrinsics
```

该参数会关闭 Base64 编解码的加速实现，可能带来一定的性能开销；升级 JDK 后应移除。另一个可选参数是 `-XX:UseAVX=2`（仅 x86-64），但它会影响所有 AVX-512 优化，影响范围比只关闭 Base64 intrinsic 更大。

## 官方容器镜像：临时方案及适用条件

官方镜像基于 `eclipse-temurin:21-jre`。已发布的 Halo 镜像不会自动更新基础镜像：`halohub/halo:2.27.3` 的镜像更新于 2026-11-13，早于本次修复。截至 2026-11-20，Docker Hub 上的 `eclipse-temurin:21-jre` 仍指向 21.0.13\_9（更新时间 2026-11-16），且尚未出现 21.0.13.1 的镜像标签。因此，现在直接重建 Halo 镜像也不一定能获得修复版本，操作前请先确认基础镜像中的实际 JDK 版本。

**升级 Halo 版本本身不一定带来修复**，关键是镜像内置的 JDK 版本。

适用条件：

-   使用官方镜像，且没有替换基础镜像或自带 JDK；
-   可以设置容器的环境变量并重建容器；
-   可以在启动参数中追加 JVM 参数。

不适用的情况：

-   自定义镜像已内置其他 JDK，请按该 JDK 的公告处理；
-   无法修改启动参数（例如由平台托管且不允许设置环境变量）；
-   ARM64 镜像：不满足 CPU 条件，无需按本节处理，但仍建议在正常维护时升级基础镜像。

### 操作步骤

1.  确认当前状态：
    
    ```bash
    docker ps --format 'table {{.Names}}\t{{.Image}}'
    docker exec <container> java -version
    docker exec <container> sh -c 'grep -m1 -o avx512vbmi /proc/cpuinfo'
    ```
    
2.  如果 `grep` 无输出，或 `java -version` 已经是修复版本，则不需要临时处理。
    
3.  否则，在 `docker run` 或 `docker compose` 中增加环境变量：
    
    ```yaml
    environment:
      JVM_OPTS: "-XX:-UseBASE64Intrinsics"
    ```
    
    也可用 `-XX:UseAVX=2` 代替，但影响范围更大。
    
    然后重建容器：
    
    ```bash
    docker compose up -d
    ```
    
    Kubernetes 等编排环境同理：把 `JVM_OPTS` 写入 Deployment 的环境变量，然后滚动重启。
    
4.  确认参数已进入实际运行的 Java 进程：
    
    ```bash
    docker exec <container> sh -c 'tr "\0" " " < /proc/1/cmdline; echo'
    ```
    
    输出中应包含 `-XX:-UseBASE64Intrinsics`。
    
5.  确认 Halo 正常启动：
    
    ```bash
    docker logs --tail 100 <container>
    ```
    
    然后访问登录页和常用接口，确认功能正常。
    

临时参数必须写在容器的启动配置中才能持久化；只对已有进程执行命令不会改变启动参数。

## 处理后的影响与后续更新

-   临时参数只影响 Base64 编解码性能，不会修改数据，也不需要数据库迁移。
-   升级 JDK 或基础镜像后，请移除 `-XX:-UseBASE64Intrinsics`，避免长期性能损失。
-   待 Adoptium 发布修复版容器镜像后，Halo 官方镜像需要在后续构建中更新；届时重新拉取或重建镜像即可，并再次用 `java -version` 确认。
-   上游镜像状态可能变化，操作前请以 Docker Hub 的实际标签和容器内的 `java -version` 为准。
-   不要使用来源不明的所谓「热补丁」，也不要用关闭 TLS 校验、降低日志级别等方式代替升级。

## 已核实的信息（2026-11-20）

| 项目 | 结果 |
| --- | --- |
| 当前 Halo Java 版本 | Java 21（`api/build.gradle:24`、`application/build.gradle:32`） |
| 官方镜像基础 | `eclipse-temurin:21-jre`（`Dockerfile:1`、`Dockerfile:8`） |
| 最新官方镜像 | `halohub/halo:2.27.3`，镜像更新于 2026-11-13，早于修复 |
| Temurin 修复版本 | `jdk-21.0.13.1+2`，发布于 2026-11-18 |
| Docker Hub `eclipse-temurin:21-jre` | 截至 2026-11-20 仍为 21.0.13\_9（2026-11-16 更新），尚无 21.0.13.1 标签 |
| 在野利用 | 截至 2026-11-18，JPCERT/CC 未确认 |

Halo 中会解码外部 Base64 的未认证路径（供自查）：

| 描述 | 源码位置 |
| --- | --- |
| 登录表单密码 | `application/src/main/java/run/halo/app/security/authentication/login/LoginAuthenticationConverter.java:43` |
| remember-me Cookie | `application/src/main/java/run/halo/app/security/authentication/rememberme/TokenBasedRememberMeServices.java:307` |
| 个人访问令牌（PAT） | `application/src/main/java/run/halo/app/security/authentication/token/PatAuthenticationManager.java:114` |
| HTTP Basic | `application/src/main/java/run/halo/app/infra/config/WebServerSecurityConfig.java:77-81` |

这些路径说明「未登录」不是安全边界；是否可被利用仍取决于上面的 CPU 与 JDK 条件。

本文未在真实 Halo 实例上复现漏洞利用；上述结论来自官方公告、仓库代码和镜像元数据。

## 常见问题

**升级到最新 Halo 版本是否就修复了？**  
不一定。漏洞在 JDK 中，取决于镜像内置的 JDK 版本。截至 2026-11-20，官方镜像的基础镜像尚未更新到修复版本。

**服务器没有 AVX-512 VBMI，还需要处理吗？**  
当前配置不满足该漏洞的触发条件，不需要应急处理；仍建议在正常维护时把 JDK 升级到修复版本。

**加 `-XX:-UseBASE64Intrinsics` 有什么影响？**  
会关闭 Base64 编解码的加速实现，可能带来一定的性能开销。它只是临时规避手段，升级后应移除。

**插件需要单独处理吗？**  
插件后端与 Halo 运行在同一个 JVM 中，不需要单独处理；数据库、文章、附件和插件数据也不受影响。

## 参考

-   [JPCERT/CC CyberNewsFlash（2026-11-18）](https://www.jpcert.or.jp/newsflash/2026111801.html)
-   [OpenJDK Vulnerability Advisory（2026-11-17）](https://openjdk.org/groups/vulnerability/advisories/2026-11-17)
-   [Oracle 安全公告](https://www.oracle.com/security-alerts/)
-   [Wiz：CVE-2026-114938 分析](https://www.wiz.io/blog/cve-2026-114938-rce-java4shell-openjdk)
-   [oss-sec 讨论](https://seclists.org/oss-sec/2026/q4/786)
-   [Adoptium Temurin 21.0.13.1+2](https://github.com/adoptium/temurin21-binaries/releases/tag/jdk-21.0.13.1%2B2)

## 检查清单

-   [ ]  宿主机执行 `grep -m1 -o avx512vbmi /proc/cpuinfo`，确认是否暴露 AVX-512 VBMI
-   [ ]  确认 Halo 实际使用的 JDK 版本（不是 `PATH` 中的默认版本）
-   [ ]  确认 JDK 是否为修复版本；不是则升级，或临时加入 `-XX:-UseBASE64Intrinsics`
-   [ ]  重启后确认 Halo 正常启动、登录页和常用接口正常
-   [ ]  基础镜像更新后移除临时 JVM 参数
