如何在GitLab Runner上调试作业?交互式Web终端配置相关疑问
配置修改实操
首先把[session_server]配置段添加到config.toml的顶层位置(与concurrent、check_interval同级,不要嵌在[[runners]]块内部),完整的修改参考结构如下:
concurrent = 1 check_interval = 0 [session_server] listen_address = "[::]:8093" advertise_address = "你的实际可达地址:8093" session_timeout = 1800 [[runners]] name = "XXX" url = "https://URL.TO.SELF.HOSTED.GITLAB.INSTANCE" token = "XXX" executor = "docker" builds_dir = "/build" cache_dir = "/cache" [runners.custom_build_dir] [runners.cache] [runners.cache.s3] [runners.cache.gcs] [runners.cache.azure] [runners.docker] tls_verify = false image = "ubuntu:18.04" privileged = false disable_entrypoint_overwrite = false oom_kill_disable = false disable_cache = false volumes = ["/cache"] shm_size = 0
改完之后重启GitLab Runner服务即可生效。
核心疑问解答
1. advertise_address的取值判断逻辑
这个字段的本质作用,是把Runner的会话服务地址返回给访问GitLab的用户浏览器,由浏览器直接连接Runner的会话服务,不是给Runner自身使用的配置。
判断取值的唯一标准:
- 你日常访问GitLab的设备,能够直接通过这个地址的对应端口访问到Runner的8093服务,就符合要求。
- 常见场景对应取值:
- 内网部署Runner:填Runner的内网固定IP+8093端口
- 公网部署Runner:填Runner的公网固定IP或绑定的公网域名+8093端口
- 绝对不要填
127.0.0.1或localhost,否则浏览器会尝试连接用户自身设备的8093端口,完全无法建立会话。
2. 填写IP与主机名的差异、安全性影响
两者没有功能上的本质区别,差异仅来自DNS解析的可达性:
- 填写主机名的适用前提:所有访问GitLab的用户设备,都能通过本地DNS把这个主机名解析成Runner的正确IP地址。如果没有配套的DNS服务,主机名根本无法被解析,自然会出现连接失败的问题——这也是社区里推荐直接填IP的核心原因,本质是跳过了DNS解析的配置坑,不是IP格式比主机名更“合规”。
- 安全性层面,两者不存在优先级差异:
- 如果Runner部署在内网,不管填IP还是主机名,都不会额外引入安全风险
- 如果Runner部署在公网,不管填IP还是主机名,只要8093端口对全互联网开放,都存在被恶意扫描的风险,风险来源是端口暴露范围,和填写的地址格式无关
- 加固建议:在Runner所在服务器的防火墙上做访问控制,仅允许GitLab实例的IP段、企业办公网IP段访问8093端口,不要对任意来源开放。
3. TLS证书的相关注意事项
Runner自动生成的TLS证书为内置自签名证书,已经可以实现会话传输链路的加密,不需要额外安装组件即可使用。需要注意两点:
- 因为自签名证书没有被公共CA机构信任,部分浏览器会弹出安全提示,这属于正常现象,不会影响会话的实际加密效果,可以正常使用终端功能
- 如果有等保、合规类要求,可以自行准备受信任的TLS证书,在
[session_server]段增加tls_cert_path和tls_key_path配置项,指定证书和私钥的路径即可替换,不需要其他额外操作
相关学习资料推荐
- 《GitLab CI/CD实战》:覆盖Runner配置、作业调试、交互式终端开通的全流程操作,适配中小团队的落地场景
- 《容器化持续交付实践》:包含Docker执行器下的Runner网络打通、安全加固的实操内容,适合生产环境部署参考
- 你部署的GitLab实例内置的帮助文档:可以直接在实例的帮助中心找到Runner高级配置的全部说明,不需要访问外部站点
内容的提问来源于stack exchange,提问作者desa
相关产品推荐
相关产品推荐

