На 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-инструменты, менеджеры пакетов, хорошо ведущие себя службыПеременные окружения (+ конфигурация конкретного инструмента)Просто, обратимо, область действия на процесс
Загрузка образов DockerDrop-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.