掌握GitHub Actions 教学工作区 · 课程 0005 · 约 8 分钟 · 前置:0002 · workflow 的骨架 · 2026-10-06

密钥、权限与审批

你能做到:说清流程跑起来时手里有哪三样东西(令牌、密钥、权限), 以及为什么来自 fork 的合并请求碰不到你的密钥。

1 | 三样东西

名称是什么从哪来
GITHUB_TOKEN平台每次运行自动发的临时令牌,用来读写这个仓库自己的东西不用你配,平台注入;权限用 permissions 收敛
secrets你存进仓库 / 组织 / 环境里的敏感值(接口密钥、口令)在仓库设置里加;流程里用 ${{ secrets.名字 }} 取
permissions这个令牌到底能干什么(读代码、写评论、发版本……)写在工作流或作业里

2 | 令牌:默认权限偏宽,要自己收紧

permissions:
  contents: read        # 默认给整套令牌;这里明确只要「读代码」

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: gh issue list      # 需要 issues: read 才能查;没给就会 403

原则简述:需要什么就给什么。 只读代码的检查任务,就把 contents 设为 read; 要往 PR 上写评论再加 pull-requests: write。 权限写宽了,最坏情况是「某个被引入的第三方 Action 拿着它替你做别的事」。

3 | 密钥:三个限制最要紧

分层也要想清楚:仓库级的密钥所有分支的流程都能用;环境级的只在指定环境下可用(配合审批), 更细。同名时环境级优先。

4 | 审批:必须有人点一下才继续

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production     # 这个环境配了「必须人工批准」
    steps:
      - run: ./deploy.sh

在仓库设置里给 production 这个环境配上一到多个必需审阅人之后, 流程跑到这个作业会停下来等人点批准,不点就一直等着。 这正是持续交付与持续部署的分界:多了这道人工确认,就是交付;没有,就是自动部署。

5 | 常见误解

6 | 练习

三题自测,每题只有一个正确选项;选完立刻看到解释。

1. 一个只跑测试、不需要写回仓库的作业,权限该怎么写?

对。测试要能读代码,但不需要写任何东西;contents: read 正好。权限给多了,第三方 Action 就有了不该有的能力。

2. 为什么来自 fork 的合并请求拿不到仓库的密钥?

对。这是刻意设计的防线:任何人都能 fork 你的公开仓库提 PR,如果那时能拿到密钥,等于把密钥交出去。

3. 给作业挂上一个配了必需审阅人的环境,会得到什么效果?

对。这正是「持续交付」与「持续部署」的分界线:验证通过之后要不要有人点一下。要,就是交付。