В Browser Use 1.0 нет настройки прокси для браузера, который он запускает на вашем компьютере. Чтобы агент ходил через ваш прокси, запустите Chromium с прокси сами и передайте этот браузер агенту по CDP — Chrome DevTools Protocol, через который browser-harness, движок внутри Browser Use, управляет Chrome. Если запускать браузер через Playwright, хватит нескольких строк, и это работает с HTTP-прокси, которому нужны логин и пароль.
Проверено 18 ноября 2026 года с browser-use 1.0.6, browser-harness 0.1.13, Playwright 1.65.2 (его Chromium 159.0.8154.6), Google Chrome 157.0.8103.79 и Python 3.12.16 на macOS 26.5.1. Под каждым блоком кода сказано, что запускалось, а что нет.
Короткий ответ
Вся настройка прокси для Browser Use — два вызова:
context = await p.chromium.launch_persistent_context(
profile,
proxy={'server': 'http://HOST:PORT', 'username': 'USERNAME', 'password': 'PASSWORD'},
args=['--remote-debugging-port=9242'],
)
agent = Agent(task, browser=Browser(cdp_url='http://127.0.0.1:9242'))Playwright запускает Chromium через ваш прокси и отвечает на запрос логина, а Browser(cdp_url=...) передаёт этот браузер агенту, поэтому каждая страница, которую открывает агент, идёт через прокси. Это фрагмент полного скрипта ниже, сам по себе он не запускается.
Почему не настройка Browser Use? В 1.0 старый параметр proxy остался только для облачных браузеров; для локального браузера на странице Browsers написано «Local: not yet», а ProxySettings теперь выдаёт ошибку «Browser('chromium') has no proxy yet». Подключение через cdp_url — документированный способ управлять любым браузером с CDP-эндпоинтом, как в примере с Playwright из самой документации. Это руководство только про 1.0.
Что нужно
- Python 3.11 или новее и uv, как в quickstart Browser Use.
- Прокси: хост, порт, логин и пароль. В командах ниже — заглушки.
- Ключ для модели. По умолчанию
Agentиспользует собственную модель Browser Use и читаетBROWSER_USE_API_KEY; другие модели передаются вllm=.
uv init --python 3.12 browser-use-proxy && cd browser-use-proxy
uv add 'browser-use==1.0.6' playwright
uv run playwright install chromiumexport PROXY_HOST=proxy.example.com
export PROXY_PORT=8080
export PROXY_USER=USERNAME
export PROXY_PASS=PASSWORD
export BROWSER_USE_API_KEY=YOUR_KEYКоманды установки мы запускали в таком виде; во втором блоке — заглушки для ваших значений. Для мобильного прокси ipvolt это хост, HTTP-порт, логин и пароль с карточки устройства. Для резидентных прокси хост — res.ipvolt.com, HTTP-порт — 7000, логин — тот, что панель собирает для вашей сети и страны, а пароль — ваш ключ (быстрый старт с резидентными прокси).
Полный рабочий пример
Сохраните это как agent_proxy.py:
import asyncio
import json
import os
import tempfile
from pathlib import Path
from playwright.async_api import async_playwright
from browser_use import Agent, Browser
PROXY = {
'server': f"http://{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}",
'username': os.environ['PROXY_USER'],
'password': os.environ['PROXY_PASS'],
}
CDP_PORT = 9242
def fresh_profile() -> str:
"""A new Chrome profile in which WebRTC cannot go around the proxy."""
profile = tempfile.mkdtemp(prefix='agent-')
prefs = Path(profile, 'Default', 'Preferences')
prefs.parent.mkdir()
prefs.write_text(json.dumps({'webrtc': {'ip_handling_policy': 'disable_non_proxied_udp'}}))
return profile
async def main():
async with async_playwright() as p:
context = await p.chromium.launch_persistent_context(
fresh_profile(),
headless=True,
proxy=PROXY,
args=[f'--remote-debugging-port={CDP_PORT}'],
)
try:
page = context.pages[0]
await page.goto('https://api.ipify.org')
print('Exit IP, checked by Playwright:', await page.inner_text('body'))
agent = Agent(
'Open https://api.ipify.org in the browser and return only the IP address it shows.',
browser=Browser(cdp_url=f'http://127.0.0.1:{CDP_PORT}'),
)
result = await agent.run()
print('Exit IP, reported by the agent:', result.final_result())
finally:
await context.close()
asyncio.run(main())Запустите uv run agent_proxy.py. Первая строка приходит от одного Playwright, поэтому подтверждает прокси ещё до того, как модель что-то сделает; вторая — ответ агента.
Exit IP, checked by Playwright: 203.0.113.24
Exit IP, reported by the agent: 203.0.113.24Что запускалось: именно этот файл, через тестовый прокси, который требует логин и пароль и выходит в интернет с нашего сервера. Ключа API для модели у нас не было, поэтому во время запуска место модели занял скриптовый заменитель (Pydantic AI FunctionModel), который вернул текст страницы; браузер, прокси, CDP-подключение и цикл агента были настоящими. В выводе вместо адреса нашего сервера показан адрес для документации (RFC 5737). Настоящая модель сформулирует ответ сама.
В скрипте важны три детали:
fresh_profile()записывает одну настройку Chrome, которая не даёт WebRTC раскрыть ваш настоящий адрес; подробнее — в пункте про утечки WebRTC в разделе «Устранение неполадок».- Порт отладки открыт для любой программы на компьютере, о чём документация предупреждает для локальных браузеров; на общем компьютере используйте контейнер.
- Агент, подключённый через
cdp_url, оставляет браузер запущенным, когда заканчивает, поэтому его останавливаетcontext.close().
Арендовать мобильный прокси на 1 день: Германия, O2, $9
Аккаунт не нужен. Оплатите криптовалютой и сохраните ID счёта; после этого страница заказа покажет хост, порты, логин и пароль для скрипта.
Аутентификация: HTTP и SOCKS5
Мы проверили каждый способ передать учётные данные в Google Chrome 157 и в Chromium 159 от Playwright, с одинаковым результатом:
| Настройка | Результат |
|---|---|
proxy в Playwright с username и password, HTTP-прокси | Работает, в том числе во вкладках, которые открывает агент |
proxy в Playwright с username и password, SOCKS5-прокси | Не запускается: Browser does not support socks5 proxy authentication |
SOCKS5-прокси без пароля, socks5://HOST:PORT | Работает |
Учётные данные во флаге Chrome, --proxy-server=http://USER:PASS@HOST:PORT | net::ERR_NO_SUPPORTED_PROXIES |
--proxy-server без учётных данных, прокси требует пароль | HTTP: net::ERR_INVALID_AUTH_CREDENTIALS; SOCKS5: net::ERR_SOCKS_CONNECTION_FAILED |
Документация Chromium о прокси это объясняет: Chrome «will not use any credentials embedded in the proxy settings», и «No authentication methods are supported for SOCKSv5 in Chrome», хотя в протоколе такой способ есть (RFC 1929). На ответ 407 от HTTP-прокси (RFC 9110) кто-то должен ответить, и это делает запуск через Playwright; его параметр proxy описывает логин и пароль только для HTTP-прокси. Остальные параметры прокси в Playwright разобраны в руководстве настройка прокси в Playwright.
Поэтому, если прокси требует пароль, используйте его HTTP-эндпоинт. Если без SOCKS5 с паролем не обойтись, запустите локальный форвардер, который добавляет учётные данные, и направьте браузер на него:
uv run --with pproxy pproxy -l http://127.0.0.1:8899 -r "socks5://$PROXY_HOST:$PROXY_PORT#$PROXY_USER:$PROXY_PASS"Затем запустите пример с PROXY_HOST=127.0.0.1 и PROXY_PORT=8899; форвардер пароль не запрашивает. #user:password — синтаксис pproxy для входа на удалённый прокси, а слушатель на 127.0.0.1 не пускает к вашему прокси посторонних. Что запускалось: именно эта команда через наш тестовый SOCKS5-прокси с паролем, затем agent_proxy.py, который показал тестовый выходной адрес.
Свой компьютер или Browser Use Cloud
- На своём компьютере (это руководство): любой прокси, который принимает Chromium, HTTP или SOCKS5, по правилам выше. Прокси обрабатывает браузер, Browser Use в этом не участвует.
- Browser Use Cloud:
Browser()без аргументов — облачный браузер, в котором по умолчанию включён резидентный прокси;cloud_proxy_country_code='de'выбирает другую страну, аNoneотключает прокси (Browsers: Cloud browser). На странице Proxies собственный прокси в облаке описан как функция для enterprise, которую включает отдел продаж (проекты, созданные до 13 ноября 2026 года, сохраняют доступ), с хостом, портом, необязательными логином и паролем и протоколомhttpилиhttps. Прокси отдельного браузера можно сменить без перезапуска, а{"rotate": true}запрашивает новый резидентный IP в той же стране.
Browser() из библиотеки принимает только код страны. Собственный прокси задаётся для браузеров, созданных через API, которыми управляют Playwright или другой CDP-клиент; подключение такого браузера через Browser(cdp_url=...) шло бы по схеме этого руководства. Ключа для облака у нас не было, поэтому в облаке ничего не запускалось.
Ротация и сессии
Большинству агентов хватает двух правил:
- Новый IP между задачами: для каждой задачи запускайте новый браузер и меняйте выход до её начала.
- Тот же IP, пока агент залогинен: держите один браузер и одну прокси-сессию для всех задач, которым нужен вход. Несколько агентов могут пользоваться им по очереди.
Cookies живут в профиле браузера, а выход определяет прокси, поэтому, пока агент залогинен, не должно меняться ни то, ни другое (ротационные и sticky-прокси).
import asyncio
import json
import os
import secrets
import tempfile
import urllib.request
from playwright.async_api import async_playwright
from browser_use import Agent, Browser
SERVER = f"http://{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}"
CDP_PORT = 9242
CHECK = 'Open https://api.ipify.org in the browser and return only the IP address it shows.'
def rotate_mobile_ip():
"""Dedicated mobile proxy: ask the device for a new IP with its rotation link."""
with urllib.request.urlopen(os.environ['ROTATION_LINK'], timeout=90) as response:
print('rotation:', json.load(response))
def sticky_username(job: str) -> str:
"""Residential or mobile per GB: a session ID keeps one exit for the whole job."""
return f"{os.environ['PROXY_USER']}-sid-{job}-rot-sticky-ttl-3600"
async def run_job(p, username, tasks):
"""One browser per job: one exit and one cookie jar for every task in it."""
context = await p.chromium.launch_persistent_context(
tempfile.mkdtemp(),
headless=True,
args=[f'--remote-debugging-port={CDP_PORT}'],
proxy={'server': SERVER, 'username': username, 'password': os.environ['PROXY_PASS']},
)
try:
for task in tasks:
result = await Agent(task, browser=Browser(cdp_url=f'http://127.0.0.1:{CDP_PORT}')).run()
print(username, '->', result.final_result())
finally:
await context.close()
async def main():
mobile = os.environ.get('PROXY_KIND', 'mobile') == 'mobile'
async with async_playwright() as p:
for job in range(2):
if mobile:
if job:
rotate_mobile_ip()
username = os.environ['PROXY_USER']
else:
username = sticky_username(f'job{job}_{secrets.token_hex(4)}')
await run_job(p, username, [CHECK, CHECK])
asyncio.run(main())Как это соотносится с вашим прокси:
- Мобильный прокси, выделенное устройство: один IP в каждый момент, общий для всех соединений залогиненной задачи. Между задачами вызывайте ссылку ротации устройства (
ROTATION_LINK, в разделе More controls в панели, если устройство её поддерживает) или нажимайте «Сменить IP». Пока задача залогинена, держите автоматическую ротацию выключенной и начинайте следующую задачу, когда ротация закончилась. - Резидентные прокси или мобильные IP за ГБ: сессия задаётся в логине. Без ID сессии каждое соединение выбирает выход заново, а браузер открывает много соединений на одну страницу. Добавьте ID:
-sid-NAME-rot-sticky-ttl-3600просит шлюз держать один выход час, а новый ID начинает новую сессию. ID состоит из строчных латинских букв, цифр и подчёркиваний, до 64 символов (таргетинг и сессии).
Что запускалось: rotate.py в этом виде, со скриптовой моделью, в обоих режимах. Мобильный режим работал через наш собственный тестовый HTTP-прокси с локальной заменой ссылки ротации, режим сессий — через тестовый прокси, который игнорирует логин. В каждой задаче два агента по очереди работали в одном браузере. Настоящие ротации и сессии происходят на стороне прокси и здесь не проверялись.
Мобильный или резидентный прокси для агента
Выбирайте по тому, что делает агент, а не только по типу IP. В руководстве мобильные и резидентные прокси есть оценочная таблица, чтобы проверить оба варианта.
- Выделенный мобильный прокси подходит агенту, который долго работает в одном аккаунте, или когда нужны конкретные страна и оператор. Пока идёт аренда, устройством никто больше не пользуется, а его адрес — адрес оператора, который операторы часто делят между многими абонентами (RFC 6888).
- Резидентные прокси подходят для множества коротких независимых задач в разных странах, с оплатой за ГБ и sticky-сессией на каждую задачу.
- Общие мобильные прокси — адреса операторов из общего пула модемов, с оплатой за ГБ, как у резидентных.
Прокси меняет адрес и больше ничего. Он не поможет, если блокировка вызвана самим браузером (отпечаток headless-режима или автоматизации), поведением (скорость, повторы) или стеной входа и CAPTCHA, привязанными к аккаунту. Проверьте: выполните ту же задачу в обычном браузере на своём подключении. Если блокировка есть и там, дело не в IP. Статья блокировки AI-агентов Cloudflare: что исправить в первую очередь разбирает эти случаи.
Трафик
Браузер загружает все изображения, шрифты, скрипты и видео на странице, а Chrome добавляет и собственные запросы. В нашем тесте Google Chrome, оставленный на 30 секунд на пустой странице, открыл через прокси 21 соединение в одном запуске и 22 в другом, в основном к сервисам Google, и 13 с --disable-background-networking. Chromium от Playwright открыл 4 или 5.
- Тарифы за ГБ: всё это учитывается. Резидентные прокси стоят от $0.60 за ГБ, пакетами от $5. Мобильные IP за ГБ стоят от $3 за ГБ в странах общего пула. Сначала оцените объём по статье сколько ГБ прокси нужно, а изображения и шрифты отсеките по руководству блокировка изображений и шрифтов в Playwright. Экономию с подключённым агентом мы не измеряли.
- Мобильный прокси на день: цена за время, без ограничения трафика, от $9 в день. Тяжёлые страницы цену не меняют; статья мобильный прокси на 1 день сравнивает его с 30 днями.
Устранение неполадок
- Требуется аутентификация на прокси. При запуске через Playwright неверный пароль выглядел как
Page.goto: Timeout 30000ms exceededв Chromium 159 и какnet::ERR_HTTP_RESPONSE_CODE_FAILUREв Chrome 157, а не как 407. Проверьте учётные данные одним запросом curl, затем прочитайте как исправить ошибку прокси 407. net::ERR_NO_SUPPORTED_PROXIES. Учётные данные стоят внутри--proxy-server. Передайте их в параметрproxyPlaywright или используйте форвардер выше.- Ошибка туннеля.
net::ERR_TUNNEL_CONNECTION_FAILEDзначит, что прокси отклонил CONNECT; руководство ERR_TUNNEL_CONNECTION_FAILED разбирает его ответ. Ошибка 502 или 503 сразу после ротации описана в руководстве туннель не установлен: 502/503. - Тайм-ауты. Отделите медленный прокси от медленной страницы по руководству диагностика тайм-аутов прокси.
- Прокси как будто игнорируется. Собственная сетевая часть агента на Python (
http_get,requests) работает на вашем компьютере: в нашем тестеhttp_getвернул адрес компьютера, а страница показала адрес прокси, как документация и пишет про облачные браузеры. Пишите в задаче «в браузере» и проверьте, что переданbrowser=Browser(cdp_url=...): без негоAgentзапускает облачный браузер. Для инструментов, которые читают переменные прокси, см. переменные окружения для прокси. - Утечки DNS. Журналы нашего прокси показали, что Chrome передаёт прокси имя хоста и по HTTP, и по SOCKS5, поэтому адреса назначения не разрешаются локально; документация Chromium подтверждает это для SOCKS5. Статья socks5 и socks5h: проверено показывает клиенты, которые ведут себя иначе.
- Утечки WebRTC. По умолчанию страница могла узнать через WebRTC настоящие публичные адреса IPv4 и IPv6 компьютера в обоих браузерах, а часто советуемый ключ
--force-webrtc-ip-handling-policy=disable_non_proxied_udpничего не изменил. Настройка профиляwebrtc.ip_handling_policyсо значениемdisable_non_proxied_udp, которую записываетfresh_profile(), убрала все кандидаты. Это настройка за политикой WebRtcIPHandling в Chrome, режим «force proxy» из RFC 8828. Проверьте результат статьёй проверка утечек IP, DNS и WebRTC или нашей проверкой прокси.
Вопросы
Как настроить прокси в Browser Use?
Запустите Chromium с параметром proxy Playwright и портом отладки, затем передайте агенту Browser(cdp_url='http://127.0.0.1:9242'). В версии 1.0 нет параметра прокси для локальных браузеров.
Поддерживает ли Browser Use SOCKS5-прокси?
Да, без пароля: socks5://HOST:PORT. Chromium не умеет передавать учётные данные SOCKS5, поэтому используйте HTTP-эндпоинт или локальный форвардер.
Можно ли использовать резидентный прокси с Browser Use?
Да. Укажите шлюз в параметре proxy, а sticky-ID сессии — в логине, чтобы выход не менялся, пока агент залогинен.
Можно ли использовать мобильный прокси с Browser Use?
Да. Используйте HTTP-порт, логин и пароль устройства и меняйте его IP оператора между задачами.
Какой прокси лучше для AI-агентов?
Зависит от задачи: выделенный мобильный прокси — для долгих сессий со входом или конкретного оператора, резидентный — для множества коротких задач в разных странах. Блокировку по отпечатку браузера прокси не исправит.
Есть ли прокси в Browser Use Cloud?
Да, резидентный прокси, в США, если не выбрать другую страну. Собственный прокси там — функция для enterprise.
Почему агент всё ещё показывает мой настоящий IP?
Обычно запрос пришёл не из браузера: Python-помощники агента работают на вашем компьютере. Просите открыть страницу в браузере и закройте WebRTC с помощью fresh_profile().
Переведите агента на IP оператора. Выделенный мобильный прокси ipvolt стоит от $9 в день, без ограничения трафика, по HTTP и SOCKS5. Бесплатный Proxy Toolkit MCP даёт AI-ассистенту для программирования конфигурации прокси, диагностику ошибок и эти руководства. С оплатой за ГБ резидентные прокси стоят от $0.60 за ГБ, пакетами от $5. Сравните все варианты на странице цен и проверьте любой прокси проверкой прокси. Агенты могут и сами арендовать через API и пополнять баланс своими USDC.
Арендовать мобильный прокси на 1 день: Германия, O2, $9
Аккаунт не нужен.
Источники и дополнительное чтение
Технические материалы, использованные при подготовке руководства. Сверяйтесь с документацией вашей версии и с поддерживаемой конфигурацией вашего провайдера.
- Browser Use: Browsers (cloud, local Chromium, any CDP endpoint)
- Browser Use: Examples, Combine with Playwright
- Browser Use: Quickstart
- Browser Use: Models
- Browser Use: Migrating from 0.x (proxy: local dropped for now)
- Browser Use Cloud: Proxies
- Browser Use Cloud: Playwright, Puppeteer, Selenium
- browser-use 1.0.6 source: ProxySettings removal note (legacy.py)
- browser-use 1.0.6 source: local Chrome launch flags (browser/local.py)
- browser-harness: the engine inside Browser Use
- Chrome DevTools Protocol
- Playwright for Python: BrowserType.launch_persistent_context (proxy, args)
- Chromium: proxy support in Chrome
- Chromium policy definition: WebRtcIPHandling
- RFC 8828: WebRTC IP Address Handling Requirements, section 5.2
- RFC 1929: Username/Password Authentication for SOCKS V5
- RFC 9110: 407 Proxy Authentication Required
- RFC 6888: Common Requirements for Carrier-Grade NATs
- RFC 5737: IPv4 Address Blocks Reserved for Documentation
- pproxy (python-proxy)