直接配goproxy=https://goproxy.cn在企业内网行不通，因其为公网服务，受防火墙限制无法访问，会导致dns解析或tls握手超时，并引发checksum mismatch或404 for .info等错误。
为什么直接配 GOPROXY=https://goproxy.cn 在企业内网行不通
因为 goproxy.cn 是公网服务，企业防火墙或私有网络通常不允许出向 HTTPS 请求——不是配置错了，是根本连不上。Go 工具链会卡在 DNS 解析或 TLS 握手阶段，最终超时失败。更隐蔽的问题是：即使某次侥幸通了，后续 go mod download 仍可能因证书校验、私有模块重定向、.info 文件缺失等触发 checksum mismatch 或 404 for example.com/mylib@v1.2.3.info 错误。
docker-compose 启动 Athens 必须改的三处配置
默认的 docker-compose.yml 模板常导致“服务启动了但客户端连不上”，核心问题就在这三项：
- 监听地址必须是
0.0.0.0:3000，不能是127.0.0.1:3000（容器内默认只绑本地） -
volumes必须挂载宿主机目录，例如- ./athens-storage:/var/lib/athens，否则重启容器后所有缓存清零 -
ATHENS_GO_BINARY_ENV_VARS必须设为GO111MODULE=on,GOPROXY=direct，否则 Athens 自身拉取模块时会错误走公网代理
正确示例片段：
environment: - ATHENS_STORAGE_TYPE=disk - ATHENS_DISK_STORAGE_ROOT=/var/lib/athens - ATHENS_GO_BINARY_ENV_VARS=GO111MODULE=on,GOPROXY=direct volumes: - ./athens-storage:/var/lib/athens
客户端 go env -w 配置不生效的常见原因
用 export GOPROXY=... 或写入 shell profile 在 CI/CD、Docker 构建中必然失效。Go 1.13+ 要求必须用 go env -w 写入用户级配置：
- 执行
go env -w GOPROXY="http://athens.internal:3000,direct"—— 注意逗号分隔，direct是兜底项，不能省略 - 私有 Git 域名（如
git.corp.com）必须同步加go env -w GOINSECURE="git.corp.com"，否则 TLS 证书错误直接中断 - 验证是否生效：运行
go env GOPROXY，别信echo $GOPROXY，Go 进程已忽略环境变量 - 若 Athens 启用了 Basic Auth，URL 中必须带凭证：
https://user:pass@athens.internal:3000
私有模块拉不到 latest？先确认 tag 和 visibility
Athens 不会自动猜 commit，它严格按 Go 模块协议工作：
- GitLab / GitHub 私有仓库的项目
visibility必须设为public或internal，private会导致 Athens 认证失败（返回 401） - 私有模块没打 Git tag，
go get example.com/mylib@latest就会失败；手动触发一次go get example.com/mylib@v1.2.3，或直接在go.mod中写死版本再跑go mod download - 确保 Git 服务用 HTTPS（非 HTTP），且证书可信；Athens 不支持自签名证书直连，要么配
GOINSECURE，要么换可信 CA - 下载模式必须设为
sync（默认值），async模式会让 CI 构建直接失败——它返回 404 后后台拉取，没人等
最易被忽略的一点：Athens 容器和客户端不在同一网络时，Linux 宿主机 IP 不能写 localhost 或 host.docker.internal，得用真实局域网 IP，比如 http://192.168.1.100:3000。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
