HarnessRouter को self-host कैसे करें: पूरी गाइड

HarnessRouter क्या हटाता है

आप अपने स्वामित्व वाले सर्वर पर कई agent harnesses के सामने एक API रखने के लिए HarnessRouter Community Edition को self-host करते हैं। एक agent harness वह command line प्रोग्राम है जो एक model को loop में चलाता है: यह एक session बनाए रखता है, files edit करता है, commands चलाता है, और काम के लिए अनुरोध करने वाले को progress stream करता है। Codex, Claude Code और Hermes प्रत्येक यह काम करते हैं, और प्रत्येक अपने स्वयं के install, अपने credential format और session क्या है, इस बारे में अपनी समझ के साथ आता है। HarnessRouter उन सभी को एक container के अंदर चलाता है और सामने एक single HTTP endpoint, एक single login और एक single secret store रखता है।

यही पूरा विचार है, और इसकी लागत को स्पष्ट रूप से बताना उचित है। आप अपने सर्वर में एक container, एक login, एक volume और एक upgrade path जोड़ रहे हैं ताकि कई गतिशील हिस्से एक बन सकें। यदि आप आज केवल एक ही harness चलाते हैं, तो यह उस harness को सीधे install करने की तुलना में खराब setup है। वह trade-off इस अनुभाग का अंतिम हिस्सा है, इसलिए deploy करने से पहले उसे पढ़ें।

नीचे दी गई हर चीज़ को image tag 0.5.5 के विरुद्ध जाँचा गया था, जिसे 19 August 2026 को pull किया गया था। यह project लगभग हर दिन नए tags publish करता है, इसलिए एक महीने बाद इस page पर भरोसा करने के बजाय उस tag की जाँच करें जिसे आप वास्तव में चला रहे हैं। ये commands github.com/HarnessRouter/harnessrouter पर project README से ली गई हैं।

Unified Harness Protocol वास्तव में क्या है

HarnessRouter, Unified Harness Protocol (UHP) को लागू करता है, जो unifiedharnessprotocol.org पर प्रकाशित है। UHP यह बताता है कि कोई product किसी harness पर task कैसे शुरू करता है, चलते हुए task को कैसे ट्रैक करता है, sessions और files को कैसे manage करता है, और विफलता की रिपोर्ट कैसे देता है। इस spec का versioning तारीख के आधार पर होता है। 19 August 2026 तक जो version live है, वह 2026-08-11 दिनांकित है, और साइट इसे एक draft standard कहती है, जो "बनाने के लिए पर्याप्त स्थिर है, और versioned है ताकि इसे सुरक्षित रूप से बदला जा सके"।

यहाँ "open standard" वाक्यांश को ध्यान से पढ़ें। वही कंपनी specification, reference implementation और 52-check conformance suite लिखती है जो यह तय करता है कि कौन इसका पालन करता है। इतने नए protocol के लिए यह सामान्य है, और Apache-2.0 licence का मतलब है कि आप इसके किसी भी हिस्से को fork कर सकते हैं। इसका यह भी अर्थ है कि UHP अभी तक multi-vendor standard नहीं है। इसे एक उभरते हुए protocol के रूप में देखें: उपयोगी, गतिशील, और ऐसी चीज़ जिसे आपके अपने code को बिना rewrite किए उपयोग करना बंद करने में सक्षम होना चाहिए।

शुरू करने से पहले आपकी आवश्यकताएं

Docker और लगभग 4 GB खाली डिस्क स्पेस। आपको एक ऐसे मॉडल प्रदाता से API key की भी आवश्यकता होगी जिसके लिए आप पहले से भुगतान करते हैं। इमेज का आकार लगभग 700 MB है, और शेष डिस्क स्पेस का उपयोग agent CLIs और उनके द्वारा लिखे जाने वाले workspaces के लिए किया जाता है। इमेज में कोई मॉडल बंडल नहीं है और न ही कोई ट्रायल की (trial key) शामिल है, इसलिए जब तक आप किसी प्रदाता को कनेक्ट नहीं करते, तब तक कार्य (tasks) विफल हो जाएंगे। HarnessRouter स्वयं Apache-2.0 लाइसेंस के अंतर्गत है। agent CLIs इस लाइसेंस के अंतर्गत नहीं आते हैं, इसीलिए उन्हें इमेज में शामिल करने के बजाय पहली बार शुरू करने पर डाउनलोड किया जाता है।

एक docker run के साथ HarnessRouter को self-host करें

docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  harnessrouter/harnessrouter

इसके बाद container के start होने की प्रतीक्षा करें। पहली बार start होने में समय लगता है, और logs में इसका कारण बताया जाता है।

docker logs -f harnessrouter

काम करते समय आपको इस तरह की lines दिखाई देंगी:

installing Claude Code (Anthropic's terms apply)…
installing Codex (Apache-2.0)…
installing Hermes (check its upstream license before use)…

ready on :3000 की प्रतीक्षा करें। यह install प्रक्रिया प्रति volume केवल एक बार होती है, इसलिए बाद के हर start में केवल कुछ seconds लगते हैं और कोई install line print नहीं होती।

उस download से दो तथ्य सामने आते हैं, और VPS पर दोनों ही महत्वपूर्ण हैं। पहला, पहली बार boot करने के लिए outbound network access की आवश्यकता होती है। यह image पूरी तरह से self-contained नहीं है, इसलिए egress filter के पीछे या बिना route वाला server यहाँ अटक जाता है और कभी भी ready on :3000 print नहीं करता। यह पहली बार start होने पर ही fail हो जाता है, न कि docker pull पर, जो कि पता लगाने के लिए एक भ्रमित करने वाली जगह है। दूसरा, आप तीसरे पक्ष (third-party) के software को उनकी शर्तों के तहत install कर रहे हैं। Claude Code, Anthropic की शर्तों के तहत आता है और Hermes अपने upstream द्वारा निर्धारित शर्तों के तहत, इसलिए व्यावसायिक रूप से उपयोग करने से पहले दोनों की जाँच कर लें।

-v harnessrouter:/data एक named Docker volume बनाता है। सभी स्थायी डेटा /data में रहता है: SQLite databases, stored files, secret store और agent workspaces। उस volume को delete करने का अर्थ है आपने instance को delete कर दिया है, जिसमें provider keys और सभी transcripts शामिल हैं। container को stop करने के बाद ही इसका backup लें, क्योंकि लिखते समय SQLite database को copy करने से ऐसी file मिल सकती है जो open न हो। यही stop-then-copy का नियम server पर मौजूद हर stateful container पर लागू होता है, हालाँकि विवरण service के अनुसार अलग-अलग हो सकते हैं, क्योंकि PhotoPrism और Immich में से प्रत्येक को अपने स्वयं के backup commands की आवश्यकता होती है।

docker stop harnessrouter
docker run --rm -v harnessrouter:/data -v "$PWD":/backup alpine \
  tar czf /backup/harnessrouter-data.tgz -C / data
docker start harnessrouter

Compose variant और वह लाइन जिसे आपको बदलना होगा

Repository में एक compose file शामिल है। यह "3000:3000" को publish करती है, जिसका अर्थ है host के सभी interfaces। इसे public server पर चलाने से पहले उस लाइन को बदलें।

services:
  harnessrouter:
    image: harnessrouter/harnessrouter:0.5.5
    ports:
      - "127.0.0.1:3000:3000"
    env_file:
      - .env
    volumes:
      - harnessrouter-data:/data
    restart: unless-stopped

volumes:
  harnessrouter-data:

Upstream से दो चीजें अलग हैं: bind address, और latest के बजाय एक pinned version tag। Version को pin करना महत्वपूर्ण है क्योंकि 9 और 18 August 2026 के बीच सोलह version tags जारी किए गए थे, और यदि agent runtime आपके नियंत्रण के बिना बदलता है तो उसे debug करना कठिन होता है। इसके बाद environment file को copy करें, उसकी permissions को lock करें, और start करें।

cp .env.example .env
chmod 600 .env
docker compose up -d
docker compose logs -f

.env में आपकी provider key plain text में होती है, इसलिए mode 600 न्यूनतम आवश्यकता है। यदि आप docker compose subcommand से परिचित नहीं हैं, तो Docker Compose command cheat sheet में दैनिक उपयोग होने वाली commands की जानकारी दी गई है।

पोर्ट 127.0.0.1 पर पब्लिश क्यों किया जाता है, 0.0.0.0 पर क्यों नहीं

-p 3000:3000 पोर्ट को होस्ट के हर उपलब्ध इंटरफ़ेस पर पब्लिश करता है। -p 127.0.0.1:3000:3000 इसे केवल लूपबैक पर पब्लिश करता है, जिसका अर्थ है कि इसे केवल VPS के भीतर से ही एक्सेस किया जा सकता है। कंटेनर हमेशा अंदर 3000 पोर्ट पर लिसन करता है, इसलिए बाईं ओर का हिस्सा वह है जिसे आप बदलते हैं। जाँचें कि आपके पास क्या है:

docker port harnessrouter
sudo ss -ltnp | grep 3000

ss यह प्रिंट करना कि 127.0.0.1:3000 सही है। 0.0.0.0:3000 का अर्थ है कि कंसोल पब्लिक इंटरनेट पर है। अधिकांश self-hosted ऐप्स की तुलना में यह यहाँ अधिक खतरनाक है, क्योंकि कंसोल हार्नेस बनाता है, हर ट्रांसक्रिप्ट को पढ़ता है, एजेंट चलाता है, और उन एजेंटों को उनके वर्कस्पेस में एक शेल और वास्तविक फाइलसिस्टम देता है। इसमें वह प्रोवाइडर की (provider key) भी होती है जिसे आपने कनेक्ट किया है। कोई भी व्यक्ति जो असुरक्षित कंसोल तक पहुँचता है, वह आपके काम को पढ़ सकता है, कमांड चला सकता है और आपकी की (key) का उपयोग कर सकता है।

होस्ट फायरवॉल आपको इससे नहीं बचाता है। Docker अपने स्वयं के नियमों को सीधे कर्नेल nat टेबल में लिखकर पोर्ट पब्लिश करता है, और इनका मूल्यांकन उस चेन से पहले किया जाता है जिसे ufw मैनेज करता है, इसलिए पब्लिश किया गया पोर्ट तब भी एक्सेसिबल रहता है जब sudo ufw status इसे डिनाइड (denied) दिखाता है। किसी दूसरी मशीन से टेस्ट करें, VPS से नहीं, अन्यथा आप कुछ भी टेस्ट नहीं कर पाएंगे। यह running dsh headless on port 3080 जैसा ही सबक है: सर्विस को लूपबैक पर बाइंड करें, फिर सोच-समझकर निर्णय लें कि आप इसे कैसे एक्सेस करेंगे।

किसी भी अन्य कार्य से पहले डिफ़ॉल्ट लॉगिन बदलें

http://localhost:3000 पर username harnessrouter और password harnessrouter के साथ साइन इन करें। ये क्रेडेंशियल्स README में दिए गए हैं क्योंकि ये केवल प्लेसहोल्डर हैं, गुप्त नहीं। जब तक आप इन्हें बदलते नहीं हैं, कंटेनर हर बार स्टार्ट होने पर आपको चेतावनी देता है:

using the DEFAULT password. Set HR_AUTH_PASSWORD, or change it from the profile page, before exposing this instance.

इसे Profile पेज से बदलें, या स्क्रिप्टेड डिप्लॉयमेंट के लिए स्टार्ट-अप के समय सेट करें। HR_AUTH_USER और HR_AUTH_PASSWORD डिफ़ॉल्ट मानों को ओवरराइड कर देते हैं।

docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  -e HR_AUTH_USER='you' \
  -e HR_AUTH_PASSWORD='the-password-you-chose' \
  harnessrouter/harnessrouter

इसमें पासवर्ड रीसेट करने के लिए ईमेल की सुविधा नहीं है, क्योंकि इसमें कोई अकाउंट सिस्टम या मेल सर्वर नहीं है। यदि आप पासवर्ड भूल जाते हैं, तो वॉल्यूम में मौजूद auth फ़ाइल को डिलीट करें और रीस्टार्ट करें, फिर डिफ़ॉल्ट क्रेडेंशियल्स के साथ दोबारा साइन इन करें।

docker stop harnessrouter
docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json
docker start harnessrouter

HR_AUTH_DISABLED=1 साइन-इन गेट को पूरी तरह से हटा देता है। README में इसे "ऐसे बॉक्स तक सीमित" बताया गया है जिसे कोई और एक्सेस न कर सके। पब्लिक IP एड्रेस वाला VPS ऐसा बॉक्स नहीं होता है, इसलिए जब तक आप इसे लैपटॉप पर नहीं चला रहे हैं, तब तक साइन-इन गेट को चालू रखें।

अपने version की जाँच करें, क्योंकि पुराने versions में कोई gate नहीं है

यह वह हिस्सा है जिसे गंभीरता से लेना चाहिए। 0.1.x और 0.2.0 versions बिना किसी authentication gate के release किए गए थे: जो कोई भी port 3000 तक पहुँच सकता था, वह सीधे console के अंदर होता था। 0.3.0 पहला ऐसा release था जिसमें login की सुविधा दी गई थी। वे पुराने tags अभी भी प्रकाशित हैं और उन्हें pull किया जा सकता है, इसलिए कोई पुराना pinned tag, या किसी सहकर्मी से copy की गई compose file, आज भी एक असुरक्षित console को public port पर डाल सकती है।

19 August 2026 तक, सबसे नया प्रकाशित tag 0.5.5 है, जो 18 August 2026 का है, और latest इसी की ओर इशारा करता है। जाँचें कि आपके पास कौन सा version है, और फिर उसकी तुलना Docker Hub पर मौजूद tag list से करें:

docker image ls harnessrouter/harnessrouter

0.3.0 से नीचे के किसी भी version को तुरंत बदला जाना चाहिए, इसे भविष्य के लिए न टालें। 0.3.0 या उससे ऊपर के versions में भी password बदलना आवश्यक है, क्योंकि port 3000 को scan करने वाले व्यक्ति के लिए default password और बिना password का होना एक समान है। इस पृष्ठ पर दिए गए version numbers को वर्तमान न मानें। वे ऊपर दी गई तारीख पर सही थे, और यह project बहुत तेजी से update होता है।

प्रदाता (provider) को कनेक्ट करें

जब तक कोई मॉडल प्रदाता कनेक्ट नहीं होता, तब तक कुछ भी नहीं चलता। इसे कंसोल में Integrations पेज से जोड़ें, या environment में docker run के माध्यम से पास करें। इसका मान JSON है, इसलिए shell में इसे quotes में रखें:

-e HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC='{"name":"anthropic","provider":"anthropic","api_key":"sk-ant-…"}'

.env.example प्रत्येक प्रदाता परिवार के लिए एक कनेक्शन वेरिएबल का नाम बताता है: claude-code बैकएंड के लिए HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC, codex बैकएंड के लिए HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI, और किसी भी OpenAI-compatible एंडपॉइंट के लिए HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM, जहाँ एक एग्रीगेटर या आपका अपना इन्फरेंस सर्वर काम करता है। संबंधित HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE, HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX और HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES वेरिएबल यह बताते हैं कि कौन सा बैकएंड डिफ़ॉल्ट रूप से किस कनेक्शन का उपयोग करता है। HR_SECRET_KEY एक अलग चीज़ है, और इसकी आवश्यकता केवल तब होती है जब आप किसी एजेंट से डेटाबेस कनेक्ट करते हैं।

HR_BACKENDS यह चुनता है कि कौन से बैकएंड लोड होंगे, जैसा कि HR_BACKENDS=claude,codex,hermes में है। एक ज्ञात समस्या के बारे में जानना महत्वपूर्ण है इससे पहले कि यह आपको प्रभावित करे: कोई भी मान जिसमें hermes शामिल नहीं है, वह कंटेनर को तुरंत status 1 के साथ बंद कर देता है और कोई त्रुटि संदेश नहीं देता है। आप शुरू करने के एक सेकंड बाद docker ps -a में Exited (1) देखते हैं, और docker logs कुछ भी उपयोगी नहीं दिखाता है। जब तक upstream इसे ठीक नहीं करता, तब तक hermes को सूची में रखें। यदि आप केवल Hermes harness चाहते हैं, तो Hermes एजेंट को अपने स्वयं के VPS पर चलाना एक छोटा डिप्लॉयमेंट है।

कंसोल के बिना API को कॉल करें

कंसोल वैकल्पिक है। एक ही API दोनों के लिए काम करता है और यह Responses-style कॉन्ट्रैक्ट का पालन करता है। सेशन कुकी प्राप्त करने के लिए पहले साइन इन करें:

curl -c hr.cookies http://localhost:3000/api/selfhost/login \
  -H 'content-type: application/json' \
  -d '{"username":"harnessrouter","password":"your-password"}'

फिर एक टास्क भेजें, जिसमें metadata.harness_id में हार्नेस का नाम और वह मॉडल बताएं जिसे आपका कनेक्टेड प्रोवाइडर वास्तव में सर्व करता है:

curl -s -b hr.cookies http://localhost:3000/api/harness/v1/responses \
  -H 'content-type: application/json' \
  -d '{"input":"Reply with exactly this and nothing else: it works.",
       "metadata":{"harness_id":"codex"},
       "model":"gpt-5.4-mini",
       "stream":false}'

आउटपुट ब्लॉक और टोकन काउंट वाला JSON ऑब्जेक्ट यह दर्शाता है कि हार्नेस चल गया है। harness_id को codex से बदलकर claude करने पर वही रिक्वेस्ट एक अलग हार्नेस पर चली जाती है, और यही बदलाव इस सॉफ्टवेयर के अस्तित्व का मुख्य कारण है। ऊपर दिया गया कस्टम कनेक्शन वह तरीका है जिससे आप हार्नेस को अपने द्वारा होस्ट किए गए OpenAI-compatible एंडपॉइंट की ओर निर्देशित करते हैं, ठीक वैसे ही जैसे VPS पर सेल्फ-होस्टेड DeepSeek हार्नेस को कनेक्ट किया जाता है।

इसे किसी पोर्ट को पब्लिश किए बिना अपने लैपटॉप से एक्सेस करें

इसके दो तरीके हैं, और इनमें से कोई भी 0.0.0.0 पर रॉ पोर्ट का उपयोग नहीं करता है।

एक SSH tunnel सबसे सस्ता तरीका है, और इसके लिए सर्वर पर कुछ भी इंस्टॉल करने की आवश्यकता नहीं है। यह आपकी मशीन के एक लोकल पोर्ट को VPS के लूपबैक पर फॉरवर्ड कर देता है।

ssh -N -L 3000:127.0.0.1:3000 you@your-vps

इसे चलते रहने दें और अपने ब्राउज़र में http://localhost:3000 खोलें। यदि SSH bind: Address already in use प्रिंट करता है, तो इसका मतलब है कि आपके लैपटॉप पर कोई अन्य सर्विस पहले से ही पोर्ट 3000 का उपयोग कर रही है, इसलिए -L 3100:127.0.0.1:3000 के साथ कोई अन्य लोकल पोर्ट चुनें और पोर्ट 3100 पर ब्राउज़ करें।

एक टर्मिनेटिंग रिवर्स प्रॉक्सी तब सबसे अच्छा विकल्प है जब अन्य लोगों को भी एक्सेस की आवश्यकता हो। प्रॉक्सी TLS (ट्रांसपोर्ट लेयर सिक्योरिटी) सर्टिफिकेट को संभालती है और लूपबैक पर ट्रैफिक फॉरवर्ड करती है। README में Caddy का कॉन्फ़िगरेशन दिया गया है:

console.example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:3000 {
        flush_interval -1      # agent turns stream for minutes; never buffer them
    }
}

flush_interval -1 वह लाइन है जिसे लोग अक्सर भूल जाते हैं। एजेंट कई मिनटों तक स्ट्रीम टोकन भेजता है, और यदि प्रॉक्सी रिस्पॉन्स को बफर करती है, तो वह टर्न समाप्त होने तक उन टोकन को रोक कर रखती है। इस कारण कंसोल जमा हुआ (frozen) दिखता है और फिर एक साथ सब कुछ प्रिंट कर देता है। Nginx में इसके समान कॉन्फ़िगरेशन लोकेशन ब्लॉक के अंदर proxy_buffering off; है। आप जो भी चुनें, DNS नाम को प्रॉक्सी पर पॉइंट रखें और कंटेनर को लूपबैक पर रखें। रिवर्स प्रॉक्सी के रूप में Nginx, Caddy और Traefik की तुलना में बताया गया है कि आपके सर्वर के लिए कौन सा बेहतर है।

इसे root के बजाय अपने स्वयं के user के रूप में चलाएं

Docker daemon, root के रूप में चलता है और docker group की सदस्यता root के बराबर होती है, क्योंकि इसका सदस्य ऐसा container शुरू कर सकता है जो host filesystem को mount करता है। इसलिए "team को docker group में जोड़ना" उस box पर root access देने जैसा है जिसमें आपकी provider key मौजूद है।

सरल तरीका: एक service account बनाएं जो compose file और .env का स्वामी हो, और इन files को किसी भी shared home directory से बाहर रखें।

sudo adduser --disabled-password --gecos "" harness
sudo install -d -o harness -g harness -m 750 /srv/harnessrouter

अधिक मजबूत तरीका rootless Docker है, जहाँ daemon स्वयं उस unprivileged user के रूप में चलता है। इसके लिए newuidmap और newgidmap हेतु uidmap package की आवश्यकता होती है, और user के लिए /etc/subuid तथा /etc/subgid में कम से कम 65536 subordinate UIDs की आवश्यकता होती है।

sudo apt install -y uidmap docker-ce-rootless-extras
sudo loginctl enable-linger harness
sudo -iu harness
dockerd-rootless-setuptool.sh install
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
systemctl --user enable --now docker

यहाँ loginctl enable-linger वैकल्पिक नहीं है। इसके बिना, अंतिम session बंद होते ही user का systemd instance रुक जाता है, जिससे आपके log out होते ही container बंद हो जाता है। परिणाम की पुष्टि docker info के साथ करें, जो Security Options के अंतर्गत rootless को सूचीबद्ध करता है। Rootless mode अतिरिक्त configuration के बिना 1024 से नीचे के ports को bind नहीं कर सकता है, जो यहाँ मायने नहीं रखता क्योंकि port 3000 उस सीमा से ऊपर है। Account सेटअप करने की प्रक्रिया VPS पर न्यूनतम-विशेषाधिकार वाले users बनाना में दी गई है।

क्या खराब होता है, और आप क्या देखेंगे

कंटेनर शुरू होने के एक सेकंड बाद ही बंद हो जाता है और लॉग खाली हैं। docker ps -a में Exited (1) दिखाई देता है। यह ऊपर बताया गया HR_BACKENDS मुद्दा है: आपके मान में hermes छूट गया है। इसे वापस डालें।

पहली बार शुरू होने की प्रक्रिया कभी पूरी नहीं होती। लॉग एक installing लाइन के बाद रुक जाता है और ready on :3000 कभी दिखाई नहीं देता। बॉक्स एजेंट CLI को लाने के लिए नेटवर्क तक नहीं पहुँच पा रहा है, क्योंकि वे इमेज में मौजूद नहीं हैं। आउटबाउंड रूट या प्रॉक्सी सेटिंग्स को ठीक करें, फिर रीस्टार्ट करें।

कंसोल लोड होता है और हर टास्क विफल हो जाता है। कोई प्रदाता (provider) कनेक्ट नहीं है। इमेज के अंदर कोई बंडल मॉडल या फ्री टियर नहीं है, इसलिए एक नया इंस्टेंस आपको साइन इन तो करा सकता है लेकिन कुछ भी चला नहीं सकता।

प्रॉक्सी के पीछे कंसोल उत्तर देते समय फ्रीज हो जाता है। आउटपुट टर्न समाप्त होने पर एक ब्लॉक में दिखाई देता है। यह रिस्पॉन्स बफरिंग है। Caddy में flush_interval -1 सेट करें, या Nginx में proxy_buffering off; सेट करें।

आप अपने लैपटॉप से उस तक नहीं पहुँच पा रहे हैं और टनल चालू है। सर्वर पर docker port harnessrouter चलाएँ। यदि यह कुछ भी प्रिंट नहीं करता है, तो कंटेनर कुछ भी पब्लिश नहीं कर रहा है, इसका मतलब है कि इसे -p के बिना शुरू किया गया था।

क्या इसे चलाना सार्थक है?

यदि आप वास्तव में एक से अधिक harness का उपयोग करते हैं और आप तीन अलग-अलग endpoints और credential stores के बजाय केवल एक ही चाहते हैं, तो इसे चलाना सार्थक है। यदि आप इसके ऊपर कोई product बना रहे हैं और चाहते हैं कि harness एक configuration value हो, न कि rewrite, तो भी यह उपयोगी है। UHP आपको यही सुविधा देता है, बशर्ते आप इस बात का ध्यान रखें कि यह protocol अभी नया है।

यदि आप केवल एक harness का उपयोग करते हैं, तो इसे चलाना सार्थक नहीं है। सर्वर पर उस CLI को install करने में कम components शामिल होते हैं और आपके और उसके बीच कोई login प्रक्रिया नहीं होती। यदि आप एक ही कार्य पर सहयोग करने वाले कई agents चाहते हैं, न कि कई harnesses के सामने एक API, तो भी यह सही विकल्प नहीं है; उस pattern के लिए Omnigent जैसे multi-agent harness देखें। किसी भी स्थिति में deployment के नियम नहीं बदलते हैं। Loopback bind, बदला हुआ password, 0.3.0 या उससे ऊपर का pinned tag और अपना स्वयं का user होना आवश्यक है।

FAQ

क्या HarnessRouter को port 3000 पर publish करना सुरक्षित है?

नहीं। console harnesses बनाता है, हर transcript को पढ़ता है, shell और filesystem access के साथ agents चलाता है, और आपके द्वारा connect की गई provider key को सुरक्षित रखता है। इसलिए, एक open port इन सभी चीजों को उजागर कर देती है। इसे -p 127.0.0.1:3000:3000 के साथ loopback पर publish करें और SSH tunnel या TLS-terminating reverse proxy के माध्यम से access करें। केवल host firewall पर्याप्त नहीं है: Docker अपनी खुद की rules को kernel nat table में लिखता है, इसलिए एक published port internet से जवाब देती है, भले ही ufw उसे denied दिखाए। sudo ss -ltnp | grep 3000 के साथ verify करें, जिसे 127.0.0.1:3000 print करना चाहिए।

HarnessRouter के किस version में login gate जोड़ा गया था?

0.3.0। Version 0.1.x और 0.2.0 बिना किसी authentication के release किए गए थे। दोनों tags अभी भी published हैं और pull किए जा सकते हैं, इसलिए जो कोई भी उन्हें चला रहा है, वह इस भरोसे पर है कि किसी को port का पता नहीं चलेगा। 19 August 2026 तक, सबसे नया tag 0.5.5 है, जो 18 August 2026 का है। यह देखने के लिए कि आपके पास क्या है, docker image ls harnessrouter/harnessrouter चलाएं। इसकी तुलना इस page के बजाय Docker Hub पर मौजूद tag list से करें, और current version पर भी default password बदलें।

HR_BACKENDS set करने के तुरंत बाद container exit क्यों हो जाता है?

कोई भी HR_BACKENDS value जिसमें hermes शामिल नहीं है, वह container को बिना किसी error message के status 1 के साथ तुरंत exit कर देती है। यह project README में एक ज्ञात समस्या है। इसका लक्षण एक या दो सेकंड के भीतर docker ps -a में Exited (1) है, और docker logs में कुछ भी उपयोगी नहीं मिलता है। जब तक upstream इसे ठीक नहीं करता, तब तक HR_BACKENDS=claude,codex,hermes की तरह hermes को list में बनाए रखें।

क्या पहली बार start करते समय HarnessRouter को internet access की आवश्यकता होती है?

हाँ। agent CLIs को image में शामिल करने के बजाय पहली बार start होने पर fetch किया जाता है, क्योंकि प्रत्येक के पास अपना license होता है। बिना outbound route वाला box installing lines print करता है और फिर कभी ready on :3000 तक नहीं पहुँचता। download प्रति volume एक बार होता है, इसलिए बाद के starts में कुछ सेकंड लगते हैं और आपके द्वारा connect किए गए model provider के अलावा किसी network की आवश्यकता नहीं होती।

मैं console password भूल गया हूँ। मैं वापस कैसे access करूँ?

इसमें कोई reset email नहीं है, क्योंकि इसमें कोई account system या mail server नहीं है। container को stop करें, volume से /data/selfhost-auth.json को delete करें, इसे फिर से start करें, फिर default credentials के साथ sign in करें और Profile page से नया password set करें। यदि container और volume दोनों का नाम harnessrouter है, तो यह docker stop harnessrouter, फिर docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json, और फिर docker start harnessrouter होगा।