Не работает GitHub: как настроить прокси для Git и Composer
GitHub может открываться в браузере, пока git clone висит на подключении, а Composer успевает прочитать список пакетов и падает на скачивании архива. Разберём, как определить, на каком шаге пропадает доступ, и настроить прокси для Git и Composer, SSH через порт 443 и зеркало Packagist.
Определите, где обрывается соединение
Git, SSH и Composer ходят в сеть разными способами. Браузер может использовать системный прокси, Git по HTTPS — собственную настройку, а OpenSSH — подключаться напрямую. У Composer тоже несколько этапов: получить метаданные из Packagist, скачать архив пакета или вызвать Git для работы с репозиторием. Доступ к одному из этих узлов ничего не говорит о доступе к остальным.
# В существующем клоне узнайте, какой транспорт использует origin
git remote get-url origin
# Проверьте чтение списка ссылок без скачивания репозитория
git ls-remote origin HEAD
# Посмотрите, на каком шаге Composer сообщает об ошибке
composer install -vvvПеред запуском последней команды убедитесь, что вы находитесь в каталоге проекта. Если нужен только сетевой диагноз, начните с composer diagnose. В подробном выводе ищите имя узла и действие непосредственно перед ошибкой. Перед передачей логов коллегам удалите из них токены, данные прокси и адреса закрытых репозиториев.
| Симптом | Что проверить первым |
|---|---|
| Тайм-аут или ошибка разрешения имени | Какой узел недоступен: прокси, GitHub, источник метаданных или сервер архивов |
407 Proxy Authentication Required | Авторизацию на прокси и допустимый способ подключения |
| Ошибка проверки сертификата | Доверенный центр сертификации в той среде, где запущена команда |
Permission denied (publickey) | SSH-ключ, агент и доступ аккаунта к репозиторию |
Метаданные загружаются, скачивание dist падает | Доступ к узлу, который отдаёт архив пакета |
Git по HTTPS: настройте http.proxy
http.proxy применяется к HTTP(S)-транспорту Git, в том числе к clone, fetch и push по HTTPS. В примерах HTTPS_PROXY уже содержит адрес прокси в формате, который выдал администратор. Для первого запуска проверьте настройку на одной команде.
# Выполните из существующего HTTPS-клона
git -c http.proxy="$HTTPS_PROXY" ls-remote origin HEAD
# Сохраните настройку только для этого репозитория
git config --local http.proxy "$HTTPS_PROXY"
# Посмотрите, из какого файла Git читает значение
git config --show-origin --get http.proxyДля первого клонирования передайте -c http.proxy перед clone, а адрес репозитория возьмите из интерфейса GitHub. У обычного HTTP-прокси и HTTPS-репозитория могут быть разные схемы подключения: Git обращается к прокси по его схеме, а сам HTTPS-трафик проходит через туннель. При ошибке сертификата проверьте хранилище доверенных сертификатов Git. Если компания инспектирует TLS, используйте выданный ею корневой сертификат и оставьте проверку TLS включённой.
Локальная настройка сохраняет значение в .git/config. Если адрес содержит учётные данные, передавайте их через предусмотренный в вашей среде механизм и избегайте сохранения в конфиге и вывода в лог. Для удаления локальной настройки используйте git config --local --unset http.proxy. Глобальная настройка затронет и другие HTTPS-репозитории.
Git по SSH: порт 443 и ProxyCommand
Если исходящий порт 22 закрыт, проверьте SSH-вход GitHub через узел ssh.github.com на порту 443. На этом порту по-прежнему работает протокол SSH. Если сеть выпускает трафик только через HTTP-прокси, понадобится клиент, который умеет открывать туннель CONNECT.
# Проверьте SSH-подключение напрямую по порту 443
ssh -T -p 443 git@ssh.github.comGitHub сообщает об успешной аутентификации в тексте ответа и может вернуть код завершения 1, поскольку не предоставляет интерактивную оболочку. При первом подключении сверяйте отпечаток ключа сервера с опубликованным GitHub отпечатком для соответствующего алгоритма.
Чтобы сохранить привычные SSH-адреса репозиториев, добавьте блок в ~/.ssh/config. Пример рассчитан на OpenBSD-реализацию nc, где -X connect выбирает HTTP CONNECT, а -x задаёт прокси. Замените proxy.example и порт параметрами своей сети. При прямом доступе к SSH на порту 443 достаточно блока без строки ProxyCommand.
Host github.com
HostName ssh.github.com
User git
Port 443
# %h и %p подставляет OpenSSH
ProxyCommand nc -X connect -x proxy.example:3128 %h %pПроверьте ssh -T git@github.com, затем git ls-remote origin HEAD из клона с SSH-адресом. На Windows убедитесь, что вспомогательная программа доступна именно тому OpenSSH, который запускает Git. У разных реализаций nc параметры отличаются. Если прокси запрещает CONNECT к выбранному узлу или пропускает на 443 только TLS, согласуйте маршрут с администратором либо используйте Git по HTTPS.
Composer: передайте прокси в окружение
Для собственных HTTP-запросов Composer использует переменные окружения http_proxy, https_proxy и no_proxy. Настройка http.proxy в Git влияет на Git, который Composer запускает для загрузки исходников. Запросам самого Composer нужна настройка в его окружении.
# Передайте уже настроенный прокси только этим процессам
https_proxy="$HTTPS_PROXY" http_proxy="$HTTPS_PROXY" composer diagnose
https_proxy="$HTTPS_PROXY" http_proxy="$HTTPS_PROXY" composer install --prefer-dist -vvvВ этом примере один прокси обслуживает оба типа запросов. Если в вашей сети они различаются, задайте каждую переменную отдельно. Через no_proxy можно исключить узлы, доступные напрямую, например внутренний реестр. В CI и контейнерах задавайте переменные в окружении самого шага сборки. Переменные из рабочей оболочки автоматически туда не попадают.
Для проектов на PHP 8.3–8.5 сетевой диагноз одинаков. Чтобы исключить путаницу между CLI и веб-окружением, выполните php -v и php --ini там же, где запускается Composer. При ошибке TLS проверьте, какие CA видят CLI PHP и Composer. Если HTTPS из Git работает, а Composer сообщает об ошибке сертификата, у них могут быть разные источники доверенных сертификатов.
--prefer-dist задаёт предпочтение архивам. Если загрузка архива падает, Composer в зависимости от версии и настроек может перейти к исходникам, и сбой появится уже в выводе дочернего Git. Переход на --prefer-source имеет смысл, когда доступ к Git-репозиторию уже проверен и устраивает дополнительная загрузка. При наличии composer.lock оставьте composer install, чтобы сохранить зафиксированный набор версий.
Зеркало Packagist: проверьте метаданные и архивы
Подключайте командное или доверенное зеркало, когда проблема возникает на этапе получения метаданных Packagist. Репозиторий Composer описывает версии и содержит адреса загрузки dist и source. Зеркало метаданных может оставить эти адреса прежними. В таком случае поиск пакетов заработает, а скачивание архива по-прежнему потребует доступ к GitHub или другому исходному серверу.
# PACKAGIST_MIRROR содержит адрес доверенного Composer-репозитория
# Сохраните замену стандартного Packagist в настройках проекта
composer config repositories.packagist.org composer "$PACKAGIST_MIRROR"
# Посмотрите настройки и файлы, из которых они взяты
composer config --list --source
composer install --prefer-dist -vvvЭта команда меняет composer.json. Добавляйте правку в репозиторий, когда зеркало доступно всей команде и сборочным средам. Для настройки только на своей машине используйте composer config --global с теми же аргументами и учитывайте, что настройка распространится на остальные проекты этого пользователя.
Проверьте, где зеркало хранит архивы, как обновляет метаданные и обслуживает ли приватные пакеты. composer.lock уже может содержать адреса архивов и исходников, поэтому смена источника метаданных сама по себе их не перепишет. Проверьте скачивание в чистой сборочной среде с текущим lock-файлом. Если для миграции требуется обновить адреса в lock-файле, проверьте diff и убедитесь, что версии и ссылки на коммиты пакетов сохранились.
Чек-лист, если GitHub снова недоступен
- Посмотрите адрес
originи проверьте его черезgit ls-remote origin HEAD. - Для HTTPS испытайте
http.proxyна одной команде. Для SSH проверьте порт 443 и при необходимости настройтеProxyCommand. - Выполните
composer diagnoseиcomposer install -vvvиз той же среды, в которой падает сборка. - Если сбой на этапе метаданных, проверьте зеркало. Если падает
dist, проверьте доступ к серверу архивов и адрес, записанный вcomposer.lock. - Повторите установку с текущим lock-файлом в среде без тёплого кэша. Для CI проверьте, что прокси и доверенные сертификаты доступны внутри сборочного шага.
Частые вопросы
Почему GitHub открывается в браузере, а git clone зависает?
Браузер может использовать системный прокси, а Git или OpenSSH — пытаться подключиться напрямую. Посмотрите, какой транспорт использует адрес репозитория. Для HTTPS проверьте http.proxy, для SSH — порт и настройки OpenSSH.
Поможет ли зеркало Packagist, если GitHub недоступен?
Поможет с получением метаданных. Для установки нужен доступ и к архивам или исходникам. Если зеркало отдаёт ссылки на GitHub или они уже записаны в composer.lock, проверьте маршрут до GitHub из сборочной среды.
Почему Composer получает ошибку 407, хотя Git работает через прокси?
407 означает, что прокси требует авторизацию. Git и Composer могут получать настройки и учётные данные из разных мест. Проверьте переменные окружения процесса Composer и способ авторизации, принятый на прокси.