什么是Go 代理

目录

• 什么是 Go 代理
• Go 代理的工作原理
• 配置 GOPROXY
  • 查看当前配置
  • 设置代理
• 特殊值含义
  • direct
  • off
• 常用的 Go 代理服务
  • 1. 官方代理
  • 2. 中国大陆代理
  • 3. 其他代理
• 配置示例
  • 完整的代理配置
  • 企业环境配置
• GOPRIVATE 配置
  • 什么是 GOPRIVATE
  • 配置示例
• 实际使用场景
  • 1. 网络环境差的情况
  • 2. 企业内网环境
  • 3. 开发测试环境
• 代理的优势
  • 1. 速度优化
  • 2. 可靠性提升
  • 3. 企业友好
• 自建 Go 代理
  • 使用 Goproxy 搭建
  • 使用 Athens 搭建
• 故障排除
  • 常见问题
  • 临时设置

---

Go 代理（GOPROXY）是 Go 模块系统中的一个重要概念，它充当模块下载的中介服务器。以下是详细解释：

什么是 Go 代理

Go 代理是一个 Web 服务，它实现了 Go 模块代理协议，用于缓存和分发 Go 模块。当你执行 go get 或 go mod download 命令时，Go 会通过代理服务器下载模块，而不是直接从源代码仓库下载。

---

Go 代理的工作原理

开发者 → Go 客户端 → Go 代理服务器 → 源代码仓库（GitHub/GitLab等）
     ←           ←              ←

1. 请求模块：开发者执行 go get 命令
2. 查询代理：Go 客户端向代理服务器请求模块
3. 缓存检查：代理检查是否已缓存该模块
4. 获取源码：如果未缓存，代理从源仓库获取模块
5. 返回模块：代理将模块返回给客户端并缓存

---

配置 GOPROXY

查看当前配置

go env GOPROXY

设置代理

# 设置单个代理
go env -w GOPROXY=https://goproxy.cn

# 设置多个代理（逗号分隔，按顺序尝试）
go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct

# 重置为默认值
go env -w GOPROXY=https://proxy.golang.org,direct

---

特殊值含义

direct

go env -w GOPROXY=direct

• 直接从源仓库下载，跳过所有代理
• 通常作为备选方案放在代理列表末尾

off

go env -w GOPROXY=off

• 禁用所有模块下载
• 只能使用本地已缓存的模块

---

常用的 Go 代理服务

1. 官方代理

# Go 官方代理（默认）
https://proxy.golang.org

2. 中国大陆代理

# 七牛云代理
https://goproxy.cn

# 阿里云代理
https://mirrors.aliyun.com/goproxy/

# 腾讯云代理
https://mirrors.tencent.com/go/

3. 其他代理

# GoCenter
https://gocenter.io

# Goproxy.io
https://goproxy.io

---

配置示例

完整的代理配置

# 设置代理链
go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct

# 设置私有仓库（跳过代理）
go env -w GOPRIVATE=*.corp.example.com,github.com/secret/*

# 设置校验和数据库
go env -w GOSUMDB=sum.golang.org

企业环境配置

# 企业内网代理
go env -w GOPROXY=https://goproxy.corp.com,https://goproxy.cn,direct

# 私有仓库设置
go env -w GOPRIVATE=*.corp.com,gitee.com/company/*

# 禁用校验和验证（仅私有仓库）
go env -w GONOSUMDB=*.corp.com

---

GOPRIVATE 配置

什么是 GOPRIVATE

GOPRIVATE 用于指定哪些模块路径是私有的，这些模块：

• 不会通过代理下载
• 不会进行校验和验证
• 直接从源仓库获取

配置示例

# 单个私有仓库
go env -w GOPRIVATE=gitee.com/mycompany/private-repo

# 多个私有仓库
go env -w GOPRIVATE=gitee.com/mycompany/*,github.com/mycompany/*

# 通配符匹配
go env -w GOPRIVATE=*.corp.com,*.internal

---

实际使用场景

1. 网络环境差的情况

# 使用国内代理加速
go env -w GOPROXY=https://goproxy.cn,direct

2. 企业内网环境

# 使用企业代理
go env -w GOPROXY=https://goproxy.corp.com,https://goproxy.cn,direct
go env -w GOPRIVATE=*.corp.com

3. 开发测试环境

# 临时禁用代理
GOPROXY=direct go get github.com/example/package

# 或者
go env -w GOPROXY=direct

---

代理的优势

1. 速度优化

• 缓存机制减少重复下载
• 就近访问提高下载速度
• 并发下载支持

2. 可靠性提升

• 多个代理提供冗余
• 源仓库不可用时提供备选
• 版本锁定保证一致性

3. 企业友好

• 支持私有仓库
• 可以部署内网代理
• 访问控制和审计

---

自建 Go 代理

使用 Goproxy 搭建

# 安装 goproxy
go install github.com/goproxy/goproxy/cmd/goproxy@latest

# 启动代理服务
goproxy -listen=0.0.0.0:8080 -cacheDir=/tmp/goproxy

使用 Athens 搭建

# 使用 Docker 运行 Athens
docker run -d -p 3000:3000 \
  -e ATHENS_DISK_STORAGE_ROOT=/var/lib/athens \
  -e ATHENS_STORAGE_TYPE=disk \
  gomods/athens:latest

---

故障排除

常见问题

# 清除模块缓存
go clean -modcache

# 检查代理连接
go env GOPROXY
curl -I https://goproxy.cn

# 调试模块下载
go get -x github.com/gin-gonic/gin

临时设置

# 临时使用特定代理
GOPROXY=https://goproxy.cn go get github.com/gin-gonic/gin

# 临时禁用代理
GOPROXY=direct go get github.com/example/package

Go 代理是现代 Go 开发中不可或缺的基础设施，它显著提升了模块下载的速度和可靠性，特别是在网络环境复杂或需要企业级管理的场景下。