Athens 是 Go 语言的模块代理服务器用于缓存和分发 Go 依赖包。以下是 Athens 的核心配置方式涵盖部署 Athens 本身和配置 Go 客户端使用 Athens两个方面。一、快速部署 Athens1. Docker 方式最简单bash# 基础运行数据不持久化 docker run -p 3000:3000 gomods/athens:latest # 带持久化存储 export ATHENS_STORAGE$HOME/athens-storage mkdir -p $ATHENS_STORAGE docker run -d \ -v $ATHENS_STORAGE:/var/lib/athens \ -e ATHENS_DISK_STORAGE_ROOT/var/lib/athens \ -e ATHENS_STORAGE_TYPEdisk \ -p 3000:3000 \ --name athens \ gomods/athens:latest2. Kubernetes / Helm 方式bashhelm repo add athens https://gomods.github.io/athens-charts helm repo update helm install athens athens/athens-proxy --namespace athens --create-namespace二、Athens 核心配置项Athens 主要通过环境变量或config.toml配置文件进行设置。以下是常用配置存储后端配置表格环境变量说明示例ATHENS_STORAGE_TYPE存储类型disk/s3/gcp/minio/mongoATHENS_DISK_STORAGE_ROOT本地磁盘存储路径/var/lib/athensATHENS_S3_BUCKETS3 Bucket 名称my-athens-bucketATHENS_S3_REGIONS3 区域us-east-1网络模式NetworkMode控制 Athens 如何从上游获取模块表格模式行为strict合并 VCS 和缓存版本任一失败则报错默认offline仅从缓存读取不连接 VCSfallback优先从缓存读取缓存缺失时才请求 VCSbash# 设置为 fallback 模式 ATHENS_NETWORK_MODEfallback上游代理配置如果 Athens 本地没有缓存可以配置它向上游代理请求而非直接访问 VCSbashATHENS_GO_BINARY_ENV_VARSGOPROXYhttps://proxy.golang.org,direct或通过 Download Mode 文件精细控制见下文。三、Download Mode 文件精细控制源Athens 支持通过download配置文件控制哪些模块可以从哪里下载。创建download.confhcldownloadURL https://proxy.golang.org mode sync # 允许同步公司内部仓库 download gitlab.mycompany.com/repo/a { mode sync } download gitlab.mycompany.com/repo/b { mode sync } # 禁止下载其他内部仓库 download gitlab.mycompany.com/* { mode none }启动时指定bashATHENS_DOWNLOAD_MODEfile:./download.conf四、私有仓库 / 源代码认证配置如果 Athens 需要从私有 Git 仓库拉取代码需要配置 SSH 或 Git 凭证SSH 密钥方式bash# 挂载 SSH 私钥 docker run -d \ -v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \ -e ATHENS_GIT_CONFIG/root/.gitconfig \ gomods/athens:latest.netrc 方式HTTP 基本认证bashATHENS_NETRC_PATH/etc/athens/.netrc五、配置 Go 客户端使用 Athens部署好 Athens 后在开发环境或 CI/CD 中配置 Go 使用它bash# 指向你的 Athens 地址 export GOPROXYhttp://localhost:3000 # 或配置多个代理Athens 优先回退到官方 export GOPROXYhttp://localhost:3000,https://proxy.golang.org,direct # 私有模块不走代理直接访问 VCS export GOPRIVATEgitlab.mycompany.com在 CI/CD 中如 Kubernetes 内bashexport GOPROXYhttp://athens-proxy.athens.svc.cluster.local:80 export GOPRIVATEgitlab.mycompany.com六、完整生产配置示例yaml# docker-compose.yml version: 3 services: athens: image: gomods/athens:latest ports: - 3000:3000 environment: - ATHENS_STORAGE_TYPEdisk - ATHENS_DISK_STORAGE_ROOT/var/lib/athens - ATHENS_NETWORK_MODEfallback - ATHENS_GO_BINARY_ENV_VARSGOPROXYhttps://proxy.golang.org,direct - ATHENS_DOWNLOAD_MODEfile:/etc/athens/download.conf volumes: - ./athens-data:/var/lib/athens - ./download.conf:/etc/athens/download.conf:ro - ~/.ssh:/root/.ssh:ro如需进一步了解某个具体场景如对接私有 GitLab、S3 存储后端、或 Helm 高级配置可以告诉我我可以提供更详细的步骤。
Athens 是 Go 语言的模块代理服务器用于缓存和分发 Go 依赖包。以下是 Athens 的核心配置方式涵盖部署 Athens 本身和配置 Go 客户端使用 Athens两个方面。一、快速部署 Athens1. Docker 方式最简单bash# 基础运行数据不持久化 docker run -p 3000:3000 gomods/athens:latest # 带持久化存储 export ATHENS_STORAGE$HOME/athens-storage mkdir -p $ATHENS_STORAGE docker run -d \ -v $ATHENS_STORAGE:/var/lib/athens \ -e ATHENS_DISK_STORAGE_ROOT/var/lib/athens \ -e ATHENS_STORAGE_TYPEdisk \ -p 3000:3000 \ --name athens \ gomods/athens:latest2. Kubernetes / Helm 方式bashhelm repo add athens https://gomods.github.io/athens-charts helm repo update helm install athens athens/athens-proxy --namespace athens --create-namespace二、Athens 核心配置项Athens 主要通过环境变量或config.toml配置文件进行设置。以下是常用配置存储后端配置表格环境变量说明示例ATHENS_STORAGE_TYPE存储类型disk/s3/gcp/minio/mongoATHENS_DISK_STORAGE_ROOT本地磁盘存储路径/var/lib/athensATHENS_S3_BUCKETS3 Bucket 名称my-athens-bucketATHENS_S3_REGIONS3 区域us-east-1网络模式NetworkMode控制 Athens 如何从上游获取模块表格模式行为strict合并 VCS 和缓存版本任一失败则报错默认offline仅从缓存读取不连接 VCSfallback优先从缓存读取缓存缺失时才请求 VCSbash# 设置为 fallback 模式 ATHENS_NETWORK_MODEfallback上游代理配置如果 Athens 本地没有缓存可以配置它向上游代理请求而非直接访问 VCSbashATHENS_GO_BINARY_ENV_VARSGOPROXYhttps://proxy.golang.org,direct或通过 Download Mode 文件精细控制见下文。三、Download Mode 文件精细控制源Athens 支持通过download配置文件控制哪些模块可以从哪里下载。创建download.confhcldownloadURL https://proxy.golang.org mode sync # 允许同步公司内部仓库 download gitlab.mycompany.com/repo/a { mode sync } download gitlab.mycompany.com/repo/b { mode sync } # 禁止下载其他内部仓库 download gitlab.mycompany.com/* { mode none }启动时指定bashATHENS_DOWNLOAD_MODEfile:./download.conf四、私有仓库 / 源代码认证配置如果 Athens 需要从私有 Git 仓库拉取代码需要配置 SSH 或 Git 凭证SSH 密钥方式bash# 挂载 SSH 私钥 docker run -d \ -v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \ -e ATHENS_GIT_CONFIG/root/.gitconfig \ gomods/athens:latest.netrc 方式HTTP 基本认证bashATHENS_NETRC_PATH/etc/athens/.netrc五、配置 Go 客户端使用 Athens部署好 Athens 后在开发环境或 CI/CD 中配置 Go 使用它bash# 指向你的 Athens 地址 export GOPROXYhttp://localhost:3000 # 或配置多个代理Athens 优先回退到官方 export GOPROXYhttp://localhost:3000,https://proxy.golang.org,direct # 私有模块不走代理直接访问 VCS export GOPRIVATEgitlab.mycompany.com在 CI/CD 中如 Kubernetes 内bashexport GOPROXYhttp://athens-proxy.athens.svc.cluster.local:80 export GOPRIVATEgitlab.mycompany.com六、完整生产配置示例yaml# docker-compose.yml version: 3 services: athens: image: gomods/athens:latest ports: - 3000:3000 environment: - ATHENS_STORAGE_TYPEdisk - ATHENS_DISK_STORAGE_ROOT/var/lib/athens - ATHENS_NETWORK_MODEfallback - ATHENS_GO_BINARY_ENV_VARSGOPROXYhttps://proxy.golang.org,direct - ATHENS_DOWNLOAD_MODEfile:/etc/athens/download.conf volumes: - ./athens-data:/var/lib/athens - ./download.conf:/etc/athens/download.conf:ro - ~/.ssh:/root/.ssh:ro如需进一步了解某个具体场景如对接私有 GitLab、S3 存储后端、或 Helm 高级配置可以告诉我我可以提供更详细的步骤。
)
)
