PHPTime

Не работает GitHub: как настроить прокси для Git и Composer

GitHub может открываться в браузере, пока git clone висит на подключении, а Composer успевает прочитать список пакетов и падает на скачивании архива. Разберём, как определить, на каком шаге пропадает доступ, и настроить прокси для Git и Composer, SSH через порт 443 и зеркало Packagist.

Определите, где обрывается соединение

Git, SSH и Composer ходят в сеть разными способами. Браузер может использовать системный прокси, Git по HTTPS — собственную настройку, а OpenSSH — подключаться напрямую. У Composer тоже несколько этапов: получить метаданные из Packagist, скачать архив пакета или вызвать Git для работы с репозиторием. Доступ к одному из этих узлов ничего не говорит о доступе к остальным.

Shell
# В существующем клоне узнайте, какой транспорт использует 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 уже содержит адрес прокси в формате, который выдал администратор. Для первого запуска проверьте настройку на одной команде.

Shell
# Выполните из существующего 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.

Shell
# Проверьте SSH-подключение напрямую по порту 443
 ssh -T -p 443 git@ssh.github.com

GitHub сообщает об успешной аутентификации в тексте ответа и может вернуть код завершения 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 нужна настройка в его окружении.

Shell
# Передайте уже настроенный прокси только этим процессам
 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 или другому исходному серверу.

Shell
# 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 снова недоступен

  1. Посмотрите адрес origin и проверьте его через git ls-remote origin HEAD.
  2. Для HTTPS испытайте http.proxy на одной команде. Для SSH проверьте порт 443 и при необходимости настройте ProxyCommand.
  3. Выполните composer diagnose и composer install -vvv из той же среды, в которой падает сборка.
  4. Если сбой на этапе метаданных, проверьте зеркало. Если падает dist, проверьте доступ к серверу архивов и адрес, записанный в composer.lock.
  5. Повторите установку с текущим 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 и способ авторизации, принятый на прокси.

Справка по теме

Ещё в разделе «Инструменты и библиотеки»

Шаблонизаторы PHP: от нативных шаблонов до Twig и Mustache

Как выбрать шаблонизатор для PHP 8.3–8.5, подготовить данные для шаблона, безопасно вывести HTML и проверить рендеринг на примерах PHP, Twig и Mustache.

6 мин

Push-уведомления в Chrome и Safari: настройка Web Push на PHP

Как настроить Web Push в Chrome и Safari на PHP 8.3–8.5: запросить разрешение, сохранить подписку, отправить уведомление и обработать ошибки доставки.

8 мин

PHPOffice в PHP: Excel, Word и PowerPoint на практике

Как читать Excel и генерировать XLSX, DOCX и PPTX в PHP 8.3–8.5. Примеры PHPOffice, работа с шаблонами, формулами, типами ячеек и памятью.

7 мин

Какой PHP-фреймворк выбрать для среднего проекта в 2026 году

Сравниваем Laravel, Symfony, Yii 2, Yii 3 и Slim для среднего PHP-проекта: база данных, очереди, тесты, обновления и выбор под задачи команды.

6 мин