Ağ vekil sunucusu

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Neden proxy kullanılır

• Merkezi ilke: her uygulama HTTP çağrı noktasının ağ kurallarını doğru uygulamasına güvenmek yerine tek bir dışa çıkış ilkesi yönetin.
• Bağlantı zamanı kontrolleri: hedefi DNS çözümlemesinden sonra ve proxy yukarı akış bağlantısını açmadan hemen önce değerlendirin.
• DNS yeniden bağlama savunması: uygulama düzeyindeki DNS kontrolü ile gerçek giden bağlantı arasındaki boşluğu azaltın.
• Daha geniş JavaScript kapsamı: sıradan fetch, node:http, node:https, WebSocket, axios, got, node-fetch ve benzeri istemcileri aynı yol üzerinden yönlendirin.
• Denetlenebilirlik: izin verilen ve reddedilen hedefleri dışa çıkış sınırında günlüğe kaydedin.
• Operasyonel denetim: OpenClaw’u yeniden derlemeden hedef kurallarını, ağ segmentasyonunu, hız sınırlarını veya giden izin listelerini uygulayın.

​

OpenClaw trafiği nasıl yönlendirir

OpenClaw process
  fetch                  -> operator-managed filtering proxy -> public internet
  node:http and https    -> operator-managed filtering proxy -> public internet
  WebSocket clients      -> operator-managed filtering proxy -> public internet

• Undici dispatcher yönlendirmesi fetch, undici destekli istemciler ve kendi undici dispatcher’ını sağlayan taşıma katmanlarını kapsar.
• global-agent yönlendirmesi, http.request, https.request, http.get ve https.get üzerine kurulu birçok kütüphane dahil olmak üzere Node çekirdeği node:http ve node:https çağrılarını kapsar. Yönetilen proxy modu, açık Node HTTP agent’larının operatör proxy’sini yanlışlıkla atlamaması için bu global agent’ı zorunlu kılar.

​

İlgili proxy terimleri

• proxy.enabled / proxy.proxyUrl: OpenClaw çalışma zamanı dışa çıkışı için giden ileri-proxy yönlendirmesi. Bu sayfa bu özelliği belgeler.
• gateway.auth.mode: "trusted-proxy": Gateway erişimi için gelen kimlik duyarlı ters-proxy kimlik doğrulaması. Bkz. Güvenilir proxy kimlik doğrulaması.
• openclaw proxy: geliştirme ve destek için yerel hata ayıklama proxy’si ve yakalama inceleyicisi. Bkz. openclaw proxy.
• tools.web.fetch.useTrustedEnvProxy: varsayılan katı DNS pinleme ve ana makine adı ilkesini korurken web_fetch için operatör denetimli HTTP(S) env proxy’sinin DNS çözümlemesine izin veren katılım seçeneği. Bkz. Web fetch.
• Kanal veya sağlayıcıya özgü proxy ayarları: belirli bir taşıma katmanı için sahipliğe özgü geçersiz kılmalar. Amaç çalışma zamanı genelinde merkezi dışa çıkış denetimi olduğunda yönetilen ağ proxy’sini tercih edin.

​

Yapılandırma

proxy:
  enabled: true
  proxyUrl: http://127.0.0.1:3128

OPENCLAW_PROXY_URL=http://127.0.0.1:3128 openclaw gateway run

​

Gateway Loopback Modu

proxy:
  enabled: true
  proxyUrl: http://127.0.0.1:3128
  loopbackMode: gateway-only # gateway-only, proxy, or block

• gateway-only (varsayılan): OpenClaw, yerel Gateway WebSocket trafiğinin doğrudan bağlanabilmesi için Gateway loopback yetkilisini etkin global-agent NO_PROXY denetleyicisine kaydeder. Etkin Gateway URL’sinin ana makinesi ve portu kaydedildiği için özel loopback Gateway portları çalışır.
• proxy: OpenClaw bir Gateway loopback NO_PROXY yetkilisi kaydetmez, bu nedenle yerel Gateway trafiği yönetilen proxy üzerinden gönderilir. Proxy uzaktaysa, OpenClaw ana makinesinin loopback hizmeti için proxy’den erişilebilir bir ana makine adına, IP’ye veya tünele eşleme gibi özel yönlendirme sağlamalıdır. Standart uzak proxy’ler 127.0.0.1 ve localhost değerlerini OpenClaw ana makinesinden değil, proxy ana makinesinden çözümler.
• block: OpenClaw, bir soket açmadan önce loopback Gateway denetim düzlemi bağlantılarını reddeder.

openclaw config set proxy.enabled true
openclaw config set proxy.proxyUrl http://127.0.0.1:3128
openclaw gateway install --force
openclaw gateway start

​

Proxy Gereksinimleri

• Yalnızca loopback’e veya özel güvenilir bir arayüze bağlansın.
• Erişimi yalnızca OpenClaw süreci, ana makinesi, container’ı veya hizmet hesabı kullanabilecek şekilde kısıtlasın.
• Hedefleri kendisi çözümlesin ve DNS çözümlemesinden sonra hedef IP’leri engellesin.
• Hem düz HTTP istekleri hem de HTTPS CONNECT tünelleri için bağlantı zamanında ilke uygulasın.
• Loopback, özel, link-local, metadata, multicast, ayrılmış veya dokümantasyon aralıkları için hedef tabanlı baypasları reddetsin.
• DNS çözümleme yoluna tamamen güvenmediğiniz sürece ana makine adı izin listelerinden kaçının.
• İstek gövdelerini, authorization başlıklarını, çerezleri veya diğer gizli bilgileri günlüğe kaydetmeden hedefi, kararı, durumu ve nedeni günlüğe kaydedin.
• Proxy ilkesini sürüm denetimi altında tutun ve değişiklikleri güvenlik açısından hassas yapılandırma gibi inceleyin.

​

Önerilen engellenen hedefler

​

Doğrulama

openclaw proxy validate --proxy-url http://127.0.0.1:3128

{
  "ok": true,
  "config": {
    "enabled": true,
    "proxyUrl": "http://127.0.0.1:3128/",
    "source": "override",
    "errors": []
  },
  "checks": [
    {
      "kind": "allowed",
      "url": "https://example.com/",
      "ok": true,
      "status": 200
    },
    {
      "kind": "apns",
      "url": "https://api.sandbox.push.apple.com",
      "ok": true,
      "status": 403
    }
  ]
}

curl -x http://127.0.0.1:3128 https://example.com/
curl -x http://127.0.0.1:3128 http://127.0.0.1/
curl -x http://127.0.0.1:3128 http://169.254.169.254/

openclaw config set proxy.enabled true
openclaw config set proxy.proxyUrl http://127.0.0.1:3128
openclaw gateway run

proxy:
  enabled: true
  proxyUrl: http://127.0.0.1:3128

​

Sınırlar

• Proxy, süreç içi JavaScript HTTP ve WebSocket istemcileri için kapsamı iyileştirir, ancak OS düzeyinde bir ağ sandbox’ı değildir.
• Gateway loopback denetim düzlemi trafiği varsayılan olarak proxy.loopbackMode: "gateway-only" üzerinden doğrudan yerel baypasa gider. OpenClaw bu baypası, yönetilen global-agent NO_PROXY denetleyicisine etkin Gateway loopback yetkilisini kaydederek uygular. Operatörler Gateway loopback trafiğini yönetilen proxy üzerinden göndermek için proxy.loopbackMode: "proxy" ayarlayabilir veya loopback Gateway bağlantılarını reddetmek için proxy.loopbackMode: "block" ayarlayabilir. Uzak proxy uyarısı için Gateway Loopback Modu bölümüne bakın.
• Ham net, tls ve http2 soketleri, yerel eklentiler ve OpenClaw dışı alt süreçler, proxy ortam değişkenlerini devralıp bunlara uymadıkları sürece Node düzeyindeki proxy yönlendirmesini baypas edebilir. Fork edilen OpenClaw alt CLI’ları yönetilen proxy URL’sini ve proxy.loopbackMode durumunu devralır.
• IRC, operatör tarafından yönetilen ileri proxy yönlendirmesinin dışında kalan ham bir TCP/TLS kanalıdır. Tüm çıkışın bu ileri proxy üzerinden geçmesini gerektiren dağıtımlarda, doğrudan IRC çıkışı açıkça onaylanmadıkça channels.irc.enabled=false ayarlayın.
• Yerel debug proxy tanılama aracıdır ve proxy istekleri ile CONNECT tünelleri için doğrudan yukarı akış iletimi, yönetilen proxy modu etkinken varsayılan olarak devre dışıdır; doğrudan iletimi yalnızca onaylanmış yerel tanılamalar için etkinleştirin.
• Kullanıcının yerel WebUI’ları ve yerel model sunucuları gerektiğinde operatör proxy politikasında izin listesine alınmalıdır; OpenClaw bunlar için genel bir yerel ağ baypası sunmaz.
• Gateway denetim düzlemi proxy baypası bilerek localhost ve düz loopback IP URL’leriyle sınırlıdır. Yerel doğrudan Gateway denetim düzlemi bağlantıları için ws://127.0.0.1:18789, ws://[::1]:18789 veya ws://localhost:18789 kullanın; diğer ana makine adları sıradan ana makine adına dayalı trafik gibi yönlendirilir.
• OpenClaw proxy politikanızı incelemez, test etmez veya sertifikalandırmaz.
• Proxy politikası değişikliklerini güvenlik açısından hassas operasyonel değişiklikler olarak ele alın.