gh actions-lock 教程:用 lockfile 锁定 GitHub Actions 依赖
workflow 写 @v3,执行的代码可能随标签移动而改变。这篇说明 GitHub 的 workflow lockfile 怎么运作,并一步步用 gh actions-lock 上锁、看懂 diff、日常维护。
workflow 里的 uses: actions/checkout@v7 看起来是选了第 7 版,实际跑的却是 v7 标签当下指向的 commit。上游移动标签后,你的 workflow 一行没改,执行的代码却可能跟着变。
GitHub 在 2026-10-28 正式推出 workflow lockfile。gh actions-lock 把支持范围内的 action 解析成确切的 commit,记在 .github/workflows/actions.lock。纳入管理的 workflow,就按这份记录执行。
这样 workflow 里可以保留好读的版本号,真正要跑的代码也进了审查流程。不过,生成 lockfile 本身不代表已完成安全审查。
步骤根据 GitHub 官方资料整理,查证日期是 2026-11-13。来源是 GA 公告、Locking action dependencies in a repository’s workflows、Workflow dependency lockfiles,以及 gh-actions-lock v0.4.1 的 README与故障排除文档。工具持续更新,命令与选项以已安装版本的
gh actions-lock --help为准。
这篇处理的是“别人写的 action 被换掉”这种供应链风险。我在OWASP Agentic Top 10 检查表:AI 工作流十项风险与修法的 ASI04(供应链)简短提过用 lockfile 锁住第三方 action,这篇写出完整做法。
先认识几个词:
- GitHub Actions:GitHub 内建的自动化服务,代码一推上去,就能自动跑测试、构建、部署。
- repo(repository):GitHub 上存放项目代码的地方。
- workflow:放在 repo 的
.github/workflows/里的 YAML 配置文件,写明要自动做哪些事。 - action:workflow 里可以重复使用的现成步骤,例如负责“检出代码”的
actions/checkout。workflow 用uses:这一行指定要用哪个 action、哪一版。 - commit 与 SHA:commit 是某一次提交时的代码快照。SHA 是每个 commit 独一无二的编号,一长串字母和数字,内容只要改一个字,编号就不同。
- tag(标签):替某个 commit 取的好记名字,例如
v3.1.0。标签像一张贴纸,可以撕下来贴到别的 commit 上。 - lockfile(锁定文件):记录每个依赖“确切是哪一版”的文件。写过 JavaScript 的人可能看过
package-lock.json,概念一样。 - Dependabot:GitHub 内建的机器人,发现依赖有新版本时,会自动开 PR(请求合并变更的申请)帮你更新。
- gh:GitHub 官方的命令行工具(GitHub CLI)。
gh actions-lock是替它加上的扩展(extension)。
为什么 @v3 不一定是你审过的那一版
uses: octo-org/deploy-action@v3 的意思不是“用第 3 版”,而是“用 v3 这张贴纸现在贴着的那个 commit”。有权更新这个 tag 的人可以移动贴纸,范围取决于上游设置的 tag 保护规则。
平常这是作者发新版的方式,让 v3 跟着最新的 3.x 走。但作者的账号一旦被盗,攻击者也能用同一招,把贴纸贴到藏了恶意程序的 commit 上。你的 workflow 一行都没改,下次执行却跑了别人的程序。
这种事真的发生过,2025 年 3 月的 tj-actions/changed-files 就是一例。根据 GitHub 安全公告,攻击者回头修改了它的多个已有版本标签,全部指向同一个恶意 commit。这段程序会把 CI 里的敏感信息(例如 token、密钥)输出到 workflow 的执行记录(log)。
公告写的受影响期间是 2025 年 3 月 14 日到 15 日,使用这个 action 的 repo 超过 23,000 个。美国 CISA 也为这起事件(CVE-2025-30066)发了警示。
以往常见的做法,是把 action 直接固定到完整的 commit SHA。我这个网站的部署 workflow 就是这样写:
1
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
完整 SHA 可以避免跟着移动的 tag 换版,但不保证那个 commit 的内容安全。它也不好读,一长串编号看不出是哪一版,只能靠行尾的注释。注释还可能和 SHA 对不上,每次更新都要两个一起改。
workflow lockfile 换了一种做法。workflow 里继续写 @v7.0.1 这种好读的版本号,SHA 另外记在 lockfile 里。官方文档写得很直接,已纳入 lockfile 的 action 可以由 lockfile 固定 SHA,不必每一行都直接写 SHA。
但我不认为这表示可以先去掉现有的 SHA,再慢慢补 lockfile。要等 workflow 纳入 lockfile、审查并验证过,才去掉 SHA。
workflow lockfile 是什么、怎么运作
lockfile 就是 .github/workflows/actions.lock 这个文件。它记下每个 workflow 用到的 action 解析到哪一个 commit,执行时 GitHub 以它为准。
它由 gh actions-lock 自动生成,不要手动修改。每个 action 会记这几个字段:
ref:这个 commit 是从哪个标签或分支解析出来的,例如v3.1.0。commit:解析到的 commit,也就是真正会执行的代码。owner_id、repo_id:来源 repo 的数字编号。执行时用它确认,名字背后还是当初锁住的那个 repo。
被锁住的不只你直接写在 uses: 的 action。根据 GA 公告,action 自己再用到的其他 action(传递依赖)也会一起锁住。
一个 workflow 被纳入 lockfile 之后(官方称为 onboard,这篇我叫它“上锁”),根据概念说明,执行时有三条规则:
- 这个 workflow 用到的每个 action,都必须出现在 lockfile 里。
- 执行的是 lockfile 里记的那个 commit,不是标签现在指到的 commit。
- 那个 commit 必须在 action 自己的 repo 里,而且从记录的标签或分支追得到。只存在于 fork(别人复制出去的 repo)的 commit,或已经不在那个标签历史里的 commit,执行时会被拒绝。
所以标签被移动时,workflow 要么照跑锁定的那个版本,要么直接被挡下,不会悄悄改跑新的程序。
概念图:同一行 uses: octo-org/deploy-action@v3。左边没有 lockfile,执行时跟着标签走;右边有 lockfile,照跑锁住的 commit,那个 commit 若已不在标签的历史里,这次执行会被挡下。
谁可以用,要看三份资料:
| 资料 | 写的适用范围 |
|---|---|
| GA 公告 | GitHub Enterprise Cloud(含数据落地版本)、Team 与 Free |
| 操作与策略文档 | 适用方案栏仍标示 Enterprise Cloud |
| v0.4.1 README | 扩展支持 github.com 与 GHE.com |
我查阅时,GA 公告和操作与策略文档写的方案并不一致。实际能用哪些功能与策略,以你的 repo 设置为准。尤其不要把“生成得出 lockfile”当成“运行时已启用保护”。
步骤 0:先准备这些
装好 GitHub CLI 并登录。 照 GitHub CLI 官网安装,再执行下面这行登录:
1
gh auth login
扩展需要已登录的
gh。- 对 repo 有写权限。 官方文档写,有写权限就能创建 lockfile,不需要管理员权限。
先保存当前变更,另开工作分支。 工具会修改 workflow 和 lockfile,先确认当前状态:
1
git status --short安装工具后若想先看报告,可执行下面这行,它只检查、不写文件:
1
gh actions-lock --no-fix先开 Dependabot。 官方建议在生成 lockfile 之前,先让 Dependabot 管理 GitHub Actions 的版本。最基本的配置如下。已有
.github/dependabot.yml的话,把这个更新项目合并进现有配置,不要整份覆盖:1 2 3 4 5 6
version: 2 updates: - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly"
- 先审过每一行
uses:。 官方提醒,上锁前要先审过依赖。确认指向的都是仍在维护的当前版本,因为 lockfile 会把你写的版本原样锁住,旧版本锁起来还是旧版本。 - 确认有没有 action 允许清单。 有些组织只允许使用特定的 action(allowlist)。上锁之后匹配方式会改变,步骤 3 会说明。
步骤 1:安装 gh-actions-lock
1
gh extension install github/gh-actions-lock
这会安装当时最新的 release,而这篇是根据 v0.4.1 的文档写的。想固定使用这一版,安装时加上 --pin v0.4.1:
1
gh extension install github/gh-actions-lock --pin v0.4.1
--pin 指定的是 release tag,不是完整的 commit SHA。它也不代表工具通过了安全审查,工具来源仍要自己确认。
没有加 --pin 的一般安装,之后可以这样更新:
1
gh extension upgrade gh-actions-lock
装好后,我会先看一次说明。README 写,所有选项以这份说明为准:
1
gh actions-lock --help
步骤 2:生成 lockfile
在 repo 的根目录执行:
1
gh actions-lock
它会扫过 .github/workflows/ 底下每一个 workflow,把每个能解析的 action 固定到一个 commit。结果写进 .github/workflows/actions.lock。
官方建议一个一个 workflow 慢慢纳入。只锁一个 workflow 时,指定它的路径:
1
gh actions-lock .github/workflows/ci.yml
要注意,只有对整个目录执行时,才会清掉已删除 workflow 的旧记录。
步骤 3:看懂 diff 再提交
执行完后,我会先确认修改与新增了哪些文件,再看已跟踪文件的变更:
1
2
git status --short
git diff -- .github/workflows/
新建的 actions.lock 还没被跟踪,不会出现在一般的 git diff 里。要打开文件检查,或加入暂存区后用下面这行查看:
1
git diff --cached
主要看两处。
第一处,workflow 文件里的 uses: 写得更精确。 例如 octo-org/deploy-action@v3 可能被改写成 octo-org/deploy-action@v3.1.0。只有找得到指向同一个 commit 的完整版本标签时,工具才会这样改写,所以 commit 不变,不会因此升到别的版本。
想保留 @v3 的写法,执行时加上 --no-narrow。
第二处,新增的 actions.lock。 文件开头有几行注释,提醒这是自动生成、不要手动修改的文件。接着的内容结构大致如下(数值是示意):
1
2
3
4
5
6
7
8
9
10
version: 'v0.0.3'
workflows:
'.github/workflows/ci.yml':
- 'octo-org/deploy-action@v3.1.0'
dependencies:
'octo-org/deploy-action@v3.1.0':
ref: 'v3.1.0'
commit: '<commit SHA>'
owner_id: 1234567
repo_id: 7654321
version 是 lockfile 的格式版本,不是扩展的版本。workflows 列出每个 workflow 用到哪些 action,dependencies 记下每个 action 解析到的 commit。
审查时我会看两件事:
commit变了。 代表 workflow 之后会跑不同的代码。官方建议把它当成代码变更来审,去看上游改了什么。owner_id或repo_id变了。 这应该很少发生。官方建议先查清楚原因,再合并。
概念图:上方是 workflow 文件的改写,@v3 变成 @v3.1.0,指向同一个 commit;下方是新增的 actions.lock,以及 ref、commit、owner_id/repo_id 各代表什么。
有 action 允许清单的话,清单要跟着改。 官方文档特别提醒,workflow 上锁之后,允许清单匹配的是锁住的 commit SHA,不再是标签。像 actions/checkout@v6 这种写死标签的项目会对不上,有两种改法:
- 改成对应的完整 commit SHA。
- 由管理员改用通配符。范围要限制在可信的 owner/repo,不要为了消除错误就整个放宽。
清单可能设在 repo、组织或企业层级,不确定的话先问管理员。
确认没问题,就把 actions.lock 和改写过的 workflow 一起提交。官方另外建议把 .github/workflows/actions.lock 加进 CODEOWNERS(指定哪些文件要由谁审核的配置文件)。
CODEOWNERS 本身不会挡下合并,要搭配分支保护或 ruleset 开启“需要 code owner 批准”才有效。workflow 文件与 CODEOWNERS 也要纳入保护,否则仍可能有人直接去掉检查,或改用其他 action。
步骤 4:日常维护
上锁不是做一次就结束,我认为下面几件事决定它能不能长期有效。
改了 uses: 就重新执行。 新增 workflow,或在既有 workflow 增删 action 时,再跑一次:
1
gh actions-lock
Dependabot 会一起更新。 对已上锁的 workflow,Dependabot 开版本更新的 PR 时,会在同一个 PR 里重新生成对应的 lockfile 记录,不需要额外配置。但它只处理已上锁的 workflow。还没上锁的,它照旧只改 workflow 文件,也不会替你把新的 workflow 纳入 lockfile。
让 CI 检查 lockfile 有没有过期。 gh actions-lock --verify 只检查、不改文件。缺少必要锁定记录、验证失败这类阻挡性问题,会让它以错误结束,所以适合设成 PR 必须通过的检查。
gh-actions-lock 的 repo 提供了 verify-lockfile.yml 示例。下面这份是我以它为基础改写的版本,把扩展固定在这篇对照的 v0.4.1,适用于 github.com 上一般的 PR 检查:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# Fails when .github/workflows/actions.lock is out of sync with the
# workflows or a locked pin no longer verifies upstream.
name: verify-lockfile
on:
pull_request:
push:
branches:
- main
permissions:
contents: read
jobs:
verify:
runs-on: ubuntu-latest
env:
GH_TOKEN: ${{ github.token }}
steps:
- uses: actions/checkout@v7.0.1
with:
persist-credentials: false
- run: gh extension install github/gh-actions-lock --pin v0.4.1
- run: gh actions-lock --verify
几个重点:
on:每个 PR,以及推到main时都会检查。permissions: contents: read:只给读取权限,这个检查不需要改任何东西。persist-credentials: false:checkout 完不把 Git 凭据留在 Git 配置里。但 job 仍通过GH_TOKEN提供 token 给工具查询 GitHub,并不是整个 job 都没有 token。--pin v0.4.1:指定扩展的 release tag,让每次安装的版本与本文对照的一致。这个下载来的二进制工具不归 workflow lockfile 管,lockfile 不会锁住它的内容。
gh actions-lock --verify 的退出码有三种:
| 退出码 | 意思 |
|---|---|
| 0 | 没有阻挡性错误,仍可能有警告 |
| 1 | 有阻挡性问题 |
| 2 | 工具本身出错,例如选项错误、lockfile 读不了或 token 被拒绝 |
检查通过,不等于所有依赖都已审查或没有风险。
README 提醒,把这份文件复制进 repo 之后,要再跑一次下面这行,让这个负责检查的 workflow 自己也上锁:
1
gh actions-lock
另外还有 --verify-local。它不连网,只检查每一行 uses: 在 lockfile 里有没有记录,适合提交前快速检查。它不验证来源,不能取代 --verify。
工具也不会替你修正权限不足、网络错误或 API 限流。遇到这些情况,先排除问题再重跑,不要把“无法验证”当成“通过”。
GHE.com 的 token 要另外看。 根据 v0.4.1 README,GHE.com tenant 的 GITHUB_TOKEN 不能拿去查 github.com 上的公开 action。本地可以另外登录 github.com,CI 则按文档另外提供 GH_ACTIONS_LOCK_GITHUB_COM_TOKEN。
这个 token 只用来查询公开 repo,不需要写权限。不要为了避开限流而多给权限。
标签或分支移动了,看种类处理。 下表是扩展在检查与维护时的行为,workflow 实际运行时,runner 还会另外验证锁定记录。
根据 v0.4.1 故障排除文档,main、v4 这类引用的 ref-moved 警告只出现在 JSON 输出,也不会让退出码变成失败。要看这类信息,可执行:
1
gh actions-lock --verify --json
| 你写的引用 | 发生什么 | 怎么做 |
|---|---|---|
分支或部分版本,例如 main、v4 | 旧 commit 仍可由上游历史验证时,保留旧锁定;JSON 报告 ref-moved 警告 | 看过上游改了什么,要跟上就执行 gh actions-lock --relock |
完整版本标签,例如 v3.1.0 | 标签必须指向锁住的 commit,移动了就报错 | 先弄清楚标签为什么被移动,再执行 gh actions-lock --relock,或改写 uses: 那一行 |
| 历史被改写,例如上游 force push 之后,锁住的 commit 不在历史里了 | 报错,--relock 也修不好 | 先排除 lockfile 被误改,再审查上游历史与新 commit;确认要采用后,才执行 gh actions-lock --accept-moved |
概念图:三种引用移动的情况与对应命令。第三种的 --accept-moved 只能在人工确认后使用,不要放进自动化。
--accept-moved 接受的是什么? 它表示你已检查上游历史,愿意信任新的 commit,不是让已无法验证的旧 commit 继续过关。历史被改写可能是正常维护,也可能是供应链攻击或 lockfile 被误改。工具无法替你判断是哪一种,所以会先停下来。
这个选项只处理 workflow 自己直接引用的依赖。问题若藏在第三方 composite action 里,要升级、替换或停止使用该 action,不能靠同一个选项全部放行。
--relock 也会改变要执行的 commit,同样要审查差异。我不会把这两个选项当成“CI 出错就自动补上”的解法;官方则明确要求不要在自动化里使用 --accept-moved。
不要删掉 lockfile。 README 提醒,锁住的引用会一直沿用。删掉重新生成,所有引用都会重新解析成“现在指到的 commit”,等于重新相信一次上游。
文件坏了,按这个顺序处理:
flowchart TD
A[lockfile 坏了] --> B[比对差异,另存变更]
B --> C{可信分支的 lockfile 正常?}
C -->|正常| D[从可信分支还原]
D --> E["重跑 gh actions-lock"]
E --> F[检查差异,加回暂存区]
C -->|也坏了| G[备份后重建]
G --> H[逐项审查每个依赖]
比对的是工作目录、暂存区与可信版本之间的差异,要保留的变更先另外存好。还原的命令如下。restore 会覆盖工作目录中的 lockfile,但不会更新暂存区,执行前请确认没有需要保留的未提交内容:
1
2
3
git fetch origin
git restore --source=origin/main --worktree -- .github/workflows/actions.lock
gh actions-lock
默认分支不叫 main 的话,把第二行的 origin/main 换掉。重建时每个依赖都会重新解析,所以只在可信分支上的 lockfile 也坏了时才用,不要把它当成一般的排错手段。
步骤 5:处理本地 action(./)
有些 workflow 会用 repo 自己里面的 action,写成 uses: ./.github/actions/setup 这样。./ 路径跑的是执行机器上当时检出的文件,所以扩展没办法锁住它,也看不到它里面又用了哪些 action。
如果这个本地 action 还用了别的 action,gh actions-lock 会报告 local-action 错误,而且什么都不写。处理方式有两种:
flowchart TD
A["local-action 错误,不写文件"] --> B{怎么处理}
B -->|建议| C["--migrate-local-actions"]
C --> D["./ 改写成 $/"]
D --> E[逐行检查改写结果]
B -->|"保留 ./"| F["--ignore-local-actions"]
F --> G{同一 workflow 有记录?}
G -->|有| H[可能正常执行]
G -->|没有| I[job 跑到那步才失败]
改成 $/(建议)。 执行下面这行:
1
gh actions-lock --migrate-local-actions
它会把 workflow 和 repo 内 action.yml 里的 uses: ./… 改写成 uses: $/…。
$/ 的意思是“在这个 workflow 所在的 commit,执行 repo 自己的 action”。因此它本身跟着 workflow 的 commit 固定,不需要在 lockfile 另外记一笔;它引用的远程 action 则可以记进 lockfile。
这不只是换个路径写法。原本的 workflow 若会先 checkout 别的 ref 再执行 ./ action,改成 $/ 后,跑的会是 workflow 所在 commit 的版本。两者的实际执行内容可能不同,所以改写后每一行都要看过。
保留 ./。 改加 --ignore-local-actions,错误会降为警告。本地 action 若只含 run:,或它用到的 action 已记在同一个 workflow 的锁定清单里,仍可能正常执行。
代价是缺少同一个 workflow 的对应记录时,job 要到那一步才失败。错误信息类似 lockfile missing pin for octo-org/setup-tool@v2.0.0,而且到那时,前面的步骤已经跑过了。
进阶:要求每个 workflow 都要上锁
前面的步骤让“已上锁的 workflow”跑锁住的版本,但挡不住有人新增一个没上锁的 workflow。想强制所有 workflow 都上锁,可以用 Require lockfile 策略(说明)。
企业、组织或 repo 的管理员可以在 Actions 策略里开启它,作为 workflow 的执行保护。它有两种状态:
| 状态 | 行为 |
|---|---|
| Evaluate | 只记录、不挡,仅限 GitHub Enterprise Cloud |
| Active | 挡下范围内所有还没上锁的 workflow,包括只有 run:、没有 uses: 的 workflow,即使同一个 repo 的其他 workflow 已经上锁 |
改成 Active 之前,先在每个目标 repo 跑过下面这行,或在 Evaluate 状态下查看 Policy insights:
1
gh actions-lock --verify
开了策略之后,--verify 的检查仍然要留着。--verify 在 PR 阶段就提醒作者 lockfile 过期了,策略则在执行时才挡下没有有效 lockfile 的 workflow:
flowchart LR
A[修改 workflow] --> B["提交前 --verify-local"]
B --> C["PR 上 CI 跑 --verify"]
C --> D[审查 lockfile diff]
D --> E[合并]
E --> F{workflow 已上锁?}
F -->|是| G[runner 验证,不符就挡下]
F -->|否,策略 Active| H[执行被挡下]
F -->|否,未开策略| I[照标签执行]
组织若已开“action 必须固定到完整 SHA”的策略,它和 Require lockfile 是各自独立的检查,两个都要通过。已上锁的 workflow,就算文件里没写 SHA,也能同时通过两者。
lockfile 管不到的地方
上锁之前,先知道这些限制:
- reusable workflow 不会被锁。 reusable workflow 是可被其他 workflow 调用的 workflow,在 job 层级用
jobs.<job_id>.uses调用。它不在 lockfile 里,要另外固定到完整的 commit SHA;它自己用的 action,由它所在 repo 的 lockfile 负责。开了 Require lockfile 策略时,被调用的 workflow 若没有在自己的 repo 上锁,这次执行会被挡下。- container image 不会被锁。 README 写,
docker://步骤与 job 的container:、services:都不锁。Docker action 的 image/Dockerfile 基础镜像也不锁。没写@sha256:digest 的 image 会被列为警告。- 只管 action 的代码。 传给 action 的输入、secrets、执行机器的系统镜像,以及
run:、安装脚本另外下载的内容,都不在它的范围内。锁住 action 也不会限制它的文件、网络或 token 权限。- 不判断安全。 lockfile 只确保跑的是你锁定的那个版本,不判断那一版有没有问题。官方提醒上锁前要先审过依赖,因为锁定的那个版本若本来就有问题,lockfile 会很忠实地一直跑它。
- 检测不到回退。 README 提醒,如果有人在 lockfile 里,把
v4、main这类会移动的引用改回它历史上较旧的 commit,工具检测不到。lockfile 的 diff 要有人看,或改用完整版本标签。- 扩展不支持 GitHub Enterprise Server。
什么情况怎么做
| 我想… | 怎么做 |
|---|---|
| 第一次上锁 | 先开 Dependabot、检查 uses:;装好扩展,在 repo 根目录执行 gh actions-lock;看懂 diff 再提交 |
| 先只锁一个 workflow | gh actions-lock .github/workflows/<文件名>.yml |
保留 @v3 的写法 | 执行时加 --no-narrow |
新增或修改了 uses: | 再执行一次 gh actions-lock |
| 在 PR 检查 lockfile 有没有过期 | 加入 verify-lockfile.yml 跑 gh actions-lock --verify,并设成必须通过的检查 |
收到 ref-moved 警告 | 看过上游变更,要跟上就执行 gh actions-lock --relock |
| 完整版本标签被移动 | 先弄清楚原因,再 gh actions-lock --relock 或改写 uses: |
| 锁住的 commit 不在上游历史里 | 人工确认后才 --accept-moved,不要放进自动化 |
有本地 action(./) | --migrate-local-actions 改成 $/ |
| 组织有 action 允许清单 | 改成对应的完整 SHA,或经管理员确认的最小范围通配符 |
| 要求每个 workflow 都上锁 | 管理员配置 Require lockfile 策略;Enterprise Cloud 可以先用 Evaluate 观察,再改成 Active |
| lockfile 坏掉 | 从 git 还原后再执行 gh actions-lock,不要删掉重新生成 |
常见错误与处理
- 手动改 lockfile: 扩展会拒绝
ref和 workflow 引用对不上的记录。要改就改 workflow,再重新执行gh actions-lock。 - 上锁后,workflow 被允许清单挡下: 先确认是否因锁定后改以 SHA 匹配。改用对应的完整 SHA 或经管理员审查的有限范围规则,不要全面放行。
- 出现
local-action错误: 本地 action 里用了其他 action。用--migrate-local-actions改成$/,或加--ignore-local-actions,但要承担执行到一半失败的风险。 - job 跑到一半出现
lockfile missing pin for …: 保留./的本地 action 用了 lockfile 没记到的 action。改成$/最省事。 - 新的 workflow 没被 Dependabot 纳入: Dependabot 不会替你上锁新 workflow,自己执行一次
gh actions-lock。 - Dependabot 更新后 lockfile 没动: 先确认该 workflow 已纳入管理,再看 PR 差异与
--verify输出。只看文件有没有变动,不能判断这次更新是否完整。 - 在 CI 里自动加
--accept-moved: 拿掉。这正是 lockfile 要拦下的情况。 - 以为 reusable workflow 也锁住了: 没有,
jobs.<job_id>.uses要另外固定到完整 SHA。 - 检查成功,却没有看到引用移动警告: v0.4.1 的部分
ref-moved信息只在 JSON 输出中,且警告不会让退出码失败。用--verify --json查看。 - 删掉 lockfile 重新生成: 所有引用会重新解析成现在指到的 commit。改从 git 还原。
结论与下一步
我建议按这个顺序开始:先开 Dependabot,执行 gh actions-lock,看懂 diff 再提交,然后用 --verify 让 CI 帮你盯着。标签被移动时,停下来看一眼,不要让自动化替你按下 --accept-moved。
我会先锁负责发布的 workflow。照npm Trusted Publishing 配置教程:发包不再放长期 token配置后,发布流程不再需要长期 token。但 workflow 跑的 action 若被换掉,一样能发出有问题的版本。
- 开了 Trusted Publishing 还不够:npm 发布流程也要上锁:替发布流程本身加上批准与审查关卡。
- 用 GitHub Actions 加 AI Agent 自动化审查:以本站 PR 为例:替同一条 CI 流程加上自动化审查。
- OWASP Agentic Top 10 检查表:AI 工作流十项风险与修法:更完整的 AI 工作流风险检查。
