Как настроить прокси в VS Code: http.proxy, расширения и терминал

Что прокси не меняет

Статья о сетевой настройке. Если вы пользуетесь в VS Code ИИ-расширением, например GitHub Copilot, условия самого сервиса и его региональная доступность остаются прежними. На странице GitHub о торговых ограничениях сказано: пользователи в регионах под санкциями всё равно обязаны соблюдать торговые правила США, доступ зависит от региона, а ответственность за соблюдение лежит на самом пользователе. Прокси не делает сервис доступным там, где он недоступен, и не меняет его условий.

• Источники:
• GitHub: GitHub и торговые ограничения

Три слова простым языком

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

HOST и PORT — адрес этого компьютера и номер его «двери». USERNAME и PASSWORD подтверждают, что вам можно им пользоваться.

Расширение — небольшая надстройка, установленная в VS Code. Многие расширения, в том числе ИИ-помощники для кода, открывают собственные соединения с интернетом.

Где VS Code ищет прокси

В документации VS Code сказано, что поддержка прокси в нём точно такая же, как в Google Chromium: настройки обычно подхватываются из системы автоматически, а аргументы запуска --proxy-server, --proxy-pac-url и --no-proxy-server могут их переопределить. Для самого редактора сначала смотрите системные настройки прокси.

На той же странице сказано, что расширения пока не получили такой же поддержки прокси, а http.proxy, http.proxyStrictSSL и http.proxyAuthorization остались в настройках, но учитываются только в двух случаях. В прочитанном мной предложении эти случаи не названы, поэтому не считайте параметр рабочим, пока его не подтвердит проверка ниже.

• Источники:
• Документация Visual Studio Code: сетевые подключения

Где указать http.proxy

Откройте настройки (File → Preferences → Settings). Слева нажмите Application, затем Proxy. В поле Proxy введите адрес прокси, например http://HOST:PORT. Именно этот путь и флажок Proxy Strict SSL рядом с полем описаны в документации GitHub по Copilot; флажок оставьте включённым. После этого полностью закройте VS Code и откройте заново.

• Источники:
• GitHub Docs: настройка сети для GitHub Copilot

Где указать http.proxy: пример

{
  "http.proxy": "http://USERNAME:PASSWORD@HOST:PORT"
}

Тот же параметр в том виде, в каком он лежит в settings.json. Замените HOST, PORT, USERNAME и PASSWORD данными из «Мои активы». В прочитанных мной документах имя http.proxy не сопоставлено напрямую с полем Proxy, поэтому убедитесь в окне настроек, что вы заполнили поле именно этого параметра.

Логин и пароль: в адресе или в окне запроса

Способ 1, в адресе. В документации GitHub по Copilot сказано, что Copilot для VS Code поддерживает базовую аутентификацию, а данные можно записать прямо в адрес прокси, например http://USERNAME:[email protected]:5187/. Это самый простой путь. Но пароль тогда хранится в файле настроек открытым текстом, поэтому не делитесь этим файлом и не коммитьте его.

Способ 2, в окне запроса. В документации VS Code сказано, что за HTTP-прокси с аутентификацией должно появиться окно ввода данных, поддерживаются Basic, Digest, NTLM и Negotiate. Если вы не указали данные в адресе и окно появилось, введите их там.

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

• Источники:
• Документация Visual Studio Code: сетевые подключения
• GitHub Docs: настройка сети для GitHub Copilot

HTTP или SOCKS5

В документации VS Code сказано, что аутентификация SOCKS5 пока не реализована, поэтому для прокси с логином и паролем выбирайте HTTP. На странице Copilot про сеть SOCKS не упоминается.

• Источники:
• Документация Visual Studio Code: сетевые подключения
• GitHub Docs: настройка сети для GitHub Copilot

Параметры, которых нет в документации

В VS Code есть ещё параметр http.proxySupport, но ни одна из прочитанных мной официальных страниц не описывает его значения, поэтому в этой инструкции менять его не предлагается. Если интересно, найдите proxySupport в настройках и прочитайте описание там. Параметр http.proxyAuthorization в документации VS Code назван без описания; если данные указаны в адресе, он не нужен.

• Источники:
• Документация Visual Studio Code: сетевые подключения

Расширения, которые делают запросы сами

Многие расширения, особенно ИИ-помощники для кода, сами подключаются к своему сервису. В документации VS Code сказано, что расширения пока не получили такой же поддержки прокси, как редактор, поэтому для них важен http.proxy. Читает ли конкретное расширение http.proxy, есть ли у него своё поле для прокси или оно использует что-то другое, решает само расширение: смотрите его страницу в маркетплейсе и его настройки. Если после проверки ниже какое-то расширение всё ещё не работает, поищите прокси в его собственных настройках.

GitHub Copilot использует то же поле Proxy, что описано выше; на странице Copilot есть точные шаги и готовый пресет. Cursor построен на VS Code и имеет собственные переключатели — они разобраны в его руководстве.

• Прокси в Cursor: настройка
• Прокси в GitHub Copilot: настройка
• GitHub Copilot на Proxy302

• Источники:
• Документация Visual Studio Code: сетевые подключения
• GitHub Docs: настройка сети для GitHub Copilot

Терминал внутри VS Code

Встроенный терминал запускает обычные программы командной строки, и каждая сама решает, где искать прокси. В прочитанных мной страницах VS Code про терминал ничего не сказано, поэтому не ждите, что http.proxy подействует на то, что вы там запускаете. Большинство консольных утилит читают переменные окружения или свои параметры. В руководстве по curl перечислены переменные, которые читает curl, и их приоритет; для других утилит, например git, npm или pip, смотрите их документацию.

• Прокси в curl: настройка

Терминал: пример на один сеанс

export https_proxy="http://USERNAME:PASSWORD@HOST:PORT"
export http_proxy="http://USERNAME:PASSWORD@HOST:PORT"
curl https://ipinfo.io/json

Для иллюстрации: это имена, которые читает curl (см. руководство по curl); другие программы могут читать другие имена или не читать вовсе. Переменные действуют только в этом окне терминала. Замените HOST, PORT, USERNAME и PASSWORD данными из «Мои активы».

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

1. Проверьте сам прокси в терминале командой ниже

   Она покажет IP, страну и сеть, которые видят сайты. Если здесь ошибка — дело в данных прокси, а не в VS Code. Поля разобраны в руководстве о проверке IP, страны и провайдера прокси.

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

2. Полностью закройте VS Code и запустите снова

   Закройте редактор целиком, а не только окно, и повторите действие, которое не получилось, например вход или запрос в чате расширения.

3. Прочитайте сообщение об ошибке самого расширения

   В документации VS Code нет встроенной проверки соединения, поэтому ориентируйтесь на текст ошибки расширения и список ниже.

Проверка прокси вне редактора: пример

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

Замените HOST, PORT, USERNAME и PASSWORD данными из «Мои активы». В ответе — IP, страна и сеть, которые видят сайты.

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

• 407 Proxy Authentication Required. Прокси отклонил логин или пароль. Скопируйте данные заново и проверьте процентное кодирование.

• Ошибки сертификата. Бывают только с прокси, который подменяет сертификаты. В документации VS Code предпочтительным способом названо добавление сертификата прокси в доверенные сертификаты операционной системы, а игнорирование ошибок сертификатов названо опасным и нерекомендуемым. Не снимайте флажок Proxy Strict SSL для быстрого результата.

• Редактор в сети, а одно расширение нет. Это расширение подключается само: см. раздел про расширения.

• Таймауты. Прокси не отвечает на порту или аренда IP закончилась. Проверьте командой curl.

• Источники:
• Документация Visual Studio Code: сетевые подключения

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

Статический ISP-прокси подходит, если редактору нужен один постоянный адрес: IP не меняется весь срок аренды, а протокол выбирается при покупке. Берите HTTP: в документации VS Code сказано, что аутентификация SOCKS5 пока не реализована. Сам продукт описан на странице статических резидентных прокси.

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

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

1. Шаг 1

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

2. Шаг 2

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

3. Шаг 3

   Впишите значения в поле Proxy (http.proxy), как показано выше, полностью закройте VS Code и запустите заново.

4. Шаг 4

   Проверьте выход командой curl выше и посмотрите поля country и org — как их читать, объясняет руководство по проверке расположения прокси.

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

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

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

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

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

Читайте дальше

Прокси в Cursor: настройка

Прокси в Cursor через http.proxy, спецсимволы в пароле, переключение на HTTP/1.1, если зависает стриминг, и проверка через Run Diagnostics.

GitHub Copilot через прокси: настройка

GitHub Copilot через HTTP-прокси в VS Code и IDE JetBrains: поле прокси, базовая аутентификация, сертификаты и проверка через curl по адресу ping GitHub.

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

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

Прокси в curl

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

Статические ISP-прокси

Фиксированные статические ISP-прокси: IP резидентного уровня, неизменный весь срок. Для аккаунтов в соцсетях, магазинов и AI-сервисов. HTTP и SOCKS5.

Посмотреть параметры и цену