Как правильно скачать приватный репозиторий через go get?

Краткий ответ: настройте GOPRIV и используйте SSH вместо HTTPS

Проблема в том, что go get по умолчанию пытается получить информацию о пакете через HTTPS-запрос к https://github.com/company/private-lib?go-get=1. Для публичных репозиториев это работает, но приватные репозитории возвращают 404, так как GitHub не даёт доступ без аутентификации.

Пошаговое решение

1. Настройте переменную окружения GOPRIV

Эта переменная говорит Go, что для определённых доменов не нужно обращаться к публичным прокси (GOPROXY) и проверять контрольные суммы (GOSUMCHECK). Добавьте в ~/.bashrc или ~/.zshrc:

export GOPRIV=github.com/company,gitlab.com/company

Если у вас несколько организаций, можно указать через запятую или использовать wildcard:

export GOPRIV=*.company.com

2. Настройте Git на использование SSH вместо HTTPS

Go использует Git под капотом. Если ваш SSH-ключ настроен, но Go всё равно ходит по HTTPS, нужно переопределить URL. Создайте или отредактируйте файл ~/.gitconfig:

[url "ssh://git@github.com/"]
    insteadOf = https://github.com/
[url "ssh://git@gitlab.com/"]
    insteadOf = https://gitlab.com/

Теперь все HTTPS-запросы к GitHub/GitLab будут автоматически заменяться на SSH.

3. Проверьте доступность репозитория

Выполните в терминале:

GIT_SSH_COMMAND="ssh -v" git ls-remote git@github.com:company/private-lib.git

Если команда выполняется успешно — Git настроен правильно.

4. Очистите кеш и попробуйте снова

go clean -modcache
go get github.com/company/private-lib@latest

Полный пример рабочей конфигурации

Предположим, у вас проект myproject и приватный пакет github.com/company/private-lib с тегом v1.0.0.

# 1. Инициализируем модуль
go mod init myproject

# 2. Убеждаемся, что GOPRIV установлена
echo $GOPRIV
# Должно быть: github.com/company

# 3. Добавляем зависимость
go get github.com/company/private-lib@v1.0.0

# 4. Проверяем go.mod
cat go.mod
# Должна появиться строка:
# require github.com/company/private-lib v1.0.0

Дополнительные советы

• Для CI/CD: используйте токены доступа (personal access tokens) и настройте ~/.netrc:

machine github.com login <USERNAME> password <TOKEN>

• Для GitLab: добавьте jobs_token в URL:

git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com/".insteadOf "https://gitlab.com/"

• Проверка версий: если репозиторий без тегов, используйте @branch-name или @commit-hash.

После этих настроек go get будет работать как с публичными, так и с приватными репозиториями.

# Клонируем приватный репозиторий рядом с проектом
git clone git@github.com:company/private-lib.git ../private-lib

# В go.mod вашего проекта добавляем:
replace github.com/company/private-lib => ../private-lib

export GOPROXY=off
export GONOSUMCHECK=*
go get github.com/company/private-lib@v1.0.0