科技行业

GitHub Actions 已停止支持 Node.js 20:如何审计并修复您的工作流

GitHub Actions Dropped Node.js 20: How to Audit and Fix Your Workflows

GitHub Actions 已不再为 JavaScript 操作提供 Node.js 20 运行时。即使您的应用程序不使用 Node.js,旧的 checkout、setup 或第三方操作现在也可能成为 CI 问题。以下是如何审计您的工作流、更新自定义操作并安全检查自托管运行器的方法。

GitHub Actions 移除了 Node.js 20:如何审计和修复你的工作流

一个 GitHub Actions 工作流甚至可以依赖 Node.js,尽管它所构建的项目根本不包含任何 JavaScript。

这个细节现在变得重要了。

2026年9月23日,GitHub 已完成从 GitHub Actions 运行器中移除 Node.js 20。JavaScript action 现在运行在 Node.js 24 上,之前允许用户保持在 Node 20 的临时兼容切换不再可用。

对于许多仓库来说,无需更改。GitHub 的第一方 action 当前版本已经迁移到了 Node 24。

然而,旧的工作流、自定义 JavaScript action 和一些自托管 runner 需要进行审计。

关键区别在于理解正在讨论的是什么 Node.js 运行时。

你的应用程序运行时和你的 Action 运行时是不同的事物

考虑一个 PHP 项目,其工作流如下:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

  - name: Run tests
    run: vendor/bin/phpunit

应用程序是 PHP。但 actions/checkout 本身就是一个 JavaScript action。GitHub 使用捆绑在 Actions runner 中的 Node.js 运行时来执行它的 JavaScript。

该运行时与你工作流中安装的 Node.js 是独立的。同样,actions/setup-node 可以在后续的工作流命令中安装 Node 22,而 action 本身则使用元数据中声明的运行时执行。

这种区别解释了为什么 Node 20 的移除可能会影响 PHP、Python、Go、Java 等非 Node 项目。

具体发生了什么变化?

GitHub 在多年之前就宣布了 Node 20 的弃用,因为 Node.js 20 在 2026 年 4 月达到了生命周期结束。从 2026 年 6月开始,GitHub 默认将 Actions 切换到 Node 24。在迁移期间,用户可以用 ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION 暂时回到过时的运行时。这仅仅是一个迁移退路。

2026年9月23日,GitHub 从 GitHub Actions 运行器中移除了 Node 20,也移除了那个选择退出选项。如果你维护的 action 仍声明了 Node 20,GitHub 的建议是将其更新为 Node 24 并发布新版本。

首要审计:检查每一行中的 uses:

最简单的工作流审计从 .github/workflows 开始。搜索 uses: 并清点第一方和第三方 action。不要仅仅因为它还能运行就认为工作流是当前状态的。

对于每个 action,确定你工作流引用的版本是否是当前支持 Node 24 的稳定发行版。第三方 action 需要特别关注:更改大版本前请检查它们的发行历史。输入、默认值、认证机制和缓存行为可能独立于 Node 迁移而改变。

自定义 JavaScript action 需要不同的修复方法

如果你维护自己的 JavaScript action,请检查它的 action.yml 或 action.yaml。一个 JavaScript action 可能仍然包含:

runs:
  using: node20
  main: dist/index.js

运行时声明应该指向 Node 24:

runs:
  using: node24
  main: dist/index.js

仅仅修改这一行是不够的。请在 Node 24 下测试该 action,必要的时候更新依赖并重建已提交的 dist/ 包。否则消费者可能继续执行旧的生成 JavaScript,即使源码已经改变。

一种安全的迁移方式是更新开发环境、更新依赖、修改 runs.using,重建分布式 JavaScript,运行测试,在实际工作流中演练该 action,然后发布新版本。

自托管 runner 需要特别关注

GitHub 托管的 runner 由 GitHub 维护。自托管 runner 则不同。runner 应用包含了 JavaScript action 使用的 Node.js 可执行文件,这使得 runner 版本变得重要。基于 Node 24 的最新 action 发布需要足够新的 Actions Runner。

如果你的组织使用自托管 runner,请将它们的版本、操作系统和架构纳入迁移审计,而不是仅查看工作流的 YAML。过时的操作系统可能会成为隐藏的障碍,因为 Node 24 会改变支持的平台基准。

CodeQL 有它自己的迁移路径

使用 GitHub 代码扫描的仓库也应检查它们的 CodeQL 工作流。CodeQL Action v4 使用 Node.js 24 运行时。因此,高级 CodeQL 设置应检查是否存在过时的 github/codeql-action 引用,并按照 GitHub 现有的兼容性指南进行迁移。

一个有用的审计命令

在类 Unix 的开发机上,快速的第一步如下:

grep -R "uses:" .github/workflows

对于仓库内的自定义 action:

grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"

这些搜索不能证明兼容性,但提供了一个高效的清单。目标是回答三个问题:使用了哪些 action,固定了哪些版本,以及哪些自定义 action 仍然声明了过时的运行时?

应该将 action 固定到标签还是提交 SHA 上?

运行时迁移也是一个审查供应链卫生的好机会。像 vendor/action@v4 这样的引用可能被维护者移动,而完整的提交 SHA 则标识不可变的修订版。

对于安全性敏感的工作流,将第三方 action 固定到完整的提交 SHA 可以降低意外代码变更的风险。权衡是维护:更新则需要刻意的过程或依赖更新工具。

对特权 Pull Request 工作流要格外小心

更新旧 action 很重要,但工作流的安全模型更为重要。pull_request_target 可以运行,并提供对基础仓库的 token、密钥和缓存的访问权限。在这种特权工作流中检出攻击者控制的 Pull Request 代码可能会造成严重的供应链漏洞。

在审计工作流文件以适配 Node 24 时,同步检查它们的触发器和权限。现代运行时并不能让不安全的 workflow 变安全。

一份实用的迁移清单

首先列出 .github/workflows 中所有的 uses: 引用。查看发行说明后,升级过时的第一方 action。检查每一个第三方 action,看是否有被维护的 Node 24 兼容版本。搜索自定义 action 元数据中的 node20,迁移到 node24,重建包并进行测试。

对于自托管 runner,验证 runner 版本、操作系统和架构。审查 CodeQL 高级工作流。最后,演练重要的发布、计划任务和部署 workflow,以及默认的 CI 路径,因为很少使用的 job 是旧 action 版本容易存活的地方。

为什么这次迁移值得好好做

GitHub Actions 内部的 Node.js 运行时迁移看起来像是别人基础设施的问题。事实并非如此。action 是你的 CI/CD 系统中的可执行依赖项。它们可以构建发布包、处理凭据、上传制品并部署生产应用。

因此,GitHub 从 Node 20 迁移到 Node 24 是一个有用的提醒,即 CI 依赖具有与应用依赖相同的生命周期。

眼前的任务很直接:移除对过时 JavaScript action 的剩余依赖,以及在必要时更新自托管基础设施。更长期的观点更有价值:把 .github/workflows 当作持续维护的应用基础设施,而不是可以一次性写好后就遗忘的配置。

一个定期审计其 action、runner 版本、权限和第三方依赖的仓库,将更好地为下一次运行时转型做好准备——而且迁移之间将安全得多。