2026 Стабильность загрузки на удалённом Mac: FAQ по Git/Homebrew/npm — таймауты и повторы

Три основные причины:

• Большая RTT и потери пакетов. Трансграничные или удалённые каналы добавляют задержку и потери. Таймауты клиентов по умолчанию короткие; один медленный участок может прервать передачу.
• Маленькие буферы и отсутствие повторов. У Git по умолчанию небольшой http.postBuffer для крупных push; HTTP-клиенты часто не повторяют запрос при временных сбоях. У Homebrew и npm похожие умолчания.
• Нет переиспользования соединения. Повторные SSH-подключения (например для Git по SSH) каждый раз пересогласовываются. Без ControlPersist каждая операция clone или fetch платит полной ценой установки соединения и сильнее страдает от обрывов в середине передачи.

Раннеры CI на удалённом Mac усиливают проблему: много джоб параллельно клонируют и ставят зависимости, поэтому таймауты и повторы критичны для стабильности. Трансграничные команды чаще всего сталкиваются с этим, когда узел Mac и апстрим Git/npm/Homebrew находятся в разных регионах.

Используйте эти настройки глобально или для репозитория, чтобы снизить таймауты и улучшить поведение при повторах.

git config --global http.postBuffer 524288000
git config --global http.lowSpeedLimit 1000
git config --global http.lowSpeedTime 60

Опционально — таймаут HTTP (секунды): git config --global http.version HTTP/1.1 может помочь за частью прокси. Для жёсткого таймаута: git config --global http.lowSpeedTime 120 (увеличьте при очень медленных каналах). В CI задавайте эти параметры через git config в джобе или в глобальном конфиге образа раннера.

Переиспользование SSH (ControlPersist): добавьте в ~/.ssh/config для хоста (например Host github.com):

Host github.com
  ControlMaster auto
  ControlPath ~/.ssh/sockets/%r@%h-%p
  ControlPersist 600

Создайте каталог: mkdir -p ~/.ssh/sockets. Новые соединения переиспользуют мастер-сессию 600 секунд, что снижает переподключения и сбои в середине clone.

Homebrew. Задайте число повторов и при необходимости быстрый core remote:

export HOMEBREW_CURL_RETRIES=5
export HOMEBREW_CORE_GIT_REMOTE="https://github.com/Homebrew/homebrew-core.git"
# Опционально: зеркало
# export HOMEBREW_BOTTLE_DOMAIN="https://mirror.example.com"

Добавьте экспорты в ~/.zshrc или в окружение CI. На нестабильных сетях увеличьте HOMEBREW_CURL_RETRIES.

npm. Повторы и таймауты (в .npmrc или через переменные окружения):

fetch-retries=5
fetch-retry-mintimeout=20000
fetch-retry-maxtimeout=120000
fetch-timeout=300000

Время в миллисекундах. Для CI часто важнее зеркало реестра или прокси, чем только эти параметры; комбинируйте с таблицей ниже. Задайте их в проекте в .npmrc или в окружении CI, чтобы каждый запуск использовал одну и ту же политику повторов и таймаутов.

Выбор зависит от сценария, возможностей по сопровождению и затрат.

Для удалённого Mac в CI: начните с публичного зеркала или прокси, если раннер трансграничный; переходите на своё зеркало при необходимости максимальной стабильности и возможности запускать задачи синхронизации. Подробнее: гид по зеркалу Git и прокси и ускорение трансграничной загрузки.

• Увеличьте Git http.postBuffer, задайте lowSpeedLimit и lowSpeedTime, включите SSH ControlPersist для переиспользования соединения.
• Задайте Homebrew HOMEBREW_CURL_RETRIES и при необходимости core remote или зеркало bottle; для npm — fetch-retries и таймауты (и зеркало реестра при необходимости).
• Выберите зеркало, прокси или своё зеркало по таблице выше; комбинируйте с shallow clone или кешем где возможно (см. статью про стратегию кеша).
• Краткий чеклист: буфер и lowSpeed* для Git заданы; SSH ControlPersist настроен; повторы Homebrew и повторы/таймауты npm заданы; зеркало или прокси выбраны и применены. После каждого изменения перезапускайте падающий clone или установку для проверки.