Github Actions自托管运行器：如何为docker create添加自定义选项？

针对你提到的痛点（修改运行器会被自动更新覆盖、替换系统Docker脚本影响全局），这里有几个更优雅且低侵入的解决方案：

1. 作业级配置：利用Workflow的container.options字段（最推荐） #

这是GitHub官方支持的原生方式，完全不需要修改自托管运行器本身，所有配置都在你的Workflow文件中定义，每个作业可以独立设置，不会影响其他作业或系统用户。

举个例子，如果你需要给作业容器添加--cap-add=SYS_ADMIN和--cap-add=NET_ADMIN选项，只需要在Workflow的作业配置里加上container.options：

jobs:
  special-test:
    runs-on: self-hosted
    container:
      image: your-test-image:latest  # 替换成你实际使用的镜像
      options: --cap-add=SYS_ADMIN --cap-add=NET_ADMIN  # 这里添加你的自定义Docker选项
    steps:
      - name: Run special tests
        run: |
          # 这里执行你的特殊测试逻辑

当作业运行时，GitHub Actions会自动把这些options参数追加到docker create命令中，你可以从作业日志里看到最终的容器启动命令包含了你添加的自定义选项。

这个方案的优势：

• 完全原生支持，无需修改任何运行器配置
• 作业级隔离，不同作业可以设置不同的Docker选项
• 不会被运行器的自动更新覆盖，配置随Workflow代码版本化管理

2. 全局配置：通过自定义启动脚本传递环境变量（适合全局统一配置） #

如果你需要给自托管运行器上的所有作业容器都添加相同的自定义选项，可以通过环境变量传递，同时避免修改官方的运行器文件（防止更新覆盖）。

步骤如下：

1. 在自托管运行器的目录下，创建一个自定义的启动脚本（比如start-runner-with-options.sh），内容如下：

#!/bin/bash
# 设置全局的容器自定义选项
export ACTIONS_RUNNER_CONTAINER_OPTIONS="--cap-add=SYS_ADMIN --cap-add=NET_ADMIN"
# 启动官方的运行器脚本
./run.sh

2. 给脚本添加执行权限：chmod +x start-runner-with-options.sh
3. 以后用这个自定义脚本启动自托管运行器，而不是直接运行./run.sh

这样，运行器在启动作业容器时，会自动读取这个环境变量，并把对应的选项追加到docker create命令中。

这个方案的优势：

• 全局生效，无需每个Workflow都单独配置
• 自定义脚本独立于官方运行器文件，不会被自动更新覆盖
• 不影响系统其他用户的Docker使用

3. 进阶方案：自定义Runner包装器（适合复杂场景） #

如果上述方案满足不了你的需求（比如需要动态根据作业内容调整选项），可以编写一个简单的Runner包装器脚本，替代官方的run.sh，在其中根据作业的元数据动态添加Docker选项。不过这个方案需要更多的开发维护成本，一般推荐优先使用前两个方案。

内容的提问来源于stack exchange，提问作者Sebastian Freitag