docker+machine模式GitLab Runner交互式Web终端配置问题排查

你遇到的问题通常由以下配置疏漏导致，可逐项排查：

• 补全advertise_address的协议前缀
  会话服务器地址必须携带HTTP/HTTPS协议头，仅填写IP+端口格式会导致连接失败。正确配置示例：

  [session_server]
    listen_address = "[::]:8093"
    advertise_address = "http://192.168.xxx.xxx:8093" # 未配置SSL时加http前缀，配置SSL则改为https
    session_timeout = 1800
  

• 确认GitLab主实例的连通性权限
  会话连接的发起方是GitLab主服务而非worker节点，需要在AWS安全组中放开GitLab主实例到Runner管理节点8093端口的入站规则，同时检查Runner节点本地的iptables、firewalld等系统防火墙是否放行该端口。
• 验证会话服务监听状态
  在Runner管理节点执行命令ss -tulnp | grep 8093，确认gitlab-runner进程确实在监听8093端口，若没有监听输出需重启gitlab-runner服务后再次验证。
• 检查版本兼容性
  若GitLab主实例的大版本与GitLab Runner大版本差值超过1，可能出现会话协议不兼容的问题，建议将Runner版本调整至与GitLab主实例大版本一致。
• 查看浏览器控制台报错
  打开调试页面时按F12调出浏览器开发者工具，查看Console标签页的报错信息，通常WebSocket连接失败、跨域、证书信任问题都会在前端控制台明确提示，这类错误不会上报到Runner任务日志中。

内容的提问来源于stack exchange，提问作者Alexander Pravdin