Ubuntu 20.04安装GitHub Action Runner Controller失败求助

1. 抓取运行日志定位核心问题 #

容器启动后立刻查看日志，精准定位报错点：

docker logs <容器ID/名称>

重点关注依赖缺失、权限报错、网络连接失败这类关键信息，这是排查的首要步骤。

2. 补全系统兼容依赖 #

Ubuntu 20.04预装库版本低于22.04，官方Dockerfile可能遗漏部分兼容项：

• 对比Ubuntu 22.04环境的libssl、libicu版本，确保Ubuntu 20.04上的对应库版本符合Runner要求
• 手动安装潜在缺失依赖，比如liblttng-ust0、zlib1g-dev、libkrb5-3等

3. 调整容器运行权限 #

GitHub Runner要求非root用户运行，Ubuntu 20.04的用户权限逻辑可能存在差异：

• 修改Dockerfile中用户创建步骤，确保Runner用户对工作目录拥有读写权限
• 启动容器时指定正确的用户ID，避免因权限不足触发Runner安全限制

4. 降级Runner版本适配系统 #

最新版Runner可能已停止对Ubuntu 20.04的完全支持，可尝试：

• 切换到官方明确兼容Ubuntu 20.04的版本（如2.300.x系列），修改Dockerfile中的Runner下载链接版本号
• 验证该版本在Ubuntu 20.04容器中的运行稳定性

5. 手动部署对比验证 #

跳过Docker，直接在Ubuntu 20.04主机上手动部署Runner：

1. 下载对应版本的Runner包并解压
2. 执行注册命令完成配置
3. 启动Runner并观察状态
   如果手动部署正常，说明问题出在Docker镜像的构建或配置环节，可逐步对比Dockerfile与手动步骤的差异

内容的提问来源于stack exchange，提问作者Gabriel Ce