Как настроить прокси для npm, pip, apt, Docker и git: пошаговая инструкция по конфигам каждого инструмента
Содержание статьи
- Введение: зачем пакетным менеджерам собственные настройки прокси
- Предварительная подготовка
- Базовые понятия: почему переменных окружения не хватает
- Шаг 1: проверяем прокси и готовим эталонную строку
- Шаг 2: настраиваем npm через файл .npmrc
- Шаг 3: настраиваем pip через pip.conf
- Шаг 4: настраиваем apt через каталог apt.conf.d
- Шаг 5: настраиваем docker на двух уровнях
- Шаг 6: настраиваем git через git config
- Проверка результата: сводный чек-лист
- Типичные ошибки и решения
- Дополнительные возможности
- Faq: частые вопросы по настройке
- Заключение
Введение: зачем пакетным менеджерам собственные настройки прокси
Вы наверняка уже сталкивались с ситуацией: в терминале экспортированы переменные http_proxy и https_proxy, curl бодро скачивает страницы, а вот npm install зависает на минуту и падает с ошибкой ETIMEDOUT. Или apt update молча пытается достучаться до зеркала напрямую, будто никакого прокси не существует. Или Docker при сборке образа не может вытянуть базовый слой, хотя из той же консоли docker pull работает. Это не баг и не мистика. Просто у каждого инструмента свой способ читать настройки сети, и переменные окружения покрывают его лишь частично.
Этот гайд посвящен именно собственным конфигурационным файлам пяти инструментов, без которых не обходится ни один разработчик: npm (файл .npmrc), pip (pip.conf или pip.ini), apt (каталог apt.conf.d), Docker (daemon.json и config.json) и git (git config). Мы намеренно не повторяем материал про переменные окружения в терминале и CI. Здесь другая задача: показать, как прописать прокси так, чтобы он применялся всегда, независимо от того, кто и откуда запустил команду.
В результате вы получите пять рабочих конфигов, которые можно скопировать на любую машину, понимание того, где каждый инструмент ищет настройки, и набор команд для проверки. Плюс вы будете знать, как быстро откатить все обратно.
Для кого этот гайд
- Разработчикам, чей рабочий ноутбук или сервер находится за корпоративным или домашним прокси.
- Тестировщикам и специалистам по автоматизации, которым нужно, чтобы сборки шли через выделенный прокси-адрес.
- Администраторам, настраивающим типовые образы рабочих станций.
- Всем, кто использует арендованный прокси (в том числе мобильный) для разработки и хочет, чтобы через него ходил конкретный инструмент, а не вся система.
Что нужно знать заранее
Достаточно базовых навыков работы в терминале: открыть консоль, перейти в каталог, отредактировать текстовый файл. Мы будем использовать редактор nano в Linux и Блокнот в Windows, но подойдет любой. Понимание того, что такое IP-адрес и порт, тоже пригодится, хотя мы напомним основы в разделе про понятия.
Сколько времени потребуется
Если настраивать все пять инструментов подряд, закладывайте от 60 до 90 минут. Каждый отдельный инструмент занимает 10-15 минут вместе с проверкой. Самый долгий этап - Docker, потому что там два уровня настроек и требуется перезапуск службы.
Предварительная подготовка
Прежде чем править конфиги, соберем все необходимое. Пропуск этого этапа - главная причина, почему потом приходится часами гадать, где ошибка.
Необходимые данные о прокси
Вам нужны четыре параметра. Запишите их в текстовый файл, чтобы не искать по переписке:
- Тип прокси: HTTP или HTTPS (иногда SOCKS5, но большинство пакетных менеджеров ждут именно HTTP-прокси).
- Адрес: доменное имя или IP, например proxy.corp.local или 10.20.30.40.
- Порт: чаще всего 3128, 8080 или 8888.
- Логин и пароль, если прокси требует авторизацию. Обратите внимание на спецсимволы в пароле: они потребуют кодирования, об этом ниже.
Системные требования и версии
Инструкция проверена на актуальных версиях 2026 года и подходит для:
- Ubuntu 22.04 и 24.04, Debian 12 и 13 (для apt).
- Node.js 20 и 22 с npm 10 и 11.
- Python 3.10 и новее с pip 24 и новее.
- Docker Engine 25 и новее (ключ proxies в daemon.json появился в версии 23, на более старых версиях используйте systemd drop-in, мы покажем оба варианта).
- Git 2.40 и новее.
Если у вас Windows, все команды для npm, pip и git работают в PowerShell без изменений, отличаются только пути к файлам. Для Docker Desktop настройки прокси делаются через графический интерфейс, мы это тоже разберем.
Права доступа
Для npm, pip и git хватит прав обычного пользователя: их конфиги лежат в домашнем каталоге. Для apt и Docker понадобится sudo, потому что файлы лежат в /etc и меняют поведение системных служб.
Резервные копии
Перед началом скопируйте существующие конфиги. Одна команда на каждый файл, и вы всегда сможете вернуться к исходному состоянию:
cp ~/.npmrc ~/.npmrc.bak 2>/dev/null; cp ~/.config/pip/pip.conf ~/pip.conf.bak 2>/dev/null; cp ~/.gitconfig ~/.gitconfig.bak 2>/dev/null; sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null; sudo cp -r /etc/apt/apt.conf.d /etc/apt/apt.conf.d.bak 2>/dev/nullХвост 2>/dev/null нужен, чтобы команда не ругалась, если файла еще нет. Это нормально: у многих пользователей .npmrc и pip.conf изначально отсутствуют.
Совет: заведите в домашнем каталоге папку proxy-configs и держите там эталонные версии всех пяти конфигов. Переезд на новую машину превратится в копирование пяти файлов.
Базовые понятия: почему переменных окружения не хватает
Разберемся, что происходит под капотом, иначе шаги дальше будут выглядеть набором магических заклинаний.
Что такое прокси в контексте пакетного менеджера
Прокси-сервер - это посредник. Вместо того чтобы соединяться с registry.npmjs.org напрямую, ваш npm соединяется с прокси и просит его сходить на registry.npmjs.org. Для HTTPS-ресурсов используется метод CONNECT: прокси устанавливает туннель, и шифрованный трафик проходит через него без расшифровки. Пакетному менеджеру важно знать адрес прокси, порт и, при необходимости, учетные данные.
Как инструменты узнают о прокси
Существуют три слоя настроек, и они складываются в цепочку приоритетов:
- Флаги командной строки: например, pip install --proxy. Действуют один запуск.
- Собственный конфиг инструмента: .npmrc, pip.conf и другие. Действуют всегда для этого инструмента.
- Переменные окружения: http_proxy, https_proxy, no_proxy. Действуют для всех программ в текущей сессии, которые их читают.
Ключевое слово - которые их читают. И здесь начинаются проблемы.
Четыре причины, почему переменных окружения недостаточно
Причина первая: смена пользователя. Когда вы пишете sudo apt update, команда выполняется от root, а sudo по умолчанию очищает окружение (опция env_reset). Ваши http_proxy остаются у обычного пользователя. Более того, сам apt скачивает файлы под служебным пользователем _apt, у которого вообще нет вашей сессии.
Причина вторая: демоны и службы. Docker Engine - это фоновая служба, запущенная systemd при старте системы. Она никогда не видела ваш терминал. Команда docker pull лишь отправляет запрос демону, а скачивает образ демон. Поэтому переменные в вашей консоли на docker pull не влияют совсем.
Причина третья: разное толкование. Одни программы читают только строчные http_proxy, другие только HTTP_PROXY, третьи оба варианта. Старые версии npm игнорировали no_proxy. Некоторые инструменты не понимают учетные данные в переменной. Собственный конфиг избавляет от угадывания.
Причина четвертая: гранулярность. Переменная окружения либо есть, либо нет. А вам может понадобиться отправлять через прокси только github.com, но не внутренний GitLab. Или ходить в публичный PyPI через прокси, а во внутренний индекс напрямую. Такие правила умеют только конфиги: git поддерживает настройку прокси на конкретный URL, apt - на конкретный хост, Docker - список исключений на уровне демона.
Кодирование спецсимволов в пароле
Логин и пароль в конфигах передаются внутри URL вида http://user:password@host:port. Символы @, :, /, #, ?, % и пробел внутри пароля ломают разбор адреса. Их нужно заменить на процентные коды: @ становится %40, : становится %3A, # становится %23, / становится %2F, % становится %25, пробел - %20. Например, пароль p@ss:1 в конфиге запишется как p%40ss%3A1. Запомните это правило, оно спасет вас во всех пяти инструментах.
Шаг 1: Проверяем прокси и готовим эталонную строку
Цель этапа: убедиться, что прокси вообще работает, и получить одну проверенную строку подключения, которую мы будем вставлять во все конфиги.
- Откройте терминал. В Linux это Ctrl+Alt+T, в Windows - PowerShell через меню Пуск.
- Соберите строку подключения по шаблону http://ЛОГИН:ПАРОЛЬ@АДРЕС:ПОРТ. Без авторизации - просто http://АДРЕС:ПОРТ. Пример: http://dev:s3cret@10.20.30.40:3128.
- Выполните тестовый запрос через curl, явно указав прокси флагом -x, чтобы не зависеть от переменных:
curl -x http://dev:s3cret@10.20.30.40:3128 -I https://registry.npmjs.org/ - Дождитесь ответа. Он должен начинаться со строки HTTP/2 200 или HTTP/1.1 200 OK. Если видите 407 Proxy Authentication Required - неверный логин или пароль. Если Could not resolve proxy - опечатка в адресе. Если connection refused - неверный порт или прокси выключен.
- Повторите проверку для остальных целей: https://pypi.org/simple/, https://deb.debian.org/, https://registry-1.docker.io/v2/, https://github.com/. Для Docker нормален ответ 401, это значит, что до реестра вы дошли и он просит токен.
- Запишите итоговую строку в свой текстовый файл. Это ваша эталонная строка прокси.
Внимание: если пароль содержит спецсимволы, кодируйте их именно на этом шаге и проверяйте закодированный вариант через curl. Тогда во всех последующих конфигах вы будете вставлять уже заведомо рабочую строку.
Совет: если провайдер выдает вам не один прокси, а пул адресов или мобильный прокси с ротацией IP, обычно у него есть единый точка входа: один хост и порт, за которым IP меняются автоматически. Прописывайте в конфиги именно эту точку входа, а не конкретные IP из пула, иначе настройки устареют при первой же ротации.
Проверка: curl с флагом -x возвращает код 200 (или 401 для Docker Hub) по всем пяти адресам. Если хотя бы один не отвечает, не переходите дальше: конфиги не починят неработающий прокси.
Шаг 2: Настраиваем npm через файл .npmrc
Цель этапа: npm install, npm view и npm publish работают через прокси из любого проекта и любой консоли, включая среды разработки, которые запускают npm сами.
Где живет конфиг npm
npm читает настройки из нескольких файлов по возрастанию приоритета: встроенные значения, глобальный файл в каталоге установки npm, пользовательский ~/.npmrc (в Windows - C:\Users\ИМЯ\.npmrc) и проектный .npmrc в корне проекта рядом с package.json. Для прокси почти всегда используют пользовательский файл: он применяется ко всем проектам, но не попадает в репозиторий.
Пошаговая настройка
- Задайте прокси для обычного HTTP-трафика:
npm config set proxy http://dev:s3cret@10.20.30.40:3128 - Задайте прокси для HTTPS-трафика (реестр npm работает по HTTPS, поэтому эта настройка главная):
Обратите внимание: значение начинается с http://, а не https://. Это адрес самого прокси, а он обычно принимает соединения по обычному HTTP, даже когда туннелирует HTTPS.npm config set https-proxy http://dev:s3cret@10.20.30.40:3128 - Если у вас есть внутренний реестр или зеркало, к которому нужно ходить напрямую, добавьте исключения через запятую:
Точка перед доменом означает все поддомены.npm config set noproxy localhost,127.0.0.1,.corp.local - Откройте файл и убедитесь, что строки записались:
В Windows: type $env:USERPROFILE\.npmrc. Вы должны увидеть три строки вида ключ=значение.cat ~/.npmrc - Если корпоративный прокси подменяет сертификаты, добавьте корневой сертификат компании:
Не отключайте проверку сертификатов через strict-ssl=false без крайней необходимости: это открывает путь к подмене пакетов.npm config set cafile /etc/ssl/certs/corp-root.pem
Альтернативный путь - создать файл вручную. Содержимое ~/.npmrc будет таким:
proxy=http://dev:s3cret@10.20.30.40:3128 https-proxy=http://dev:s3cret@10.20.30.40:3128 noproxy=localhost,127.0.0.1,.corp.localКаждая пара должна быть на отдельной строке. Без кавычек и пробелов вокруг знака равенства.
Что насчет yarn и pnpm
Yarn Classic (1.x) читает тот же ~/.npmrc и дополнительно свой ~/.yarnrc с ключами proxy и https-proxy. Yarn Berry (2+) хранит настройки в .yarnrc.yml: ключи httpProxy и httpsProxy. pnpm полностью совместим с .npmrc, ничего дополнительно делать не нужно. Также стоит помнить, что npm ci и корпоративные IDE запускают npm тем же пользователем, поэтому пользовательский .npmrc покрывает и их.
Совет: команда npm config list --json покажет итоговую конфигурацию с учетом всех файлов. Если вы видите proxy=null, значит, файл не прочитался: проверьте, что он лежит в домашнем каталоге именно того пользователя, под которым запускаете npm.
Проверка: выполните npm view lodash version. Через 1-3 секунды должна вернуться строка с номером версии. Для наглядности можно временно снять переменные окружения (unset http_proxy https_proxy) и повторить: npm все равно должен работать, потому что читает .npmrc.
Возможные проблемы
- ETIMEDOUT или ECONNRESET: неверный адрес или порт прокси, либо прокси блокирует CONNECT на порт 443. Проверьте эталонную строку через curl.
- 407 Proxy Authentication Required: ошибка в логине или пароле, чаще всего незакодированный спецсимвол.
- UNABLE_TO_GET_ISSUER_CERT_LOCALLY: прокси подменяет сертификат, нужен cafile с корпоративным корневым сертификатом.
Шаг 3: Настраиваем pip через pip.conf
Цель этапа: pip install и pip download работают через прокси, в том числе внутри виртуальных окружений и при запуске из Python-скриптов.
Где искать pip.conf
pip использует три уровня файлов: глобальный (для всей системы), пользовательский и уровень виртуального окружения. Пути зависят от системы:
- Linux, пользовательский: ~/.config/pip/pip.conf (устаревший вариант ~/.pip/pip.conf тоже читается).
- Linux, глобальный: /etc/pip.conf.
- macOS, пользовательский: ~/Library/Application Support/pip/pip.conf, а если этой папки нет - ~/.config/pip/pip.conf.
- Windows, пользовательский: %APPDATA%\pip\pip.ini, то есть C:\Users\ИМЯ\AppData\Roaming\pip\pip.ini.
- Внутри виртуального окружения: файл pip.conf (или pip.ini) прямо в корне каталога venv.
Чтобы не гадать, спросите сам pip: команда pip config debug выведет все пути, которые он проверяет, и пометит существующие файлы.
Пошаговая настройка
- Убедитесь, что pip актуальный: pip --version. Должна быть версия 24 или новее.
- Задайте прокси одной командой, pip сам создаст файл в правильном месте:
Здесь global означает секцию [global] в файле, а не системный уровень. Файл создается пользовательский.pip config set global.proxy http://dev:s3cret@10.20.30.40:3128 - Если прокси подменяет сертификаты, укажите корневой сертификат:
pip config set global.cert /etc/ssl/certs/corp-root.pem - Посмотрите, что получилось:
Ожидаемый вывод: global.proxy='http://dev:s3cret@10.20.30.40:3128'.pip config list - Откройте файл и проверьте формат. Он должен выглядеть так:
Каждая строка отдельно, секция в квадратных скобках сверху.[global] proxy = http://dev:s3cret@10.20.30.40:3128 cert = /etc/ssl/certs/corp-root.pem
Важное отличие pip от npm: у pip нет отдельной настройки для HTTPS-прокси. Один ключ proxy используется для всех соединений. И у pip нет прямого аналога noproxy в конфиге: исключения он берет только из переменной окружения no_proxy. Если вам нужно ходить во внутренний индекс напрямую, проще указать для него отдельный index-url и запускать pip с флагом --proxy пустым значением для этого случая, либо использовать проектный pip.conf внутри venv без строки proxy.
Совет: если у вас несколько проектов и в одном нужен прокси, а в другом нет, положите pip.conf в корень соответствующего виртуального окружения. Настройки venv имеют приоритет над пользовательскими, и вы получите разное поведение без переключения глобальных файлов.
Внимание: не добавляйте trusted-host = pypi.org, чтобы заглушить ошибки сертификатов. Это отключает проверку подлинности и позволяет любому посреднику подсунуть вам поддельный пакет. Правильное решение - ключ cert с корпоративным сертификатом.
Проверка: выполните pip download requests --no-deps -d /tmp/piptest. Через несколько секунд в каталоге появится файл requests-*.whl. Затем удалите тестовый каталог. Если хотите убедиться, что работает именно конфиг, снимите переменные окружения и повторите.
Возможные проблемы
- ProxyError или Cannot connect to proxy: опечатка в адресе или неверный порт. Сверьтесь с эталонной строкой.
- Tunnel connection failed: 407: ошибка авторизации. Проверьте кодирование пароля.
- SSLError CERTIFICATE_VERIFY_FAILED: нужен ключ cert с корневым сертификатом прокси.
- Файл записался, но pip его не видит: вы запускаете pip другого интерпретатора (например, python3 -m pip от другого Python). Выполните pip config debug именно той командой, которой устанавливаете пакеты.
Шаг 4: Настраиваем apt через каталог apt.conf.d
Цель этапа: sudo apt update и sudo apt install скачивают пакеты через прокси, а обращения к внутреннему зеркару идут напрямую.
Почему именно apt.conf.d
apt читает настройки из /etc/apt/apt.conf и всех файлов в каталоге /etc/apt/apt.conf.d/ в алфавитном порядке. Правило хорошего тона - не трогать чужие файлы, а создать свой с числовым префиксом. Число задает порядок чтения: файл 80proxy применится после 01autoremove и других системных. Именно здесь настройки переживут любые обновления пакета apt.
Пошаговая настройка
- Создайте новый файл настроек:
Откроется пустой редактор.sudo nano /etc/apt/apt.conf.d/80proxy - Впишите две строки для HTTP и HTTPS-репозиториев. Обратите внимание на кавычки и точки с запятой - в синтаксисе apt они обязательны:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; - Если есть внутреннее зеркало, для которого прокси не нужен, добавьте строку с исключением. Слово DIRECT заглавными буквами означает прямое подключение:
Acquire::http::Proxy::mirror.corp.local "DIRECT"; - Сохраните файл: в nano нажмите Ctrl+O, затем Enter, затем Ctrl+X для выхода.
- Ограничьте права на файл, ведь в нем пароль:
Только root сможет прочитать содержимое.sudo chmod 600 /etc/apt/apt.conf.d/80proxy - Проверьте, что apt разобрал файл без синтаксических ошибок:
Вы должны увидеть строки Acquire::http::Proxy и Acquire::https::Proxy со своими значениями.apt-config dump | grep -i proxy
Вот полный пример файла для наглядности:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::http::Proxy::mirror.corp.local "DIRECT"; Acquire::https::Proxy::mirror.corp.local "DIRECT";Альтернатива на один запуск без файла: sudo apt -o Acquire::http::Proxy="http://10.20.30.40:3128" update. Флаг -o удобен, чтобы протестировать значение перед записью в конфиг.
Совет: у прокси-серверов, которые сами кэшируют deb-пакеты, часто есть отдельный порт для apt. Уточните у администратора: если такой есть, apt update ускорится в несколько раз за счет локального кэша.
Проверка: выполните sudo apt update. В выводе появятся строки Hit или Get с адресами репозиториев и не будет строк с Err. Обратите внимание, что мы не выставляли переменных окружения и sudo их в любом случае сбросил бы, а apt все равно вышел в сеть. Это и есть эффект собственного конфига.
Возможные проблемы
- Err: 407 Proxy Authentication Required: авторизация не прошла, проверьте кодирование спецсимволов.
- Could not connect или Connection timed out: apt пошел напрямую. Скорее всего, в файле опечатка, и apt-config dump ее не показывает. Проверьте регистр в Acquire и двойные двоеточия.
- E: Syntax error: пропущена точка с запятой или кавычка в конце строки.
- Файл на месте, но исключение DIRECT не работает: убедитесь, что имя хоста в строке исключения совпадает с именем в sources.list буква в букву, без http:// и без порта.
Шаг 5: Настраиваем Docker на двух уровнях
Цель этапа: docker pull, docker build и docker compose pull скачивают образы через прокси, а контейнеры при необходимости получают настройки прокси автоматически.
Два уровня, которые часто путают
У Docker есть два независимых места, где прокси нужен по-разному:
- Уровень демона (служба dockerd). Именно он скачивает образы из реестра. Настраивается в /etc/docker/daemon.json или через systemd. Требует перезапуска службы.
- Уровень клиента (файл ~/.docker/config.json). Он не влияет на скачивание образов. Зато он автоматически передает переменные прокси внутрь запускаемых контейнеров и в процесс сборки, чтобы apt или pip внутри контейнера тоже видели прокси.
Настроите только клиент - docker pull не заработает. Настроите только демон - образы качаются, но RUN apt-get update внутри Dockerfile упадет. Нужны оба.
Часть А: демон через daemon.json
- Проверьте версию: docker version. Если версия сервера 23.0 или новее, используйте daemon.json. Если старше, перейдите к части Б.
- Откройте файл настроек демона:
Если файл уже есть и содержит другие ключи, добавьте блок proxies внутрь тех же фигурных скобок через запятую. Если файла нет, создайте с нуля.sudo nano /etc/docker/daemon.json - Впишите блок настроек:
Обратите внимание: ключи пишутся через дефис и в нижнем регистре именно так. Это формат демона, у клиента ключи будут другими.{ "proxies": { "http-proxy": "http://dev:s3cret@10.20.30.40:3128", "https-proxy": "http://dev:s3cret@10.20.30.40:3128", "no-proxy": "localhost,127.0.0.0/8,registry.corp.local" } } - Сохраните файл (Ctrl+O, Enter, Ctrl+X).
- Проверьте, что JSON валидный, иначе демон не запустится:
Если команда вывела содержимое файла с отступами - синтаксис верный. Если ругается на Expecting value или Extra data - ищите лишнюю или пропущенную запятую.python3 -m json.tool /etc/docker/daemon.json - Перезапустите службу:
Перезапуск займет 5-15 секунд. Все запущенные контейнеры при этом остановятся, поэтому делайте это в спокойный момент.sudo systemctl restart docker - Убедитесь, что демон поднялся: sudo systemctl status docker. Должна быть надпись active (running) зеленым цветом.
Внимание: одна лишняя запятая в daemon.json - и Docker не стартует вовсе, а вместе с ним упадут все контейнеры на машине. Всегда проверяйте файл через json.tool перед перезапуском и держите резервную копию рядом.
Часть Б: демон через systemd (для старых версий и как альтернатива)
- Создайте каталог для дополнительных настроек службы: sudo mkdir -p /etc/systemd/system/docker.service.d
- Создайте файл: sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
- Впишите:
[Service] Environment="HTTP_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="HTTPS_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="NO_PROXY=localhost,127.0.0.0/8,registry.corp.local" - Сохраните и примените: sudo systemctl daemon-reload, затем sudo systemctl restart docker.
Да, здесь используются переменные окружения, но заданы они не в вашей консоли, а в определении службы: демон получает их при старте от systemd. Это единственный способ для Docker старше 23-й версии. Если у вас заданы и daemon.json, и systemd-файл, приоритет у daemon.json.
Часть В: клиент через ~/.docker/config.json
- Откройте или создайте файл nano ~/.docker/config.json. Если файл уже содержит блок auths с вашими логинами в реестры, не удаляйте его, а добавьте новый блок рядом через запятую.
- Впишите:
Здесь ключи в стиле camelCase: httpProxy, httpsProxy, noProxy. Это отличие от daemon.json, и путать их нельзя.{ "proxies": { "default": { "httpProxy": "http://dev:s3cret@10.20.30.40:3128", "httpsProxy": "http://dev:s3cret@10.20.30.40:3128", "noProxy": "localhost,127.0.0.0/8,.corp.local" } } } - Сохраните файл. Перезапуск ничего не требуется, клиент читает его при каждой команде.
Теперь при docker run и docker build в контейнер автоматически попадут переменные HTTP_PROXY, HTTPS_PROXY и NO_PROXY (в обоих регистрах). Значит, apt-get и pip внутри Dockerfile тоже пойдут через прокси без ручных ARG и ENV.
Docker Desktop на Windows и macOS
Откройте настройки через иконку в трее, раздел Resources, подраздел Proxies. Переключите Manual proxy configuration, впишите адрес в поля Web Server (HTTP) и Secure Web Server (HTTPS), список исключений - в Bypass proxy settings for these hosts and domains. Нажмите Apply and restart. Клиентский config.json на Windows лежит в C:\Users\ИМЯ\.docker\config.json и настраивается так же, как описано выше.
Совет: команда docker info выводит секцию с HTTP Proxy, HTTPS Proxy и No Proxy. Это самый быстрый способ понять, увидел ли демон ваши настройки, не запуская скачивание.
Проверка: выполните docker pull hello-world. Образ весит несколько килобайт и скачается за пару секунд, в конце появится Status: Downloaded newer image. Затем проверьте клиентскую часть: docker run --rm alpine env | grep -i proxy. В выводе должны быть строки HTTP_PROXY и HTTPS_PROXY с вашим адресом.
Возможные проблемы
- Docker не стартует после правки daemon.json: ошибка синтаксиса. Посмотрите sudo journalctl -u docker -n 30, там будет указана строка с ошибкой. Восстановите из резервной копии.
- docker pull висит и падает по таймауту, хотя docker info показывает прокси: демон не перезапускался после правки, или прокси не пропускает CONNECT к registry-1.docker.io. Проверьте эталонную строку через curl.
- Внутри сборки apt-get update падает, а docker pull работает: не настроен клиентский config.json, или сборка идет через удаленный builder, который читает другой файл.
- Контейнер получил прокси, но не может достучаться до соседнего контейнера: добавьте имена внутренних сервисов и подсеть Docker в noProxy.
Шаг 6: Настраиваем git через git config
Цель этапа: git clone, fetch, pull и push по HTTPS идут через прокси, при этом для внутреннего сервера можно оставить прямое подключение, а для конкретного хостинга - задать отдельный прокси.
Где git хранит настройки
Три уровня: системный (/etc/gitconfig), глобальный для пользователя (~/.gitconfig, в Windows - C:\Users\ИМЯ\.gitconfig) и локальный внутри репозитория (.git/config). Прокси обычно задают глобально, а точечные исключения - тоже глобально, но с привязкой к URL.
Пошаговая настройка
- Задайте прокси для всех HTTPS- и HTTP-соединений одной командой:
В отличие от npm, у git нет отдельного https.proxy для протокола HTTPS: ключ http.proxy применяется к обоим. Настройка https.proxy встречается в старых инструкциях, но это не стандартный ключ git, и он игнорируется.git config --global http.proxy http://dev:s3cret@10.20.30.40:3128 - Если для внутреннего сервера прокси не нужен, задайте пустое значение именно для его URL:
Пустая строка означает прямое подключение. Часть между http. и .proxy - это префикс URL, к которому применяется правило.git config --global http.https://git.corp.local.proxy "" - Если для отдельного хостинга нужен другой прокси (например, выделенный мобильный), укажите его так же с привязкой к URL:
git config --global http.https://github.com.proxy http://dev:s3cret@10.20.30.41:3128 - Если прокси подменяет сертификаты, добавьте корневой сертификат:
git config --global http.sslCAInfo /etc/ssl/certs/corp-root.pem - Проверьте итоговый файл:
Вы увидите строки http.proxy=... и http.https://git.corp.local.proxy= с пустым значением.git config --global --list | grep -i proxy
Файл ~/.gitconfig после этих команд будет выглядеть так:
[http] proxy = http://dev:s3cret@10.20.30.40:3128 sslCAInfo = /etc/ssl/certs/corp-root.pem [http "https://git.corp.local"] proxy = [http "https://github.com"] proxy = http://dev:s3cret@10.20.30.41:3128Такая гранулярность недостижима через переменные окружения: no_proxy умеет только исключать хосты, но не назначать разные прокси разным серверам.
А что с SSH-адресами
Настройка http.proxy не влияет на адреса вида git@github.com:user/repo.git, потому что это протокол SSH, а не HTTP. Если ваш прокси допускает туннелирование на порт 22 через CONNECT, можно настроить SSH-клиент в файле ~/.ssh/config с директивой ProxyCommand и утилитой nc или corkscrew. Но многие корпоративные прокси такие соединения запрещают. Самый простой и предсказуемый путь - переключить удаленные адреса на HTTPS: git remote set-url origin https://github.com/user/repo.git и использовать токен доступа вместо пароля.
Совет: чтобы не хранить пароль прокси в ~/.gitconfig открытым текстом, можно вынести его в отдельный файл с правами 600 и подключить директивой include. Создайте ~/.gitconfig-proxy с секцией [http], а в основном файле добавьте [include] path = ~/.gitconfig-proxy. Основной конфиг тогда можно спокойно показывать коллегам.
Проверка: выполните git ls-remote https://github.com/git/git.git HEAD. Через пару секунд вернется строка с хэшем коммита и словом HEAD. Команда не создает файлов и ничего не клонирует, это идеальный тест сетевой части. Затем проверьте исключение: git ls-remote до внутреннего сервера должен работать и при недоступном прокси.
Возможные проблемы
- Failed to connect to proxy или Could not resolve proxy: опечатка в адресе.
- Received HTTP code 407 from proxy after CONNECT: ошибка авторизации, проверьте кодирование пароля.
- SSL certificate problem: unable to get local issuer certificate: нужен http.sslCAInfo. Не используйте http.sslVerify false на постоянной основе.
- Правило для URL не применяется: префикс должен совпадать с началом адреса в remote. Если remote записан как https://www.github.com, то правило для https://github.com не сработает.
Проверка результата: сводный чек-лист
Настроив все пять инструментов, прогоните финальную проверку. Она специально построена так, чтобы исключить влияние переменных окружения и убедиться, что работают именно конфиги.
- Откройте новый терминал и снимите переменные, если они заданы: unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY. В PowerShell: Remove-Item Env:HTTP_PROXY и аналогично для остальных.
- Проверьте npm: npm view express version. Ожидается номер версии.
- Проверьте pip: pip download six --no-deps -d /tmp/t. Ожидается скачанный whl-файл.
- Проверьте apt: sudo apt update. Ожидаются строки Hit или Get без Err.
- Проверьте Docker: docker pull hello-world и docker run --rm alpine env | grep -i proxy. Ожидается скачанный образ и переменные в контейнере.
- Проверьте git: git ls-remote https://github.com/git/git.git HEAD. Ожидается хэш коммита.
Показатели успешного выполнения
- Все шесть команд отработали без переменных окружения в консоли.
- В файлах .npmrc, pip.conf, 80proxy, daemon.json, config.json и .gitconfig записана одна и та же эталонная строка прокси.
- Файлы с паролями (80proxy, daemon.json, .npmrc, pip.conf, .gitconfig) имеют права 600 или доступны только root.
- Исключения для внутренних хостов работают: обращение к ним проходит даже при выключенном прокси.
- Резервные копии исходных файлов лежат рядом и вы знаете, как их вернуть.
Проверка: если хотя бы один пункт не выполняется, вернитесь к разделу соответствующего инструмента и сравните ваш файл с примером из гайда символ за символом. В девяти случаях из десяти причина - опечатка или незакодированный символ в пароле.
Типичные ошибки и решения
Ошибка 1: код 407 Proxy Authentication Required везде
Причина: пароль содержит спецсимвол (@, :, #, %), который не был закодирован, и инструмент разобрал адрес неправильно.
Решение: закодируйте символы процентными кодами (@ в %40, : в %3A, # в %23, % в %25) и проверьте новую строку через curl -x перед записью в конфиги.
Ошибка 2: работает из терминала, не работает через sudo
Причина: sudo сбрасывает окружение, а конфиг вы пока не создали. Классика для apt.
Решение: создайте /etc/apt/apt.conf.d/80proxy как в Шаге 4. Для других инструментов под root помните, что root читает свой домашний каталог /root, а не ваш: если нужен npm или pip от root, конфиг должен лежать в /root/.npmrc или /root/.config/pip/pip.conf.
Ошибка 3: Docker не запускается после правки daemon.json
Причина: невалидный JSON: лишняя запятая после последнего элемента, пропущенная скобка, одинарные кавычки вместо двойных.
Решение: выполните sudo journalctl -u docker -n 30, найдите строку с ошибкой, исправьте файл и проверьте его через python3 -m json.tool перед следующим перезапуском. В крайнем случае восстановите daemon.json.bak.
Ошибка 4: docker pull работает, а apt-get внутри Dockerfile падает
Причина: настроен демон, но не клиент. Процессы внутри контейнера не наследуют настройки демона.
Решение: создайте ~/.docker/config.json с блоком proxies.default как в части В Шага 5. После этого docker build автоматически передаст переменные в этапы RUN.
Ошибка 5: ошибки сертификата SSL во всех инструментах
Причина: прокси выполняет проверку трафика и подставляет свой сертификат, которому система не доверяет.
Решение: получите корневой сертификат прокси в формате PEM у администратора и пропишите его: npm cafile, pip cert, git http.sslCAInfo. Для apt и Docker достаточно добавить сертификат в системное хранилище: скопируйте в /usr/local/share/ca-certificates/ и выполните sudo update-ca-certificates, затем перезапустите Docker. Не отключайте проверку сертификатов флагами strict-ssl, trusted-host и sslVerify.
Ошибка 6: pip игнорирует pip.conf
Причина: на машине несколько версий Python, и вы правите конфиг для одной, а запускаете другую. Или файл лежит в устаревшем месте, которое конкретная версия не читает.
Решение: запустите python3 -m pip config debug той же командой, которой ставите пакеты. Вывод покажет, какие файлы найдены. Перенесите настройки в найденный пользовательский путь.
Ошибка 7: git идет через прокси даже к внутреннему серверу
Причина: правило исключения задано для URL, который не совпадает с адресом в remote. Или задано в локальном .git/config другого репозитория.
Решение: посмотрите точный адрес через git remote -v, скопируйте его начало вплоть до имени хоста и задайте правило http.ТОЧНЫЙ_URL.proxy с пустым значением через --global.
Ошибка 8: все работало, а после смены пароля прокси сломалось
Причина: пароль зашит в пяти разных файлах, обновили не все.
Решение: используйте команду grep -rl 'старый_пароль' ~/.npmrc ~/.config/pip ~/.gitconfig ~/.docker и sudo grep -rl для /etc/apt/apt.conf.d и /etc/docker, чтобы найти все вхождения, и обновите каждое. Затем прогоните сводный чек-лист.
Дополнительные возможности
Локальный прокси-агрегатор как единая точка входа
Если учетные данные прокси меняются часто или пул адресов ротируется, удобно поднять на своей машине легкий локальный прокси (например, на 127.0.0.1:3128), который сам знает, куда и с какими данными ходить. Тогда во все пять конфигов вписывается один адрес без пароля, а смена реквизитов делается в одном месте. Это же решает проблему инструментов, которые плохо работают с авторизацией в URL.
Зеркала и кэширующие прокси для пакетов
Прокси не обязан быть универсальным. Для apt существуют кэширующие прокси, которые хранят deb-файлы локально и отдают их всему офису. Для npm и pip корпорации ставят приватные реестры, которые проксируют публичные и заодно кэшируют. В таком случае вместо ключа proxy используют registry в .npmrc и index-url в pip.conf, а прокси для внешнего мира настраивается уже на этом реестре. Для Docker аналогичную роль играет ключ registry-mirrors в daemon.json.
Раздельные настройки для разных проектов
Проектный .npmrc рядом с package.json, pip.conf внутри venv и локальный .git/config позволяют одному проекту ходить через прокси, а другому - напрямую. Только не коммитьте файлы с паролями в репозиторий: добавьте их в .gitignore или используйте переменные подстановки вида ${PROXY_URL}, которые npm умеет раскрывать из окружения при чтении .npmrc.
Автоматизация раскатки
Все пять конфигов - простые текстовые файлы. Их удобно раскатывать скриптом или системой управления конфигурациями: скрипт получает эталонную строку одним параметром и генерирует файлы в нужных форматах. Для проверки после раскатки используйте команды из сводного чек-листа: они не требуют интерактивности и подходят для автоматических тестов.
Безопасность хранения паролей
Минимум - права 600 на каждый файл с паролем. Лучше - вынос секретов в отдельные подключаемые файлы (include в git, отдельный файл в apt.conf.d только для строк с авторизацией). Еще лучше - прокси без авторизации по паролю, но с ограничением по IP или локальный агрегатор, о котором сказано выше. И никогда не отправляйте конфиги с паролями в чаты и тикеты целиком.
FAQ: частые вопросы по настройке
Нужно ли теперь удалять переменные http_proxy из .bashrc
Не обязательно. Конфиги инструментов имеют приоритет над переменными, конфликта не будет. Но если вы хотите, чтобы через прокси ходили только пакетные менеджеры, а браузер и прочие программы шли напрямую, переменные лучше убрать: они влияют на все.
Почему в https-proxy для npm пишется адрес с http://, а не с https://
Потому что это адрес самого прокси-сервера, а не протокол целевого ресурса. Большинство прокси принимают соединения по обычному HTTP и туннелируют HTTPS внутри. Если ваш прокси действительно принимает TLS-соединения, тогда пишите https://, но это редкость.
Можно ли использовать SOCKS5-прокси
npm - нет, он поддерживает только HTTP-прокси. pip - да, при установленном пакете pysocks и адресе вида socks5://host:port. git - да, формат socks5h://host:port, буква h означает разрешение имен на стороне прокси. apt - только через дополнительные транспорты, стандартно нет. Docker - нет. На практике проще получить у провайдера HTTP-порт.
Как быстро отключить прокси во всех инструментах
npm: npm config delete proxy и npm config delete https-proxy. pip: pip config unset global.proxy. git: git config --global --unset http.proxy. apt: удалите или переименуйте /etc/apt/apt.conf.d/80proxy. Docker: удалите блок proxies из daemon.json и config.json, перезапустите службу. Или просто верните файлы .bak из резервных копий.
Где хранить конфиги в Windows
npm: C:\Users\ИМЯ\.npmrc. pip: C:\Users\ИМЯ\AppData\Roaming\pip\pip.ini. git: C:\Users\ИМЯ\.gitconfig. Docker: C:\Users\ИМЯ\.docker\config.json для клиента и настройки Docker Desktop для демона. apt в Windows не используется, кроме WSL, где применяются Linux-пути внутри подсистемы.
Работает ли это внутри WSL
Да, WSL - это обычный Linux, все конфиги лежат по Linux-путям внутри дистрибутива. Учтите, что Docker Desktop с интеграцией WSL использует демон на стороне Windows, поэтому daemon-настройки делаются в Docker Desktop, а клиентский config.json - внутри WSL в домашнем каталоге.
Как понять, какой инструмент какой файл прочитал
npm config list --json, pip config debug, apt-config dump, docker info, git config --show-origin --list. Каждая команда показывает не только значения, но и источник, откуда они взяты. Это первое, что стоит запускать при отладке.
Почему Docker Compose не видит прокси
Compose - это клиент, он использует тот же демон и тот же ~/.docker/config.json. Если docker pull работает, а docker compose pull нет, проверьте, что вы запускаете compose тем же пользователем и что в compose-файле не переопределены переменные окружения контейнеров, которые перекрывают прокси.
Можно ли задать разные прокси для npm и pip
Да, в этом и преимущество собственных конфигов. Каждый файл независим. Например, npm может идти через один прокси, а pip через другой, с другим IP и другой геолокацией, если так требует задача.
Заключение
Давайте подведем итог. Вы проверили прокси через curl и получили эталонную строку подключения с правильно закодированным паролем. Затем прописали ее в пяти местах: в ~/.npmrc для npm, в pip.conf для pip, в /etc/apt/apt.conf.d/80proxy для apt, в daemon.json и ~/.docker/config.json для Docker и в ~/.gitconfig для git. Для каждого инструмента вы задали исключения для внутренних хостов там, где это поддерживается, и убедились, что все работает даже при полностью очищенном окружении. Именно это отличает собственные конфиги от переменных окружения: они не зависят от того, кто, откуда и через какую службу запустил команду.
Что делать дальше. Сохраните пять эталонных файлов в личную папку и напишите короткий скрипт, который раскатывает их на новую машину. Проверьте права на файлы с паролями. Если у вас есть коллеги с той же проблемой, поделитесь с ними сводным чек-листом: он экономит часы отладки.
Куда развиваться. Следующий уровень - кэширующие прокси и приватные реестры для пакетов, локальный прокси-агрегатор как единая точка входа и автоматизированная проверка сетевых настроек в пайплайнах. А если вам понадобится настроить прокси не для инструментов, а для конкретной сессии терминала или задачи в CI, для этого есть отдельное руководство про переменные окружения. Теперь вы точно знаете, где заканчиваются его возможности и начинаются возможности конфигов.