离线环境下Go模块使用及Artifactory、GitLab配置咨询

一、Artifactory Go仓库正确配置（解决404问题） #

1. 创建合规的Go本地仓库 #

登录Artifactory后台：

• 进入「Repositories」→「Create Repository」
• 选择Go类型的Local仓库，填写仓库名称（如go-local），保留默认配置后保存。离线环境下无需创建远程仓库，仅本地仓库用于存储上传的模块。

2. 正确上传Go模块 #

直接上传go get下载的文件会因路径结构不匹配导致404，需按以下步骤操作：

• 联网机器上，用go mod download <module_name>@<version>下载指定版本的完整模块（确保包含go.mod、go.sum及所有代码文件）
• 找到模块本地存储路径：$GOPATH/pkg/mod/<module_path>@<version>（例：github.com/gin-gonic/gin@v1.9.1）
• 上传方式二选一：
  • UI上传：进入go-local仓库，点击「Upload」，选择模块根目录上传，需保证Artifactory内的路径与Go模块导入路径一致（如github.com/gin-gonic/gin/v1.9.1/）
  • 命令行上传（推荐）：使用JFrog CLI工具，配置Artifactory地址后执行：

    jf config add --url <你的Artifactory地址> --user <用户名> --password <密码>
    jf go upload <module_name>@<version> --repo go-local
    

• 注意：模块版本必须是合法的Go语义化版本（如v1.2.3），否则Artifactory无法识别。

3. 开发机器Go环境配置 #

# 设置GOPROXY为Artifactory Go仓库API地址
export GOPROXY=<你的Artifactory地址>/api/go/go-local,direct
# 离线环境关闭sum校验
export GOSUMDB=off
# 若涉及私有模块，添加私有域名到GOPRIVATE
export GOPRIVATE=<你的GitLab域名>,<你的Artifactory域名>

配置完成后执行go get <module_name>@<version>即可正常下载模块。

二、是否需要GitLab托管Go模块？ #

• 仅使用第三方开源模块：不需要GitLab，仅Artifactory即可满足存储、下载需求。
• 开发自有私有Go模块：需要GitLab，它负责模块的源代码版本控制、语义化版本标签管理，Artifactory则作为统一的存储分发仓库。

三、GitLab托管私有Go模块的配置步骤（按需） #

1. GitLab侧配置私有模块 #

• 创建GitLab项目，项目路径需符合Go模块命名规范（如gitlab.example.com/team/my-private-module）
• 项目根目录创建go.mod，第一行声明模块路径：module gitlab.example.com/team/my-private-module
• 提交代码后打语义化版本标签：

  git tag v0.1.0
  git push origin v0.1.0
  

2. Artifactory集成GitLab（可选，统一管理） #

• 创建Go类型的Remote仓库，填写GitLab模块地址https://gitlab.example.com，配置GitLab个人访问令牌（需有项目读取权限）
• 创建Go类型的Virtual仓库，将go-local本地仓库和新建的GitLab远程仓库加入其中
• 开发机器的GOPROXY改为Virtual仓库地址：export GOPROXY=<你的Artifactory地址>/api/go/go-virtual,direct

3. 开发机器访问配置 #

• 确保开发机器可通过HTTPS访问GitLab，配置Git认证（SSH密钥或HTTPS凭证）
• 添加GitLab域名到GOPRIVATE：export GOPRIVATE=gitlab.example.com，让Go直接从GitLab拉取私有模块

四、之前404错误的常见排查点 #

• 模块上传路径错误：Artifactory内模块路径需与Go导入路径完全匹配
• 版本标签不合法：未使用Go要求的语义化版本格式
• GOPROXY配置错误：使用了仓库UI地址而非Artifactory提供的Go API地址
• 权限问题：开发机器用户无Artifactory仓库读取权限（部分场景下会返回404而非403）

内容的提问来源于stack exchange，提问作者quenting