Halo 的头像
Halo
21 阅读

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

结论

  • 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 上执行:

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 及更高版本。检查:

java -version

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

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

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. 重启并验证

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

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

无法立即升级时

在 Halo 的 JVM 参数中加入:

-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. 确认当前状态:

    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 中增加环境变量:

    environment:
      JVM_OPTS: "-XX:-UseBASE64Intrinsics"
    

    也可用 -XX:UseAVX=2 代替,但影响范围更大。

    然后重建容器:

    docker compose up -d
    

    Kubernetes 等编排环境同理:把 JVM_OPTS 写入 Deployment 的环境变量,然后滚动重启。

  4. 确认参数已进入实际运行的 Java 进程:

    docker exec <container> sh -c 'tr "\0" " " < /proc/1/cmdline; echo'
    

    输出中应包含 -XX:-UseBASE64Intrinsics。

  5. 确认 Halo 正常启动:

    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 Cookieapplication/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 Basicapplication/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 中,不需要单独处理;数据库、文章、附件和插件数据也不受影响。

参考

检查清单

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

评论