Go Modules 代理配置完全指南
📖 前言
Go Modules 是 Go 1.11 引入的官方依赖管理工具。在国内使用时，从 proxy.golang.org 下载依赖往往很慢。通过配置国内代理服务，可以显著提升 go get 的速度。
🚀 快速配置（推荐）
使用我们的一键配置脚本：
curl -sSL https://mirror2030.com/install.sh | bash
脚本会自动配置 Go Modules 代理，同时创建配置备份。
🛠️ 手动配置方法
使用 go env 命令（推荐）
Go 提供了 go env 命令来配置环境变量，配置后永久生效：
Linux / macOS 系统
# 推荐使用 Goproxy.cn（七牛云提供）
go env -w GOPROXY=https://goproxy.cn,direct
# 阿里云镜像
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
# 腾讯云镜像
go env -w GOPROXY=https://mirrors.cloud.tencent.com/go/,direct
Windows 系统
在 PowerShell 或 CMD 中执行：
# 推荐使用 Goproxy.cn
go env -w GOPROXY=https://goproxy.cn,direct
# 或使用阿里云镜像
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
💡 关于 direct
,direct 表示当代理服务找不到包时，直接从源地址下载。 这是一个回退机制，建议保留。
,direct 表示当代理服务找不到包时，直接从源地址下载。 这是一个回退机制，建议保留。
✅ 验证配置
查看当前 GOPROXY 配置：
查看当前 GOPROXY 配置：
go env GOPROXY
设置环境变量方式
如果 go env -w 命令不可用（Go 1.13以下），可以通过环境变量设置：
Linux / macOS - Bash/Zsh：
编辑 ~/.bashrc 或 ~/.zshrc：
export GOPROXY=https://goproxy.cn,direct
export GO111MODULE=on
使配置生效：
source ~/.bashrc
# 或
source ~/.zshrc
Windows 系统：
通过系统设置添加环境变量：
- 右键"此电脑" → "属性" → "高级系统设置"
- 点击"环境变量"
- 在"用户变量"中新建：
- 变量名：GOPROXY
- 变量值：https://goproxy.cn,direct
- 确定保存
🔄 恢复官方代理
如果需要恢复到 Go 官方代理，执行：
go env -w GOPROXY=https://proxy.golang.org,direct
📊 不同代理服务对比
| 代理服务 | URL | 特点 |
|---|---|---|
| Goproxy.cn | https://goproxy.cn | 七牛云支持，速度快 |
| 阿里云 | https://mirrors.aliyun.com/goproxy/ | 企业级稳定 |
| 腾讯云 | https://mirrors.cloud.tencent.com/go/ | 国内大厂支持 |
| Goproxy.io | https://goproxy.io | 全球 CDN 加速 |
❓ 常见问题
Q: 配置后下载仍然很慢？
A: 可能的原因和解决方法：
- 检查配置是否生效：go env GOPROXY
- 清除模块缓存：go clean -modcache
- 尝试更换其他代理服务
- 检查网络连接是否正常
Q: 什么是 GO111MODULE？
A: GO111MODULE 控制 Go Modules 的启用：
- on - 始终使用 Go Modules
- off - 禁用 Go Modules
- auto - 根据目录自动判断（默认）
Go 1.16+ 默认启用，通常不需要手动设置。
Q: 私有仓库如何配置？
A: 使用 GOPRIVATE 环境变量：
# 配置私有仓库域名
go env -w GOPRIVATE=git.company.com,gitlab.company.com
# 同时配置代理
go env -w GOPROXY=https://goproxy.cn,direct
GOPRIVATE 中的域名会跳过代理，直接访问。
Q: 如何指定多个代理？
A: 使用逗号分隔，Go 会按顺序尝试：
go env -w GOPROXY=https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct
🔐 安全建议
💡 提示
- 建议使用知名的代理服务
- 代理服务仅缓存公开模块，不会修改代码
- 私有仓库建议使用 GOPRIVATE 配置
- 定期检查代理服务的可用性
🎓 进阶技巧
1. 配置校验和数据库
Go Modules 使用校验和数据库验证模块完整性：
# 使用国内镜像（可选）
go env -w GOSUMDB="sum.golang.google.cn"
2. 查看模块缓存位置
查看 Go Modules 的缓存目录：
go env GOMODCACHE
3. 临时使用代理
不修改全局配置，临时使用代理：
# Linux / macOS
GOPROXY=https://goproxy.cn go get github.com/gin-gonic/gin
# Windows PowerShell
$env:GOPROXY="https://goproxy.cn"; go get github.com/gin-gonic/gin
4. 清理模块缓存
清理所有下载的模块：
go clean -modcache
5. 查看模块信息
查看某个模块的所有版本：
go list -m -versions github.com/gin-gonic/gin
🔗 相关资源
📞 需要帮助？
如果你在配置过程中遇到问题，可以：
- 访问我们的 GitHub Issues 提问
- 发送邮件至：17395905781@163.com
- 加入我们的社区讨论
最后更新：2025-12-07 | 返回教程列表