Супастаўленне праз GeoIP-праксі¶
Супастаўленне проксі GeoIP дазваляе наладам адбітка пальцаў браўзера адпавядаць месцазнаходжанню проксі, якое выкарыстоўваецца верхнім MCP Playwright. Гэта карысна, калі рэгіянальнае забеспячэнне якасці залежыць ад паслядоўнага проксі, часавага пояса, мовы і профілю лакалі.
Пакрокавыя інструкцыі: Рэгіянальны QA праз проксі.
Мост сам не стварае і не маршрутызуе трафік праксі. Ён перадае PLAYWRIGHT_MCP_PROXY_SERVER у падрыхтоўку запуску CloakBrowser. Калі супастаўленне ўключана, CloakBrowser вызначае месца выхаду наладжанага праксі і дадае адпаведныя сцягі запуску для часавага пояса, мовы браўзера, лакалі адбітка і IP-адраса WebRTC.
Што гэта мяняе¶
Калі CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true, масток можа дадаць гэтыя сцягі запуску для CloakBrowser:
--fingerprint-timezone--lang--fingerprint-locale--fingerprint-webrtc-ip
Гэта дапамагае профілю браўзера выглядаць унутрана сумяшчальным з рэгіёнам праксі-сервера. Схемы інструмента Playwright MCP і інструменты браўзера ўсё яшчэ перадаюцца без змен.
Сусветныя налады¶
Выкарыстоўвайце зменныя асяроддзя ўзроўню працэсу для кліентаў stdio і ў якасці стандартных для струменевых HTTP-сеансаў:
PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
npx -y cloakbrowser-mcp@latest
Дадайце спіс абыходу, калі некаторым хостам трэба абыходзіць праксі:
PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
PLAYWRIGHT_MCP_PROXY_BYPASS=".internal,localhost" \
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
npx -y cloakbrowser-mcp@latest
Аўтэнтыфікаваныя HTTP-праксі падтрымліваюцца шляхам убудавання ўліковых даных у PLAYWRIGHT_MCP_PROXY_SERVER. Працэнтны кадаванне спецыяльных сімвалаў у пацвярджэннях, напрыклад, выкарыстоўвайце p%40ssword для p@ssword.
Падтрымліваемыя бінарныя файлы CloakBrowser выкарыстоўваюць убудаваную аўтэнтыфікацыю ў URL і паведамляюць сапраўдны IP-адрас выхаду праксі, нават калі праксі патрабуе строгі аўтэнтыфікаваны запыт CONNECT. Старыя бінарныя файлы захоўваюць аб'ект праксі Playwright як запасны варыянт сумяшчальнасці.
Наладка Docker¶
Перадайце тыя ж зменныя кантэйнеру. Пры магчымасці захоўвайце праксі-пасведчанні ў вашым кіраўніку сакрэтаў або асяроддзі кліента MCP.
docker run --rm -i \
-e PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
-e CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest
Для Streamable HTTP у Docker апублікуйце HTTP-порт як звычайна і захавайце зменныя проксі як стандартныя для асяроддзя кантэйнера:
docker run --rm -p 127.0.0.1:3000:3000 \
-e PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
-e CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest \
--transport streamable-http --http-host 0.0.0.0 --http-port 3000
Струменевы HTTP-праксі на адну сесію¶
Патэкавыя HTTP-кліенты могуць выбраць праксі-сервер падчас ініцыялізацыі сеансу MCP. Гэта дазваляе аднаму доўгатэрміноваму серверу MCP апрацоўваць розныя рэгіянальныя сцэнарыі без перазапуску.
Дашліце метаданыя моста ў запыце initialize:
{
"params": {
"_meta": {
"io.github.swimmwatch/cloakbrowser-mcp": {
"proxyServer": "http://user:pass@proxy.example:8080",
"proxyBypass": ".internal,localhost",
"geoipProxyMatch": true
}
}
}
}
proxyServer перавызначае PLAYWRIGHT_MCP_PROXY_SERVER для гэтай HTTP-сесіі. proxyBypass перавышае PLAYWRIGHT_MCP_PROXY_BYPASS толькі калі proxyServer існуе. Калі proxyServer існуе, а proxyBypass прапускаецца, наследаваная канфігурацыя абыходу проксі для гэтай сесіі ачышчаецца.
geoipProxyMatch перавызначае налады GeoIP на ўзроўні працэсу для гэтага HTTP-сеансу. Выкарыстоўвайце true для ўключэння супастаўлення для сеансу або false для яго адключэння, нават калі сервер быў запушчаны з уключаным супастаўленнем.
Існуючыя HTTP-сесіі незваротныя. Стварыце яшчэ адну Streamable HTTP-сесію, каб пераключыцца на іншы праксі-сервер або месцазнаходжанне.
Калі proxyServer змяшчае ўліковыя даныя, захоўвайце іх у URL-кодаванні і перадавайце значэнне праз сакрэты або канфігурацыю выканання кліента, замест таго каб убудоўваць яго ў файлы праекта.
Выпадкі выкарыстання¶
- QA лакалізаванай камерцыі
Правярайце афармленне замовы, падаткі, паведамленні пра дастаўку, валюту і рэгіянальныя правілы каталога з часавым поясам і лакаллю браузера, узгодненымі з месцазнаходжаннем проксі.
- Рэгіянальныя лендынгі
Правярайце мову, згоды, кампаніі і варыянты кантэнту, якія залежаць ад рэгіёна наведвальніка.
- Паўтор зваротаў падтрымкі
Паўтарайце справаздачу з рэгіёна кліента без перазапуску ўсяго MCP-сервера для кожнага месцазнаходжання проксі.
- Сцэнарыі, адчувальныя да часавага пояса
Правярайце выбар дат, вокны браніравання, напаміны і старонкі планавання, дзе часавы пояс і лакаль павінны адпавядаць сеткаваму рэгіёну.
- Паралельныя рэгіянальныя сеансы
Запускайце асобныя сеансы Streamable HTTP з рознымі проксі, каб агент мог параўноўваць некалькі рэгіёнаў у адным серверным працэсе.
Прыярытэты і абмежаванні¶
| Вобласць | Паводзіны |
|---|---|
| Stdio | Выкарыстоўвае толькі зменныя асяроддзя і флагі CLI на ўзроўні працэсу. |
| Значэнне па змаўчанні Streamable HTTP | Выкарыстоўвае зменныя асяроддзя і флагі CLI на ўзроўні працэсу, калі метаданыя runtime не перададзены. |
| Метаданыя Streamable HTTP | initialize.params._meta["io.github.swimmwatch/cloakbrowser-mcp"] можа пераазначыць проксі і супастаўленне GeoIP для аднаго сеанса. |
| Існыя сеансы | Захоўваюць проксі і наладу GeoIP, зафіксаваныя падчас initialize. |
| Аўтэнтыфікаваны HTTP-праксі | Выкарыстоўвае ўбудаваную аўтэнтыфікацыю CloakBrowser у URL на падтрымліваемых бінарных файлах і аб'ект праксі Playwright на старых бінарных файлах. |
| Неапрацаваныя сцягі часавага пояса/лакалі | Яўныя значэнні --fingerprint-timezone, --lang і --fingerprint-locale у CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS маюць прыярытэт над значэннямі GeoIP і не дублююцца. |
| API геалакацыі браўзера | Гэта функцыя яго не наладжвае; яна толькі ўзгадняе сцягі адбітка часавага пояса, мовы і лакалі CloakBrowser. |
Даныя геалакацыі GeoIP з'яўляюцца прыблізнымі і залежаць ад IP-адраса праксі-сервера і базы даных GeoIP CloakBrowser. CloakBrowser спампоўвае і кэшуе гэту афлайн-базу даных пры першым выкарыстанні, калі яна патрэбна.
Напрыклад, наступная канфігурацыя захоўвае яўныя часавы пояс і лакаль, але працягвае выкарыстоўваць супастаўленне GeoIP для вызначэння IP-адраса выхаду праксі:
PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS='["--fingerprint-timezone=America/New_York","--lang=en-US","--fingerprint-locale=en-US"]' \
npx -y cloakbrowser-mcp@latest
Выкарыстоўвайце гэту функцыю для законнага тэсціравання на якасць, лакалізацыю і сумяшчальнасць асяроддзя. Яе нельга разглядаць як спосаб абыходу кантролю доступу або праверкі рэгіянальнай палітыкі.
Супастаўленне GeoIP спыняе запуск, калі CloakBrowser не можа вызначыць IP выхаду праксі, загрузіць або прачытаць базу GeoIP ці атрымаць часавы пояс. Пачынаючы з CloakBrowser 0.6.3, адсутнасць краіны ў табліцы лакаляў выклікае папярэджанне і выбар en-US; для Сейшэльскіх Астравоў выкарыстоўваецца en-SC. Развязанне GeoIP абмежавана 20 секундамі; першая загрузка аўтаномнай базы не ўваходзіць у гэты ліміт і можа заняць больш часу.
Звязаная канфігурацыя¶
- Канфігурацыя пералічвае ўсе зменныя асяроддзя для bridge і upstream.
- Докер тлумачыць па змаўчанні налады асяроддзя кантэйнера і публікацыю Streamable HTTP.
- Інструменты тлумачыць, чаму інструменты браўзера upstream Playwright MCP перадаюцца без змен.
Дадатковыя практычныя сцэнарыі¶
Каб выбраць паміж upstream Playwright MCP і гэтым пакетам, глядзіце параўнанне. Для хуткіх задач выкарыстоўвайце рэцэпты: пастаянны профіль, пашырэнні, reverse proxy, рэгіянальнае QA, Claude Desktop, Codex CLI і smoke-тэст CI.
CloakBrowser 0.6.0¶
Калі SOCKS5 або HTTP-проксі з аўтэнтыфікацыяй зададзены сцягам браўзера --proxy-server, context.request, page.request і route.fetch() не выкарыстоўваюць гэты проксі. Для запытаў праз маршрут браўзера выкарыстоўвайце fetch() унутры старонкі. Мост не падключае аўтаматычнае папярэджанне CloakBrowser.