Mac部署Jenkins localhost可访问 局域网IP访问报ERR_ADDRESS_UNREACHABLE
故障排查与修复
localhost可访问但局域网IP报ERR_ADDRESS_UNREACHABLE,核心原因是Jenkins默认仅绑定了本地回环地址127.0.0.1,没有监听对外网卡的8080端口,所有来自局域网IP的请求根本不会被Jenkins接收。你看到的反向代理报错是连带问题——你配置的Jenkins URL是局域网地址,但服务实际没在这个地址上提供服务,自然校验失败。
你当前的Jenkins URL配置参考:
第一步:确认端口监听状态
打开Mac终端执行命令:
lsof -i :8080
查看输出结果的NAME列:
- 如果显示
localhost:8080或127.0.0.1:8080,证明确实是仅绑定了回环地址,按下面步骤修改 - 如果显示
*:8080,说明已经监听所有地址,直接跳转到防火墙检查步骤
第二步:修改Jenkins监听地址
根据你部署Jenkins的方式选对应操作:
- Homebrew安装(Mac最常见部署方式)
- 先停止运行中的Jenkins服务:
# LTS长期支持版执行这个 brew services stop jenkins-lts # 如果你装的是最新非LTS版,执行brew services stop jenkins - 打开对应配置文件,根据芯片选路径:
- Intel芯片Mac:
/usr/local/opt/jenkins-lts/homebrew.mxcl.jenkins-lts.plist - Apple Silicon(M1/M2/M3系列)Mac:
/opt/homebrew/opt/jenkins-lts/homebrew.mxcl.jenkins-lts.plist
- Intel芯片Mac:
- 在文件中找到
httpListenAddress配置项,把对应的字符串值从127.0.0.1改成0.0.0.0,代表监听所有网卡的入站请求,保存文件。 - 重启Jenkins服务:
brew services start jenkins-lts
- 先停止运行中的Jenkins服务:
- 直接运行war包部署
启动时增加监听地址参数即可,不要直接用默认启动命令:java -jar jenkins.war --httpListenAddress=0.0.0.0 --httpPort=8080
第三步:检查Mac防火墙配置
打开「系统设置」→「网络」→「防火墙」,确认两个点:
- 要么临时关闭防火墙测试局域网访问是否恢复
- 要么在防火墙的入站规则列表里,把Jenkins相关程序设置为「允许入站连接」
第四步:修复反向代理提示
等你能正常通过http://192.168.0.155:8080打开Jenkins页面后,处理红色提示:
- 进入「Manage Jenkins」→「Configure System」页面
- 找到Jenkins URL配置项,确认值为
http://192.168.0.155:8080/,注意末尾的斜杠不能丢 - 保存配置后刷新页面,红色的反向代理报错就会消失
如果你没有主动安装配置Nginx、Apache这类代理服务,完全不需要额外研究反向代理相关概念,这个报错只是Jenkins的URL连通性校验失败提示,服务监听正常、URL配置正确后自然会消失。
内容的提问来源于stack exchange,提问作者Scozirge2
相关产品推荐
相关产品推荐

