- डिफ़ॉल्ट:
http://<host>:18789/ gateway.tls.enabled: trueके साथ:https://<host>:18789/- वैकल्पिक प्रीफ़िक्स:
gateway.controlUi.basePathसेट करें (उदा./openclaw)
Webhooks
जबhooks.enabled=true हो, Gateway उसी HTTP सर्वर पर एक छोटा Webhook एंडपॉइंट भी एक्सपोज़ करता है।
auth + payloads के लिए Gateway कॉन्फ़िगरेशन → hooks देखें।
एडमिन HTTP RPC
एडमिन HTTP RPC, चुनी गई Gateway कंट्रोल-प्लेन विधियों कोPOST /api/v1/admin/rpc पर एक्सपोज़ करता है।
यह डिफ़ॉल्ट रूप से बंद होता है और केवल तब रजिस्टर होता है जब admin-http-rpc plugin सक्षम हो।
auth मॉडल, अनुमत विधियों, और WebSocket तुलना के लिए एडमिन HTTP RPC देखें।
कॉन्फ़िग (डिफ़ॉल्ट रूप से चालू)
एसेट मौजूद होने पर (dist/control-ui) नियंत्रण UI डिफ़ॉल्ट रूप से सक्षम होता है।
आप इसे कॉन्फ़िग के ज़रिए नियंत्रित कर सकते हैं:
Tailscale एक्सेस
इंटीग्रेटेड Serve (अनुशंसित)
Gateway को loopback पर रखें और Tailscale Serve को उसे प्रॉक्सी करने दें:https://<magicdns>/(या आपका कॉन्फ़िगर किया गयाgateway.controlUi.basePath)
Tailnet बाइंड + टोकन
http://<tailscale-ip>:18789/(या आपका कॉन्फ़िगर किया गयाgateway.controlUi.basePath)
सार्वजनिक इंटरनेट (Funnel)
सुरक्षा नोट्स
- Gateway auth डिफ़ॉल्ट रूप से आवश्यक है (टोकन, पासवर्ड, trusted-proxy, या सक्षम होने पर Tailscale Serve पहचान हेडर).
- गैर-loopback बाइंड में अभी भी gateway auth आवश्यक है। व्यवहार में इसका मतलब टोकन/पासवर्ड auth या
gateway.auth.mode: "trusted-proxy"के साथ पहचान-सचेत रिवर्स प्रॉक्सी है। - विज़ार्ड डिफ़ॉल्ट रूप से shared-secret auth बनाता है और आम तौर पर एक gateway टोकन जनरेट करता है (loopback पर भी).
- shared-secret मोड में, UI
connect.params.auth.tokenयाconnect.params.auth.passwordभेजता है। - जब
gateway.tls.enabled: trueहो, तो स्थानीय डैशबोर्ड और स्थिति हेल्परhttps://डैशबोर्ड URL औरwss://WebSocket URL रेंडर करते हैं। - Tailscale Serve या
trusted-proxyजैसे पहचान-युक्त मोड में, WebSocket auth जांच इसके बजाय अनुरोध हेडर से पूरी होती है। - सार्वजनिक गैर-loopback नियंत्रण UI डिप्लॉयमेंट के लिए,
gateway.controlUi.allowedOriginsस्पष्ट रूप से सेट करें (पूर्ण origins)। loopback, RFC1918/link-local,.local,.ts.net, और Tailscale CGNAT होस्ट के लिए निजी same-origin LAN/Tailnet लोड स्वीकार किए जाते हैं। gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true, Host-header origin fallback मोड सक्षम करता है, लेकिन यह एक खतरनाक सुरक्षा डाउनग्रेड है।- Serve के साथ, जब
gateway.auth.allowTailscaletrueहो, तो Tailscale पहचान हेडर नियंत्रण UI/WebSocket auth पूरा कर सकते हैं (टोकन/पासवर्ड आवश्यक नहीं). HTTP API एंडपॉइंट उन Tailscale पहचान हेडर का उपयोग नहीं करते; वे इसके बजाय gateway के सामान्य HTTP auth मोड का पालन करते हैं। स्पष्ट credentials आवश्यक करने के लिएgateway.auth.allowTailscale: falseसेट करें। Tailscale और सुरक्षा देखें। यह टोकन-रहित प्रवाह मानता है कि gateway होस्ट भरोसेमंद है। gateway.tailscale.mode: "funnel"के लिएgateway.auth.mode: "password"(shared password) आवश्यक है।
UI बनाना
Gatewaydist/control-ui से static फ़ाइलें सर्व करता है। उन्हें इससे बिल्ड करें: