Прокси в Linux: http_proxy, GNOME, apt и dnf

Что понадобится

Подготовьте четыре значения из «Моих активов»: адрес, порт, логин и пароль. Для инструментов Linux при покупке выбирайте протокол HTTP: HTTP у Proxy302 — это порт 2222 (SOCKS5 — порт 3333), а статический IP выдаётся только с одним протоколом. Эта статья только про Linux: переменные окружения, GNOME, apt и dnf. Системные настройки прокси в Windows 11 и macOS и разницу между системным прокси и прокси внутри программы разбирает руководство по настройкам прокси, а параметры curl — руководство по curl.

• руководство по настройкам прокси
• руководство по curl
• адрес, порт и логин прокси

Быстрый способ: переменные окружения в терминале

Переменная окружения — это значение с именем, которое программа читает при запуске. Консольные программы в Linux ищут прокси в переменных http_proxy, https_proxy и no_proxy. Выполните строки ниже в терминале, подставив свои HOST, PORT, USERNAME и PASSWORD, и все программы, запущенные из этого окна терминала, смогут их использовать. После закрытия окна настройка исчезает, поэтому так удобно сначала проверить прокси.

http_proxy действует для адресов http://, https_proxy — для адресов https://. В переменной записан адрес самого прокси, поэтому у HTTP-прокси в обеих переменных он начинается с http://. По документации curl, если задан ещё и ALL_PROXY, переменная конкретного протокола приоритетнее.

• Источники:
• curl: Everything curl, переменные окружения для прокси

Переменные окружения: пример

export http_proxy="http://USERNAME:PASSWORD@HOST:PORT"
export https_proxy="$http_proxy"
export no_proxy="localhost,127.0.0.1,.example.internal"
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$http_proxy"
export NO_PROXY="$no_proxy"

Замените HOST, PORT, USERNAME и PASSWORD значениями из «Моих активов».

• Источники:
• curl: Everything curl, переменные окружения для прокси

Строчные или заглавные буквы, и no_proxy

В документации curl сказано: все имена переменных прокси, кроме http_proxy, можно писать и заглавными буквами, например HTTPS_PROXY, а http_proxy принимается только строчными из-за протокола CGI (так веб-серверы передают запрос скрипту): заглавный HTTP_PROXY не раз приводил к проблемам с безопасностью. Поэтому опирайтесь на строчные имена; в примере заглавные тоже заданы, потому что некоторые программы читают только их. Как именно читать переменные, решает каждая программа: если какая-то игнорирует ваш прокси, загляните в её документацию.

no_proxy — список имён хостов через запятую, которые идут без прокси. По документации curl, имя с точкой в начале означает весь домен: .example.internal подходит к www.example.internal, а одна звёздочка * — ко всему. Добавьте localhost, 127.0.0.1 и свои внутренние адреса, чтобы локальный трафик не уходил через прокси.

• Источники:
• curl: Everything curl, переменные окружения для прокси

Спецсимволы в логине и пароле

Если в логине или пароле есть спецсимволы, закодируйте их в адресе: @ → %40, : → %3A, / → %2F, # → %23, % → %25. Иначе адрес разберётся неправильно, и прокси ответит ошибкой авторизации. Чтобы не опечататься, копируйте данные из «Моих активов». И помните: пароль в переменной или в конфиге может прочитать любой, кто видит этот файл или историю команд.

Как сделать переменные постоянными

Переменные, заданные в терминале, пропадают при его закрытии. Чтобы они остались, добавьте те же строки в файл запуска вашей оболочки: ~/.bashrc для bash, ~/.zshrc для zsh. Затем откройте новый терминал или выполните source ~/.bashrc.

Для всей системы подойдёт /etc/environment. В руководстве pam_env сказано, что это простые строки КЛЮЧ=значение, слово export игнорируется, а файл читается, только когда приложение открывает PAM-сессию. Обычно это графический и текстовый вход, но руководство их не перечисляет, поэтому после правки выйдите и войдите снова и проверьте способом ниже. Не забудьте потом убрать прокси из /etc/environment: он действует на всех пользователей и все программы.

• Источники:
• Руководство Linux: pam_env(8)

Как сделать переменные постоянными: пример

# ~/.bashrc (or ~/.zshrc): applies to every new terminal of your user
export http_proxy="http://USERNAME:PASSWORD@HOST:PORT"
export https_proxy="$http_proxy"
export no_proxy="localhost,127.0.0.1"

# /etc/environment: for the whole system, plain KEY=value lines
http_proxy=http://USERNAME:PASSWORD@HOST:PORT
https_proxy=http://USERNAME:PASSWORD@HOST:PORT
no_proxy=localhost,127.0.0.1

Первая часть — для одного пользователя, вторая — для всей системы; выберите одну из них, не обе.

• Источники:
• Руководство Linux: pam_env(8)

GNOME: Сеть > Сетевой прокси

1. Откройте раздел прокси

   Откройте «Обзор», начните вводить «Сеть», зайдите в неё и выберите в списке слева «Сетевой прокси». Этот путь описан в справке GNOME; в разных версиях названия могут отличаться.

2. Выберите «Вручную»

   Варианты: «Нет» (программы подключаются напрямую), «Вручную» и «Автоматически» (ссылка на файл настроек). Выберите «Вручную».

3. Укажите адрес и порт

   Для каждого протокола, который нужно пустить через прокси, введите адрес и порт: HTTP, HTTPS, FTP или SOCKS. Для HTTP-прокси заполните HTTP и HTTPS одним и тем же адресом и портом.

Ограничения этой панели

В справке GNOME сказано, что приложения, использующие сетевое подключение, применят эти настройки, но не сказано, какие программы их читают, и нет ни слова о логине и пароле. Браузеры и графические приложения обычно им следуют, а консольные инструменты и apt — как правило, нет: настройте их способами из других разделов. Для прокси с логином и паролем используйте переменные, а не эту панель.

• Источники:
• Справка GNOME: настройка прокси

apt (Debian, Ubuntu, Mint)

apt скачивает пакеты по своим настройкам, и sudo может не передать ему переменные вашего терминала: в руководстве sudoers сказано, что по умолчанию команда запускается в новом минимальном окружении (env_reset). Поэтому apt нужен свой файл. Создайте /etc/apt/apt.conf.d/95proxy с двумя строками ниже. В руководстве apt-transport-http описан параметр Acquire::http::Proxy и форма адреса scheme://[[user[:pass]@]host[:port]/], а значение DIRECT означает «без прокси». Там же сказано, что логин и пароль можно держать в apt_auth.conf, а не в адресе.

Параметр Acquire::https::Proxy на прочитанной нами официальной странице отдельно не описан: в apt.conf сказано лишь, что область https описана в руководстве apt-transport-https, которое мы не читали. Во многих системах для https пишут так же, поэтому оставьте вторую строку и проверьте командой sudo apt update.

• Источники:
• Руководство Ubuntu: apt.conf(5)
• Руководство Ubuntu: apt-transport-http(1)
• Руководство sudo: sudoers(5)

apt: пример

# /etc/apt/apt.conf.d/95proxy
Acquire::http::Proxy "http://USERNAME:PASSWORD@HOST:PORT/";
Acquire::https::Proxy "http://USERNAME:PASSWORD@HOST:PORT/";

Создайте файл через sudo, например sudo nano /etc/apt/apt.conf.d/95proxy.

• Источники:
• Руководство Ubuntu: apt-transport-http(1)

dnf (Fedora, RHEL, Rocky, Alma)

У dnf свои настройки в /etc/dnf/dnf.conf. В справочнике DNF для секции [main] перечислены proxy, proxy_username и proxy_password, и сказано: если proxy не задан, dnf берёт переменные curl вроде http_proxy. Логин и пароль можно записать в отдельные параметры, тогда кодировать спецсимволы не нужно.

• Источники:
• Справочник по настройке DNF

dnf: пример

# /etc/dnf/dnf.conf
[main]
proxy=http://HOST:PORT
proxy_username=USERNAME
proxy_password=PASSWORD

Добавьте три строки под существующий заголовок [main].

• Источники:
• Справочник по настройке DNF

А SOCKS5 в Linux

С curl можно использовать SOCKS5: ALL_PROXY=socks5h://USERNAME:PASSWORD@HOST:3333. В документации curl при socks5 имя сайта разрешает ваш компьютер, а при socks5h — прокси, поэтому socks5h не даёт DNS-запросам идти мимо прокси. Не рассчитывайте, что другие программы поймут такую переменную. В руководстве apt-transport-http среди схем адреса для apt указан socks5h, но на прочитанной странице dnf про SOCKS5 ничего нет; чтобы настройки совпадали, для менеджеров пакетов берите HTTP-прокси.

• Источники:
• curl: Everything curl, SOCKS-прокси

Docker и контейнеры

Переменные выше сами в контейнеры Docker не попадают, а у демона Docker свои настройки. Это разобрано в отдельном руководстве.

• настройка прокси для Docker

Как проверить, что всё работает

1. Проверьте IP выхода

   Выполните первую команду ниже. Она покажет IP, страну и сеть, которые видят сайты. Как читать поля ip, country, city и org, объясняет руководство по проверке IP прокси.

   • как проверить IP прокси

2. Проверьте менеджер пакетов

   Выполните sudo apt update или sudo dnf makecache. Если пакеты скачиваются без ошибок, файл работает. Если соединение обрывается по таймауту, прокси не используется или недоступен.

3. Сравните с прокси и без

   Запустите curl в терминале с переменными, затем в другом терминале, где их нет. IP-адреса в ответах должны отличаться.

Как проверить, что всё работает: пример

curl https://ipinfo.io/json
sudo apt update          # Debian, Ubuntu
sudo dnf makecache       # Fedora, RHEL and relatives

Первую строку выполняйте в терминале, где заданы переменные.

Как отключить прокси

В терминале выполните команду unset ниже. Удалите добавленные строки из ~/.bashrc или /etc/environment, файл /etc/apt/apt.conf.d/95proxy и строки прокси из dnf.conf, а в панели GNOME верните значение «Нет». Затем снова выполните проверку curl и убедитесь, что виден ваш обычный адрес.

Как отключить прокси: пример

unset http_proxy https_proxy no_proxy HTTP_PROXY HTTPS_PROXY NO_PROXY ALL_PROXY

Это действует только на текущий терминал, файлы правятся отдельно.

Частые ошибки

Как сделать с Proxy302

Статический ISP-прокси подходит, если серверу или рабочему компьютеру нужен один постоянный адрес: IP фиксирован на весь срок аренды и не меняется. При покупке выберите HTTP: менеджеры пакетов и большинство консольных инструментов в Linux работают с HTTP-прокси. Если важен трафик, есть ротируемые резидентные прокси с оплатой за ГБ: HTTP на порту 2222, SOCKS5 на порту 3333 адреса proxy.proxy302.com. Подробности — на странице статических резидентных прокси.

• статические резидентные прокси

Как сделать с Proxy302: шаги

1. Шаг 1

   Откройте страницу статического ISP, выберите страну, поставьте «Протокол» — HTTP, выберите срок и количество, затем проверьте стоимость и создайте.

2. Шаг 2

   Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Подключение» есть готовый пример с вашими данными. HTTP — порт 2222.

3. Шаг 3

   Подставьте значения в http_proxy и https_proxy (а при использовании apt и dnf — и в их файлы).

4. Шаг 4

   Проверьте выход командой curl https://ipinfo.io/json.

5. Шаг 5

   Из материкового Китая сначала запустите вспомогательную программу со страницы «Подключение» и держите её открытой, пока пользуетесь прокси.

   • руководство по вспомогательной программе

Цены и ограничения

Статический ISP-IP стоит $0,50 за один день и $7,99 за 30 дней, около $0,27 в день, в любой стране одинаково. Наличие по странам меняется каждый день и показано на странице заказа. Бесплатного пробного периода нет, минимальная покупка — один IP на один день.

• Источники:
• Факты о продуктах Proxy302 и прайс-лист

Частые вопросы

Что почитать дальше

Настройка прокси на компьютере

Как настроить системный прокси в Windows 11 и macOS, проверить IP и отключить прокси.

Прокси в curl

HTTP- и SOCKS5-прокси в curl: -x, учётные данные, socks5h, переменные окружения, .curlrc и проверка выхода.

Прокси для Docker: настройка

Прокси для Docker: демон для загрузки образов, Docker Desktop, аргументы сборки и переменные прокси в контейнерах, с проверкой.

Как проверить прокси: IP, страна, провайдер

Как за 30 секунд проверить IP, страну и провайдера прокси, почему сервисы расходятся в городе и что значит «чистота» IP. С нашей проверкой трёх сервисов.