goproxy必须设为公司内网白名单内的私有代理地址（如http://goproxy.internal.corp:8080）或本地启动的合规代理服务，而非公开境外地址；完全隔离环境需用goproxy=off配合go mod vendor。
GOPROXY 设置成什么值才能绕过公司防火墙
直接设为 https://proxy.golang.org 通常不行——很多公司防火墙会拦截境外域名，或者只允许走内部代理。真正能绕过的方案是把代理指向公司内网已部署的私有代理服务（比如 Athens 或 JFrog Artifactory 的 Go 仓库），或者用支持 HTTP/HTTPS 转发的本地中转代理（如 goproxy.io 的国内镜像或自建 goproxy 进程）。
关键不是“换一个公开地址”，而是让流量不出内网、不触发安全策略：
-
GOPROXY必须指向一个公司白名单内的 URL（比如http://goproxy.internal.corp:8080），且该服务需已配置好 upstream 到官方或可信镜像 - 如果完全不允许外连，就只能用离线模式：
GOPROXY=off，靠go mod vendor或提前go mod download好所有依赖 - 避免设成多个逗号分隔值（如
GOPROXY=https://goproxy.cn,https://proxy.golang.org），Go 1.13+ 虽支持 fallback，但一旦第一个失败就会报错退出，不会自动试下一个
为什么 set GOPROXY=http://localhost:8080 不生效
常见原因是没启动对应的服务，或者端口被占用、权限限制、协议不匹配。Go 官方要求代理必须返回符合 Module Proxy Protocol 的响应，普通 HTTP server（比如 Python 的 http.server）不能直接充当代理。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用官方推荐的轻量代理
goproxy（github.com/goproxy/goproxy），启动命令是：goproxy -listen :8080 -exclude 'github.com/internal/*' - 确认
localhost在公司网络下是否可达——有些环境禁用了 loopback 解析，得换成真实 IP 或内网 DNS 名 - Windows 用户注意：PowerShell 中设置变量要用
$env:GOPROXY="http://localhost:8080"，CMD 是set GOPROXY=http://localhost:8080，两者互不继承 - 检查
go env -w GOPROXY=...是否覆盖了系统级配置；优先级是：命令行参数 > 环境变量 >go env -w持久化值
如何排除 GOPROXY 导致的 module not found 错误
典型错误信息是：go: example.com/lib@v1.2.3: reading example.com/lib/@v/v1.2.3.mod: 404 Not Found，说明代理返回了 404，而不是 go 工具链本身问题。
排查步骤要从请求路径倒推：
- 用
curl -v http://your-proxy:8080/example.com/lib/@v/v1.2.3.info直接访问代理接口，看是否返回 JSON 和状态码 - 检查模块路径是否含非法字符或大小写混用（Go 对路径大小写敏感，
github.com/User/repo≠github.com/user/repo） - 私有模块必须显式加
replace或在go.mod中声明replace example.com/lib => ./local/path，否则即使GOPROXY=off也会尝试去代理找 - 某些代理（如 Athens）默认不缓存私有域名，需在配置中显式添加
GO_PROXY_ALLOW_LIST或等效字段
公司内网用 Athens 做私有代理要注意什么
Athens 是目前最成熟的 Go 私有代理，但它默认行为和公司环境常有冲突。
几个硬性条件必须核对：
- Athens 启动时必须指定
-cache-dir且目录可写，否则首次请求会卡住或返回 500 - 若公司 Git 用的是自签名证书，Athens 需要额外加
-download-mode=sync+-insecure-skip-verify=true，否则拉取私有 repo 会失败 -
GOPROXY设为 Athens 地址后，GOINSECURE必须包含所有私有模块前缀，例如：GOINSECURE=example.com,git.corp.internal - Athens 默认不代理
golang.org/x/...这类子模块，需要在配置里加EXPERIMENTAL_ALLOW_LIST=golang.org/x/*或改用完整镜像源
最易被忽略的一点：Athens 的 /healthz 接口返回 200 不代表它能正常代理模块——它只检测自身进程存活，不校验 upstream 连通性或缓存写入权限。上线前务必用真实模块路径做一次端到端验证。
