Настройка мобильного прокси в Docker

Среда прокси-сервера Docker

Настройка прокси в Docker часто вызывает недопонимание, поскольку Docker работает в рамках трёх изолированных сетевых границ: демон Docker (dockerd), процесс сборки (docker build) и запущенные экземпляры контейнеров (docker run). Настройка прокси на одном уровне не распространяется на остальные. Понимание этих трёх отдельных областей применения имеет решающее значение для построения надёжных контейнерных прокси-конвейеров.

Настройка прокси-сервера для контейнеров

Чтобы направлять исходящий трафик из контейнера через выделенный мобильный прокси-сервер, необходимо во время выполнения задать стандартные переменные среды прокси. Большинство контейнерных сред выполнения (Python, Go, Node.js, cURL) автоматически считывают эти переменные при инициализации.

docker run --rm \
  -e HTTP_PROXY="http://user123:secret456@proxy.pxm2.io:8000" \
  -e HTTPS_PROXY="http://user123:secret456@proxy.pxm2.io:8000" \
  -e NO_PROXY="localhost,127.0.0.1,host.docker.internal" \
  curlimages/curl:latest https://ipinfo.io/json

В качестве альтернативы вы можете настроить файл конфигурации клиента Docker CLI (~/.docker/config.json) таким образом, чтобы настройки прокси автоматически вставлялись во все вновь запускаемые контейнеры без необходимости повторного указания флагов -e.

{
  "proxies": {
    "default": {
      "httpProxy": "http://user123:secret456@proxy.pxm2.io:8000",
      "httpsProxy": "http://user123:secret456@proxy.pxm2.io:8000",
      "noProxy": "localhost,127.0.0.1,.internal"
    }
  }
}

Настройка прокси в Docker Compose

В стеках из нескольких контейнеров Docker Compose позволяет точно контролировать, какие сервисы используют мобильные прокси, а какие взаимодействуют напрямую через локальные сети. Например, рабочие экземпляры, занимающиеся сбором данных, могут подключаться через выделенные модемы 4G/5G, в то время как сервисы баз данных и кэша Redis остаются полностью локальными.

version: '3.8'

services:
  scraper-worker:
    image: my-scraper:latest
    environment:
      - HTTP_PROXY=http://user123:secret456@proxy.pxm2.io:8000
      - HTTPS_PROXY=http://user123:secret456@proxy.pxm2.io:8000
      - NO_PROXY=localhost,127.0.0.1,postgres,redis
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: scraper_data
      POSTGRES_PASSWORD: secretpassword

  redis:
    image: redis:7-alpine

Прокси на уровне сети

Некоторые контейнерные инструменты не учитывают переменные среды или не поддерживают прокси в своём коде. В таких случаях маршрутизация на сетевом уровне или использование прокси-моделей типа «сайдкар» позволяют перенаправлять весь трафик контейнера без изменения исходного кода приложения.

Запустив контейнер-сайдкара с RedSocks или шлюз WireGuard, подключённый к хосту мобильного прокси, вы сможете перенаправлять все исходящие TCP-потоки из других контейнеров, использующих тот же сетевой пространство имён.

# Service sharing the sidecar proxy network
services:
  proxy-gateway:
    image: custom-redsocks-gateway
    cap_add:
      - NET_ADMIN
    environment:
      - PROXY_SERVER=proxy.pxm2.io
      - PROXY_PORT=1080

  legacy-app:
    image: my-app:latest
    network_mode: "service:proxy-gateway"

Устранение неполадок с прокси Docker

Распространённые проблемы при настройке мобильных прокси в контейнерах Docker и способы их решения:

Часто задаваемые вопросы

Связанные руководства по мобильным прокси-серверам

Ознакомьтесь с руководствами по настройке сред разработки, скриптов автоматизации и конфигураций серверов.

Руководства для разработчиков и по автоматизации

Платформы и операционные системы