На Linux-сервере или внутри контейнера нет диалога системного прокси; есть три механизма, и какой из них вам нужен, зависит от того, насколько программное обеспечение хорошо себя ведет. Переменные окружения (http_proxy, https_proxy, no_proxy) уважаются curl, wget, pip, apt, git, большинством HTTP-библиотек языков программирования и самим Docker — и молча игнорируются некоторыми инструментами. Обертки для отдельных процессов, такие как proxychains, заставляют отдельную программу проходить через прокси на уровне библиотек. Прозрачное перенаправление с помощью iptables и вспомогательной программы, такой как redsocks, перехватывает все исходящие TCP-соединения с хоста или контейнера, независимо от того, что программа думает, что она делает. Это руководство охватывает все три способа, ловушки в каждом из них и способы проверки результата.
Уровень 1: переменные окружения
Соглашение, более старое, чем сам Linux: если установлены http_proxy / https_proxy, используйте их; пропускайте хосты, перечисленные в no_proxy.
export http_proxy="http://user:pass@proxy.example.com:8080"
export https_proxy="http://user:pass@proxy.example.com:8080"
export no_proxy="localhost,127.0.0.1,::1,.internal,10.0.0.0/8"
curl https://api.ipify.org # идет через прокси
curl http://localhost:9000/health # напрямую, благодаря no_proxy
Моменты, которые стоят людям часов:
- Регистр. Устанавливайте и нижний, и верхний регистр (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY); инструменты расходятся во мнениях, какой из них они читают. Обратите внимание, чтоhttps_proxyпринимает URL сhttp://— он указывает прокси для HTTPS целей, а сам прокси обычно является обычным HTTP сCONNECT. - Специальные символы в пароле должны быть процентно-закодированы.
- Область действия. Переменные применяются к процессам, запущенным после их установки, в этой оболочке. Службы, запущенные systemd, не видят вашу оболочку; поместите их в
Environment=юнита или вEnvironmentFile. Cron-задания также имеют пустое окружение. sudoпо умолчанию очищает окружение; используйтеsudo -Eили настройтеenv_keep.- Кто их игнорирует. Go-программы их уважают (через
ProxyFromEnvironmentвnet/http); Python requests их уважает; встроенныйfetchв Node и многие HTTP-клиенты Node не уважают, если не использовать вспомогательные средства; Java требует флагов JVM-Dhttp.proxyHost; базы данных и пользовательские TCP-протоколы никогда на них не смотрят. Если трафик программы все еще показывает ваш реальный IP после установки переменных, это один из этих случаев — переходите на уровень 2 или 3.
У менеджеров пакетов есть свои настройки
# apt
echo 'Acquire::http::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee /etc/apt/apt.conf.d/95proxy
echo 'Acquire::https::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee -a /etc/apt/apt.conf.d/95proxy
# pip
pip config set global.proxy http://user:pass@proxy.example.com:8080
# git
git config --global http.proxy http://user:pass@proxy.example.com:8080
# npm
npm config set proxy http://user:pass@proxy.example.com:8080
npm config set https-proxy http://user:pass@proxy.example.com:8080
Уровень 1b: конкретно Docker
Docker имеет две отдельные области прокси, и их путаница — классическая ошибка контейнеров.
Демон (загрузка образов)
Загрузка образов выполняется демоном Docker, службой systemd — он не видит вашу оболочку. Настройте его в drop-in:
sudo mkdir -p /etc/systemd/system/docker.service.d
cat <<'EOF' | sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="HTTP_PROXY=http://user:pass@proxy.example.com:8080"
Environment="HTTPS_PROXY=http://user:pass@proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,registry.internal"
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker
Контейнеры (трафик от ваших приложений)
Процессы внутри контейнера имеют собственное окружение. Либо передайте переменные во время запуска:
docker run -e HTTP_PROXY=http://user:pass@proxy.example.com:8080 \
-e HTTPS_PROXY=http://user:pass@proxy.example.com:8080 \
-e NO_PROXY=localhost,127.0.0.1 myimage
или установите значения по умолчанию для всех контейнеров, запускаемых с этого клиента, в ~/.docker/config.json:
{ "proxies": { "default": {
"httpProxy": "http://user:pass@proxy.example.com:8080",
"httpsProxy": "http://user:pass@proxy.example.com:8080",
"noProxy": "localhost,127.0.0.1" } } }
Клиент внедряет эти переменные в окружение каждого контейнера (и в сборки). Внутри контейнера действуют те же предостережения: приложение должно быть таким, которое уважает переменные. В Compose используйте блок environment: для каждой службы и помните, что службы, общающиеся друг с другом по имени службы, должны быть в NO_PROXY, иначе каждый внутренний вызов будет пытаться выйти через прокси и завершится ошибкой.
Сборки
docker build получает прокси из ~/.docker/config.json или из --build-arg HTTP_PROXY=…. Не запекайте учетные данные в образ с помощью ENV; они попадут в историю слоев для любого, кто его скачает.
Уровень 2: обертки для отдельных процессов
Для программы, которая игнорирует окружение, proxychains (поддерживаемый форк — proxychains-ng, пакет proxychains4) предзагружает разделяемую библиотеку, которая перехватывает сокетные вызовы программы и направляет их через цепочку прокси, которую вы определяете:
sudo apt install proxychains4
# /etc/proxychains4.conf, внизу:
# [ProxyList]
# http proxy.example.com 8080 user pass
# или: socks5 proxy.example.com 1080 user pass
proxychains4 -q ./my-binary --that-ignores-env
Установите proxy_dns в конфигурации, чтобы поиск имен также шел через прокси (проблема утечки DNS из Как проверить прокси). Ограничения: работает только с динамически слинкованными бинарниками, использующими стандартную библиотеку сокетов — статически слинкованные Go-программы и все, что использует сырые сокеты, обходят его. Это инструмент для одного процесса за раз, идеален для тестирования и для отдельных непослушных бинарников, но не для всего хоста.
Альтернативы в том же классе: tsocks, graftcp (использует ptrace, поэтому также перехватывает статические бинарники, но с потерей производительности), а для контейнеров — запуск процесса под одной из этих оберток в качестве entrypoint.
Уровень 3: прозрачное перенаправление с iptables и redsocks
Когда вам нужно, чтобы все с хоста или контейнера выходило через прокси — включая программное обеспечение, которое вы не можете настроить — перенаправляйте на уровне ядра. iptables может переписывать исходящие TCP-соединения на локальный порт; небольшой демон, слушающий там, оборачивает каждое соединение в прокси-протокол и пересылает его. redsocks — стандартный такой демон.
sudo apt install redsocks
# /etc/redsocks.conf
base { log_debug = off; log_info = on; daemon = on; redirector = iptables; }
redsocks {
local_ip = 127.0.0.1; local_port = 12345;
ip = PROXY_IP; port = 8080;
type = http-connect; # или socks5
login = "user"; password = "pass";
}
sudo systemctl restart redsocks
# Перенаправляем весь исходящий TCP, кроме самого прокси и локальных/частных диапазонов
sudo iptables -t nat -N REDSOCKS
sudo iptables -t nat -A REDSOCKS -d PROXY_IP -j RETURN
sudo iptables -t nat -A REDSOCKS -d 127.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 10.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 172.16.0.0/12 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 192.168.0.0/16 -j RETURN
sudo iptables -t nat -A REDSOCKS -p tcp -j REDIRECT --to-ports 12345
sudo iptables -t nat -A OUTPUT -p tcp -j REDSOCKS # собственный трафик этого хоста
# для трафика из контейнеров/других хостов, маршрутизируемого через эту машину, используйте PREROUTING
Три вещи, которые нужно знать, прежде чем делать это. Правило RETURN для IP самого прокси не является необязательным — без него соединение redsocks с прокси само перенаправляется обратно в redsocks, и машина зацикливается. UDP не перенаправляется этим рецептом: DNS все равно будет идти напрямую, если вы также не перенаправите порт 53 на доверенный резолвер или не используете секцию redudp в redsocks; а QUIC/HTTP/3 просто не будет работать через прокси (см. HTTP/3 через прокси), что нормально, потому что клиенты переключаются на TCP. Тестируйте правила с таймаутом (sudo timeout 60 iptables … не существует, но держите вторую SSH-сессию открытой и будьте готовы выполнить iptables -t nat -F) — неправильное правило может отрезать вас от удаленного сервера.
Тот же паттерн работает для контейнера, если запускать правила iptables внутри него (требуется --cap-add=NET_ADMIN) или, более чисто, на хосте с трафиком контейнера, маршрутизируемым через выделенное сетевое пространство имен. Пользователи Kubernetes узнают в этом именно то, как sidecar-контейнеры service mesh захватывают трафик.
Какой уровень для какой ситуации
| Ситуация | Использовать | Почему |
|---|---|---|
| Скрипты, CLI-инструменты, менеджеры пакетов, хорошо ведущие себя службы | Переменные окружения (+ конфигурация конкретного инструмента) | Просто, обратимо, область действия на процесс |
| Загрузка образов Docker | Drop-in для демона | У демона свое окружение |
| Приложения внутри контейнеров | ~/.docker/config.json или -e | Внедряется в окружение контейнера |
| Один бинарник, игнорирующий окружение | proxychains / graftcp | Перехват на уровне сокетов; без изменений на хосте |
| Все с хоста или пространства имен, безусловно | iptables + redsocks | На уровне ядра; ничто не может отказаться |
| Разные прокси для разных назначений | Логика, подобная PAC: env no_proxy, или правила iptables для каждого диапазона назначения | Маршрутизация по цели |
Проверяйте всегда
curl -s https://api.ipify.org # уважает env: должен показать IP прокси
curl -s --noproxy '*' https://api.ipify.org # обходит env: показывает IP прокси ТОЛЬКО если уровень 3 активен
python3 -c "import urllib.request;print(urllib.request.urlopen('https://api.ipify.org').read())"
dig +short myip.opendns.com @resolver1.opendns.com # с какого IP вас видит DNS?
Вторая строка — полезный трюк: с --noproxy '*' curl игнорирует окружение, поэтому если он все еще сообщает IP прокси, прозрачное перенаправление работает; если он сообщает ваш реальный IP, активен только уровень окружения, и несоответствующее программное обеспечение будет утекать. Также проверяйте DNS отдельно — это самая распространенная утечка на серверах, поскольку резолверы настраиваются системно, и ничто из трех уровней выше не перенаправляет UDP, если вы этого не сделаете.
Для выбора типа прокси за всем этим — датацентровые для большинства серверных работ, ISP для стабильной идентичности, резидентные там, где этого требует цель — см. сравнение типов прокси; заметки со стороны провайдера для Linux-нагрузок — в нашем рейтинге Linux-прокси.
Часто задаваемые вопросы
Как установить прокси для всего Linux-сервера?
Для совместимого программного обеспечения экспортируйте http_proxy/https_proxy/no_proxy системно (например, в /etc/environment) и настройте службы через systemd Environment=. Для действительно всего используйте перенаправление iptables на redsocks.
Как заставить Docker использовать прокси?
Два места: демон (для загрузок) через systemd drop-in с HTTP_PROXY, и контейнеры через proxies в ~/.docker/config.json или переменные -e. Они независимы; установите оба, если нужны оба.
Почему моя программа игнорирует http_proxy?
Не все программное обеспечение его читает — Node fetch, Java, базы данных и пользовательские протоколы не читают. Используйте настройку конкретного инструмента, обертку типа proxychains или прозрачное перенаправление.
Что такое redsocks?
Демон, который принимает TCP-соединения, перенаправленные ему через iptables, и пересылает их через HTTP CONNECT или SOCKS-прокси, обеспечивая прозрачный прокси для любого приложения без настройки приложения.
Обрабатывает ли прозрачное перенаправление DNS и UDP?
Не по базовому рецепту — он перенаправляет TCP. Перенаправьте DNS явно (или укажите резолвер на доверенный сервер) и ожидайте, что протоколы на основе UDP, такие как QUIC, будут переключаться на TCP.
Должны ли контейнеры использовать SOCKS5 или HTTP-прокси?
HTTP с CONNECT покрывает HTTPS-цели и ожидается переменными окружения; SOCKS5 нужен только для не-HTTP TCP-трафика, и тогда через proxychains или redsocks в режиме socks5.