Супастаўленне праз GeoIP-праксі¶

Супастаўленне проксі GeoIP дазваляе наладам адбітка пальцаў браўзера адпавядаць месцазнаходжанню проксі, якое выкарыстоўваецца верхнім MCP Playwright. Гэта карысна, калі рэгіянальнае забеспячэнне якасці залежыць ад паслядоўнага проксі, часавага пояса, мовы і профілю лакалі.

Сама па сабе брыдж не стварае і не маршрутызуе трафік праксі. Маршрутызацыя праксі застаецца ў адказнасці верхняга MCP Playwright праз PLAYWRIGHT_MCP_PROXY_SERVER. Калі ўсталявана супастаўленне, MCP CloakBrowser вызначае наладжанае месцазнаходжанне праксі і дадае адпаведныя сцяжкі запуску CloakBrowser для часавага пояса, мовы браўзера і рэгіёна адбітка пальцаў.

Што гэта мяняе¶

Калі CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true, масток можа дадаць гэтыя сцягі запуску для CloakBrowser:

• --fingerprint-timezone
• --lang
• --fingerprint-locale

Гэта дапамагае профілю браўзера выглядаць унутрана сумяшчальным з рэгіёнам праксі-сервера. Схемы інструмента 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.

Наладка Docker¶

Перадайце тыя ж зменныя кантэйнеру. Пры магчымасці захоўвайце праксі-пасведчанні ў вашым кіраўніку сакрэтаў або асяроддзі кліента MCP.

docker run --rm --init -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 --init -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-кодаванні і перадавайце значэнне праз сакрэты або канфігурацыю выканання кліента, замест таго каб убудоўваць яго ў файлы праекта.

Выпадкі выкарыстання¶

Прыярытэты і абмежаванні¶

Даныя геалакацыі GeoIP з'яўляюцца прыблізнымі і залежаць ад IP-адраса праксі-сервера і базы даных GeoIP CloakBrowser. CloakBrowser спампоўвае і кэшуе гэту афлайн-базу даных пры першым выкарыстанні, калі яна патрэбна.

Выкарыстоўвайце гэту функцыю для законнага тэсціравання на якасць, лакалізацыю і сумяшчальнасць асяроддзя. Яе нельга разглядаць як спосаб абыходу кантролю доступу або праверкі рэгіянальнай палітыкі.

Звязаная канфігурацыя¶

• Канфігурацыя пералічвае ўсе зменныя асяроддзя для bridge і upstream.
• Docker тлумачыць па змаўчанні налады асяроддзя кантэйнера і публікацыю Streamable HTTP.
• Інструменты тлумачыць, чаму інструменты браўзера upstream Playwright MCP перадаюцца без змен.

Дадатковыя практычныя сцэнарыі¶

Каб выбраць паміж upstream Playwright MCP і гэтым пакетам, глядзіце параўнанне. Для хуткіх задач выкарыстоўвайце рэцэпты: пастаянны профіль, пашырэнні, reverse proxy, рэгіянальнае QA, Claude Desktop, Codex CLI і smoke-тэст CI.