← 返回首页|安全博客

GitHub Actions锁文件上线:固定CI依赖防投毒

📅 2026-11-15

一、可移动的标签:问题不在代码,而在引用

GitHub Actions 的流水线里,动作依赖通常写成 uses: 组织/仓库@v3,或者干脆写 @main。这一步看起来只是选版本,但运行时 GitHub 会把标签或分支解析成它当时指向的那个提交:你评审时看到的代码,和半夜跑起来的,可能不是同一份。

标签是可以被改指的。上游维护者的账号一旦被攻破,攻击者不需要动你仓库里的任何一行配置,只要把他自己的 v3 重新指向一个恶意提交,你的流水线下次触发就会执行它。

2025 年 3 月就发生过这样一次:tj-actions/changed-files 的 v1 到 v45.0.7 全部标签被改指向一个恶意提交 0e58ed8,恶意代码从运行器内存里把凭据倒出来,直接打进工作流日志。这个动作被两万三千多个仓库引用,CISA 在 3 月 18 日把它列入已知被利用漏洞清单,编号 CVE-2025-30066。

过去的老办法是把提交 SHA 钉死在 YAML 里:管用,但可读性差、升级全靠人工,还管不到动作自己再调用的传递依赖。

二、锁文件怎么运作:一次解析,长期跑同一个提交

GitHub 在 2026 年 10 月 14 日推出工作流依赖锁文件预览,10 月 28 日转为正式可用,覆盖免费版、Team、企业云以及企业云数据驻留版本。思路和软件包管理的 lockfile 一样:工作流里继续写可读的 v3,运行时执行锁文件里记录的那个提交。

锁文件固定放在仓库的 .github/workflows/actions.lock,由 GitHub CLI 扩展 gh actions-lock 生成,官方要求不要手工编辑。用法很简单:先 gh extension install github/gh-actions-lock,然后在仓库根目录执行 gh actions-lock,它会扫描 .github/workflows/ 下所有工作流,把每个可解析的动作连同传递依赖一起钉到提交上;只接入单个工作流就传路径,例如 gh actions-lock .github/workflows/ci.yml。

文件里分两段:workflows 记录哪个工作流用了哪些依赖,dependencies 记录每条引用解析到的 ref、commit,以及 owner_id 和 repo_id。后两个数字身份用来在运行时确认仓库还是你当初锁的那个,防止有人用同名账号换个仓库顶上来。

接入是逐工作流的。一旦接入,该工作流用到的每个动作都必须在锁文件里,运行的就是记录的提交;并且这个提交必须能从锁文件里记的标签或分支走到,只存在于 fork 里、或者已从该分支不可达的提交会被直接拒绝执行。

配套还有三件事:Dependabot 打开动作版本更新的 PR 时,会在同一个 PR 里重写锁文件对应条目,不需要额外配置;管理员可以用 Require lockfile 策略强制全组织接入;gh actions-lock --verify 只检查锁文件是否过期、不改任何文件,适合放进流水线当门禁。

三、四处边界:它防的是被换掉,不是本身有问题

官方文档写得很坦白:锁文件能防止依赖被意外更改,但不判断依赖是否安全。恶意动作锁进锁文件,仍然是恶意动作。锁之前该审的代码、该查的权限,一样都不能省。

第二处边界是可复用工作流。jobs 里通过 uses 调用的 reusable workflow 不在锁文件覆盖范围内,必须自己引用完整提交 SHA。而可复用工作流的依赖由定义它的仓库的锁文件负责,所以在用组织级共享流水线的话,那个仓库要先上锁,否则覆盖面是虚的。

第三处是构建输入。锁文件只管动作代码,不管输入参数、密钥和运行器镜像。镜像从 ubuntu-latest 悄悄变到新版本、密钥被替换,锁文件一无所知。

第四处是本地路径动作,uses 写成 ./xxx 这类永远不会被锁,因为它本来就在你自己的仓库里,由代码评审兜底。

四、青海单位的落地顺序

先盘点再动手。把仓库里所有第三方动作列出来,标出哪些用的是可移动引用,哪些仓库跑的是等保三级系统、医疗或政务数据。这些优先上锁,其余的排队。

本周能做完的四步:装扩展跑一次 gh actions-lock,把生成的锁文件和改动一起提交评审;把 gh actions-lock --verify 加进流水线,让锁文件过期变成红灯;对高敏仓库打开 Require lockfile,避免有人新加工作流绕过;开启 Dependabot 的动作更新,让升级有单一入口。

同时补三件锁文件管不到的事:把令牌权限收到最小,默认给只读内容权限,按工作流单独放权;凭据不要出现在日志里,tj-actions 那次攻击正是靠日志把密钥带出去;生产部署与拉取请求触发的构建分开,外部提交的流水线不接触生产密钥。

对本地集成商来说,这套东西是个低成本交付项:给客户做的流水线模板里带上锁文件、引用审计和令牌最小权限,既是可核查的交付物,也能对上等级保护里开发运维和供应链相关的要求。

© 2026 西宁惠康电子有限公司 | 青海·西宁