在企业Go项目开发中，依赖管理是保障项目稳定运行的基础，公共代理往往无法满足私有模块的拉取需求，配置内部代理可以有效解决这些问题。内部代理能够缓存公共依赖，加速模块下载，同时支持私有仓库的代理转发，避免直接暴露私有代码地址，符合企业安全管控要求。
Go内部代理的核心作用
Go内部代理本质是模块代理服务，主要承担三个核心功能：一是缓存公共模块，减少重复从公共源拉取的时间；二是转发私有模块的请求，对接企业内部的Git仓库等私有代码平台；三是统一依赖管控，团队可以限制可拉取的模块范围，避免引入风险依赖。
两种主流内部代理搭建方案
方案一：使用Athens搭建
Athens是Go官方推荐的模块代理工具，支持多种存储后端，部署简单。首先下载对应系统的Athens二进制文件，也可以通过Docker快速启动：
# 拉取Athens镜像 docker pull gomods/athens:latest # 启动Athens服务，映射端口3000，使用本地目录存储缓存 docker run -d -p 3000:3000 -v $(pwd)/athens-storage:/var/lib/athens gomods/athens:latest
启动后可以通过http://127.0.0.1:3000访问Athens的管理页面，默认配置下已经支持公共模块的代理。如果需要对接私有仓库，需要修改Athens的配置文件，添加私有仓库的地址与认证信息：
# athens配置文件示例
GoBinaryEnvVars:
- GOPRIVATE=git.ipipp.com/*
StorageType: disk
DiskStorage:
RootPath: /var/lib/athens
FilterFile: /etc/athens/filter.txt
# 私有仓库配置
GitConfig:
- URL: git.ipipp.com
SSHKeyPath: /etc/athens/ssh/id_rsa
Insecure: false
方案二：使用Nexus Repository Manager搭建
Nexus是通用的仓库管理工具，支持Go、Maven、npm等多种包管理，适合已经有统一仓库管理平台的企业。在Nexus中创建Go代理仓库的步骤如下：
- 登录Nexus管理页面，进入Repository菜单，选择Create repository
- 选择go-proxy类型，填写仓库名称，设置公共代理地址为
https://goproxy.io或者https://proxy.golang.org - 如果需要支持私有模块，再创建一个go-group类型的仓库，将公共代理仓库和私有仓库添加到组内
企业项目中配置与使用
全局配置方式
在开发机器或者CI/CD环境中，可以通过设置环境变量来全局使用内部代理：
# Linux/Mac系统配置 export GOPROXY=http://192.168.0.1:3000,direct export GOPRIVATE=git.ipipp.com/* # Windows系统配置（PowerShell） $env:GOPROXY = "http://192.168.0.1:3000,direct" $env:GOPRIVATE = "git.ipipp.com/*"
其中GOPROXY指定代理地址，多个地址用逗号分隔，direct表示如果代理拉取失败则直接从源地址拉取；GOPRIVATE指定不需要走公共代理的私有模块前缀，避免私有模块被推送到公共代理。
项目级配置方式
如果不同项目需要使用不同的代理配置，可以在项目根目录下创建.env文件或者在go env -w中设置项目级的环境变量：
# 设置当前项目的Go代理 go env -w GOPROXY=http://192.168.0.1:3000,direct go env -w GOPRIVATE=git.ipipp.com/*
验证配置是否生效
配置完成后，可以通过拉取一个公共模块和一个私有模块来验证代理是否正常工作：
# 拉取公共模块验证缓存功能 go get github.com/gin-gonic/gin # 拉取私有模块验证转发功能 go get git.ipipp.com/team/utils
如果拉取成功，说明内部代理配置生效。可以查看Athens或者Nexus的存储目录，确认模块已经被缓存到内部代理中。
企业场景注意事项
- 定期清理代理缓存，避免无效模块占用存储空间
- 为内部代理配置访问权限，避免外部未授权访问
- CI/CD环境中建议将代理地址写入流水线配置，避免环境差异导致依赖拉取失败
- 如果私有仓库使用自签名证书，需要在代理服务中配置信任该证书，否则会出现拉取失败的问题