SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

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

Codex, Claude Code और Hermes को एक API के पीछे चलाने के लिए HarnessRouter का उपयोग करें। Docker deploy, loopback bind, डिफ़ॉल्ट login और TLS सेटअप की पूरी प्रक्रिया यहाँ जानें।

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 की जाँच करें जिसे आप वास्तव में चला रहे हैं। 8 November 2026 को इस page को project के वर्तमान documentation और source के विरुद्ध फिर से जाँचा गया था, जब latest ने 0.38.5 की ओर इशारा किया था, और जिन स्थानों पर वर्तमान releases अलग तरह से व्यवहार करते हैं, वहाँ इसका उल्लेख किया गया है। Commands github.com/HarnessRouter/harnessrouter पर स्थित project repository से ली गई हैं। वे 0.5.5 पर README में थीं; setup का विवरण अब उसी repository में docs/self-hosting-guide.md में मौजूद है।

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

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

यहाँ "open standard" वाक्यांश को ध्यान से पढ़ें। एक ही कंपनी specification, reference implementation और conformance suite लिखती है, जो यह तय करती है कि कौन conform करता है, और प्रोजेक्ट के governance नियम कहते हैं कि कोई भी बदलाव तब तक लागू नहीं होगा जब तक तीनों एक साथ न बदलें। 9 November 2026 तक, प्रोटोकॉल होमपेज उस suite को 110 runnable checks के रूप में वर्णित करता है, जबकि इसका conformance पेज 101 कहता है और self-hosting गाइड का रिकॉर्डेड reference run, जो 4 September 2026 का है, 64 पास करता है, इसलिए प्रकाशित संख्याएँ मेल नहीं खाती हैं। प्रोजेक्ट का changelog छह अतिरिक्त branching checks को 4 November 2026 की तारीख देता है। इतने नए प्रोटोकॉल के लिए यह सामान्य है, और Apache-2.0 licence का मतलब है कि आप इसके किसी भी हिस्से को fork कर सकते हैं। इसका मतलब यह भी है कि UHP अभी तक multi-vendor standard नहीं है। इसे एक उभरते हुए प्रोटोकॉल के रूप में मानें: उपयोगी, गतिशील, और ऐसी चीज़ जिसे आपके अपने कोड को बिना rewrite किए उपयोग करना बंद करने में सक्षम होना चाहिए।

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

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

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 होने में समय लगता है, और 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 की प्रतीक्षा करें। यह मार्गदर्शिका docker run द्वारा prompt वापस देने के समय से लगभग आधे मिनट का समय मानती है, न कि उस line से; यदि http://localhost:3000 ready line के तुरंत बाद जवाब न दे, तो कुछ सेकंड बाद पुनः प्रयास करें। Installed CLIs volume पर cached होते हैं, इसलिए बाद में start होने की प्रक्रिया आमतौर पर बहुत तेज होती है, हालांकि बाद में जोड़ा गया कोई backend, या जो पहले install होने में विफल रहा हो, वह अभी भी install का काम शुरू कर सकता है।

उस download से दो तथ्य सामने आते हैं, और VPS पर दोनों ही महत्वपूर्ण हैं। पहला, पहली बार boot होने के लिए outbound network access की आवश्यकता होती है। यह image पूरी तरह से self-contained नहीं है, इसलिए egress filter के पीछे स्थित box, या जिसमें बाहर जाने का कोई route न हो, वह agent CLIs को fetch नहीं कर सकता। 0.5.5 और वर्तमान releases दोनों ही विफल installs को non-fatal मानते हैं और log में उनके नाम देते हैं, इसलिए देखें कि backends available: line किन backends को छोड़ देती है। दूसरा, आप तीसरे पक्ष के software को उनकी शर्तों के तहत install कर रहे हैं। Claude Code, Anthropic की शर्तों के तहत आता है और Hermes अपने upstream द्वारा निर्धारित शर्तों के तहत, इसलिए व्यावसायिक रूप से उपयोग करने से पहले दोनों की जाँच करें।

-v harnessrouter:/data एक named Docker volume बनाता है। सब कुछ जो स्थायी है, वह /data में रहता है: SQLite databases, संग्रहीत files, secret store और agent workspaces। उस volume को delete करने का अर्थ है कि आपने instance को delete कर दिया है, जिसमें provider keys और हर transcript शामिल है। container को stop करने के बाद इसका backup लें, क्योंकि लिखते समय SQLite database को copy करने से ऐसी file मिल सकती है जो शायद न खुले। यही stop-then-copy का नियम box पर मौजूद हर stateful container पर लागू होता है, हालांकि विवरण सेवा के अनुसार अलग-अलग होते हैं, क्योंकि 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 प्रदान करती है। यह अब "127.0.0.1:3000:3000" प्रकाशित करती है, जो host port को loopback से bind करती है। 0.5.5 फाइल ने "3000:3000" प्रकाशित किया था; यदि आप 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 से एक चीज़ अलग है: latest के बजाय एक pinned version tag। Pinning महत्वपूर्ण है क्योंकि releases तेज़ी से बदलते हैं: Docker Hub ने 8 November 2026 को चेक करने पर पिछले एक दिन के भीतर 0.38.4 और 0.38.5 दोनों को push किया हुआ दिखाया था। एक agent runtime जो आपके उपयोग के दौरान बदल जाए, उसे debug करना कठिन होता है। इस पेज से 0.5.5 कॉपी करने के बजाय वर्तमान release को pin करें; 9 November 2026 को यह 0.40.0 था। फिर environment file को कॉपी करें, उसकी 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 दैनिक उपयोग होने वाले verbs को कवर करती है।

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

-p 3000:3000 डिफ़ॉल्ट रूप से होस्ट के हर इंटरफ़ेस पर पोर्ट पब्लिश करता है। -p 127.0.0.1:3000:3000 होस्ट पोर्ट को लूपबैक पर पब्लिश करता है। 28.0.0 से पुराने Docker रिलीज़ में एक ही L2 सेगमेंट पर मौजूद होस्ट, localhost पर पब्लिश किए गए पोर्ट्स तक पहुँच सकते हैं, और स्पष्ट रूप से सक्षम की गई डायरेक्ट राउटिंग लूपबैक होस्ट मैपिंग के बावजूद कंटेनर पोर्ट को एक्सपोज़ कर सकती है। कंटेनर अंदर से डिफ़ॉल्ट रूप से 3000 पर लिसन करता है, जिसे PORT के माध्यम से कॉन्फ़िगर किया जा सकता है, इसलिए होस्ट पोर्ट के टकराव से बचने के लिए बाईं ओर की पोर्ट संख्या बदलें। जाँचें कि आपको क्या मिला है:

docker port harnessrouter
sudo ss -ltnp | grep 3000

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

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

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

http://localhost:3000 पर username harnessrouter और आपके instance द्वारा जनरेट किए गए प्रारंभिक पासवर्ड के साथ साइन इन करें। इसे इस कमांड से पढ़ें:

docker exec harnessrouter cat /data/selfhost-initial-password

साझा पासवर्ड harnessrouter, 0.5.5 में काम करता था; वर्तमान इंस्टॉलेशन उस प्रकाशित डिफ़ॉल्ट पासवर्ड को स्वीकार नहीं करते हैं।

इसे Profile पेज से बदलें, या स्क्रिप्टेड डिप्लॉयमेंट के लिए इसे स्टार्ट टाइम पर सेट करें। HR_AUTH_USER और HR_AUTH_PASSWORD प्रारंभिक क्रेडेंशियल्स प्रदान करते हैं; Profile से सेव किए गए क्रेडेंशियल्स को प्राथमिकता दी जाती है।

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

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

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

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

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

यह वह हिस्सा है जिसे गंभीरता से लेना चाहिए। 0.1.x और 0.2.0 versions बिना किसी authentication gate के release किए गए थे: जो कोई भी port 3000 तक पहुँच सकता था, वह सीधे console के अंदर होता था। 0.3.0 login सुविधा वाला पहला release था। इस पृष्ठ पर उन पुराने tags को आखिरी बार 12 October 2026 को प्रकाशित और pullable के रूप में दर्ज किया गया था; 8 November 2026 को उनकी वर्तमान उपलब्धता की पुष्टि नहीं की गई थी।

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

docker image ls harnessrouter/harnessrouter

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

Provider को कनेक्ट करें

जब तक model provider कनेक्ट नहीं होता, कुछ भी नहीं चलता। अकाउंट मेनू में Bring your own key से एक जोड़ें, या इसे environment में docker run को पास करें। मान JSON है, इसलिए इसे shell में quote करें:

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

.env.example प्रत्येक provider family के लिए एक connection variable का नाम देता है: claude-code backend के लिए HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC, codex backend के लिए HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI, gemini backend के लिए HR_SECRET_GLOBAL_HARNESS_CONN_GOOGLE, और किसी भी OpenAI-compatible endpoint के लिए HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM, जहाँ aggregator या आपका अपना inference server जाता है। संबंधित HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE, HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX और HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES variables यह बताते हैं कि प्रत्येक backend डिफ़ॉल्ट रूप से किस connection का उपयोग करता है, और प्रति backend एक policy variable है। HR_SECRET_KEY एक अलग चीज़ है। वर्तमान releases इसके तहत stored credentials को encrypt करते हैं, और जब आप कोई key प्रदान नहीं करते हैं तो /data/secret-key में एक key generate करते हैं। restarts और upgrades के दौरान एक ही key रखें; इसे मौजूदा instance के डेटा से अलग रखने के लिए, HR_SECRET_KEY को उस फाइल के मान पर सेट करें और फाइल को delete कर दें।

HR_BACKENDS चुनता है कि कौन से backends install और load होंगे, जैसा कि HR_BACKENDS=claude,codex,hermes में है। यदि unset छोड़ दिया जाए, तो वर्तमान releases 30 backends की एक बहुत लंबी डिफ़ॉल्ट सूची install करते हैं, जिसमें claude, codex और hermes से लेकर opencode, gemini, goose और अन्य शामिल हैं, इसलिए इसे छोटा करने से disk और पहली बार start होने का समय बचता है। वर्तमान self-hosting गाइड कहती है कि "यदि आप इसका उपयोग नहीं करेंगे तो HR_BACKENDS से उनमें से किसी को भी छोड़ दें", और इसका अपना lean उदाहरण HR_BACKENDS=opencode है, जो Hermes को पूरी तरह से छोड़ देता है। जो backend install होने में विफल रहता है वह fatal नहीं है: बाकी काम करते रहते हैं, और जिस backend पर install नहीं हुआ उस पर task को "not installed" के रूप में अस्वीकार कर दिया जाता है जबकि container का log उस install का नाम बताता है जो विफल रहा। 0.5.5 README में एक ज्ञात समस्या थी जहाँ hermes को छोड़ने पर container तुरंत status 1 के साथ और बिना किसी error message के exit हो जाता था, लेकिन उस tag का entrypoint पहले ही विफलता को ठीक कर देता है; इसकी टिप्पणियाँ पिछले कार्यान्वयन का वर्णन करती हैं। यदि Hermes ही एकमात्र harness है जिसे आप चाहते हैं, तो Hermes agent को अपने स्वयं के VPS पर चलाना एक छोटा deployment है।

कंसोल के बिना 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-code करने पर वही रिक्वेस्ट एक अलग हार्नेस पर चली जाती है, और यही स्वैप इस सॉफ्टवेयर के अस्तित्व का मुख्य कारण है। ध्यान दें कि id claude-code है, भले ही HR_BACKENDS में बैकएंड का नाम और पॉलिसी वेरिएबल claude हो। ऊपर दिया गया कस्टम कनेक्शन वह तरीका है जिससे आप किसी हार्नेस को अपने द्वारा होस्ट किए गए OpenAI-compatible एंडपॉइंट की ओर निर्देशित करते हैं, ठीक वैसे ही जैसे VPS पर एक self-hosted DeepSeek हार्नेस को सेटअप किया जाता है।

लोकल डिबगिंग के लिए सेशन-कुकी फ्लो अभी भी समर्थित है। प्रोडक्ट बैकएंड के लिए, वर्तमान डॉक्यूमेंटेशन API Keys में एक HarnessRouter API की बनाने और कंसोल सेशन बनाए रखने के बजाय इसे Bearer टोकन के रूप में भेजने की सलाह देता है।

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

इसके दो तरीके हैं, और इनमें से कोई भी 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 (ट्रांसपोर्ट लेयर सिक्योरिटी) सर्टिफिकेट को होल्ड करती है और लूपबैक पर फॉरवर्ड करती है। सेल्फ-होस्टिंग गाइड में 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 स्पष्ट रूप से Caddy की रिस्पॉन्स बफरिंग को डिसेबल करता है; Caddy इसके बिना भी text/event-stream रिस्पॉन्स को तुरंत फ्लश कर देता है। एजेंट कई मिनटों तक स्ट्रीम टोकन भेजता है, और जो प्रॉक्सी रिस्पॉन्स को बफर करती है, वह टर्न समाप्त होने तक उन टोकन को रोक कर रखती है। इससे कंसोल जमा हुआ (frozen) दिखता है और फिर एक साथ सब कुछ प्रिंट कर देता है। Nginx में इसका समकक्ष proxy_buffering off; है, जिसे location ब्लॉक के अंदर रखा जाता है। आप जो भी चुनें, 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 का स्वामी हो, और उन फाइलों को किसी भी shared home directory से बाहर रखें।

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

--user को docker run में या user: को compose file में जोड़कर वहां तक पहुंचने का प्रयास न करें। वर्तमान गाइड कहती है कि container को root के रूप में शुरू होना चाहिए, और 0.8.2 से यह किसी अन्य तरीके से शुरू होने से मना कर देता है, जिसके log में एक पंक्ति यह बताती है।

मजबूत संस्करण rootless Docker है, जहां daemon स्वयं उस unprivileged user के रूप में चलता है। इसके लिए newuidmap और newgidmap के लिए uidmap package की आवश्यकता होती है, और user के लिए /etc/subuid और /etc/subgid में कम से कम 65536 subordinate UIDs की आवश्यकता होती है। uidmap Ubuntu archive में है, लेकिन docker-ce-rootless-extras नहीं है: यह download.docker.com पर Docker के अपने apt repository से आता है, जिसे Docker engine install जोड़ता है। यदि आपने उस repository से engine install नहीं किया है, तो grep -rl download.docker.com /etc/apt/sources.list.d/ कुछ भी print नहीं करेगा और नीचे दिया गया install package को नहीं ढूंढेगा।

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 logout के बाद user की systemd instance को चालू रखता है और इसे boot पर शुरू करता है। परिणाम की पुष्टि docker info के साथ करें, जो Security Options के अंतर्गत rootless को सूचीबद्ध करता है। Rootless mode अतिरिक्त configuration के बिना 1024 से नीचे के ports को bind नहीं कर सकता है, जो यहां मायने नहीं रखता क्योंकि port 3000 उस सीमा से ऊपर है। account को स्वयं सेट करने की प्रक्रिया VPS पर least-privilege users बनाना में शामिल है।

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

कंटेनर शुरू होने के एक सेकंड बाद बंद हो जाता है और लॉग खाली होते हैं। docker ps -a में Exited (1) दिखाई देता है। एक पिछला entrypoint तब विफल हो गया था जब HR_BACKENDS ने hermes को छोड़ दिया था, लेकिन 0.5.5 में पहले से ही सुधार शामिल है, भले ही इसकी README में अभी भी समस्या का उल्लेख है। केवल exit status से उस विफलता का निदान न करें। हाल के एक tag पर docker logs की अंतिम पंक्ति पढ़ें: 0.8.2 से --user के साथ शुरू किया गया एक कंटेनर एक पंक्ति के साथ बंद हो जाता है जिसमें कहा गया है कि इसे root के रूप में शुरू होना चाहिए।

पहली बार शुरू होने की प्रक्रिया कभी पूरी नहीं होती। लॉग installing पंक्ति के बाद रुक जाता है और ready on :3000 कभी दिखाई नहीं देता। जांचें कि क्या बॉक्स agent CLIs लाने के लिए नेटवर्क तक पहुंच सकता है, क्योंकि वे image में नहीं हैं। 0.5.5 और वर्तमान releases दोनों ही पूर्ण हो चुकी स्थापना विफलताओं को सहन करते हैं, लॉग में विफल स्थापनाओं का नाम देते हैं और उन्हें backends available: पंक्ति से बाहर छोड़ देते हैं। आउटबाउंड रूट या proxy सेटिंग्स को ठीक करें, फिर पुनरारंभ करें।

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

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

आप अपने लैपटॉप से ​​वहां तक नहीं पहुंच सकते और टनल चालू है। सर्वर पर docker port harnessrouter चलाएं। यदि यह कुछ भी प्रिंट नहीं करता है, तो कंटेनर कुछ भी प्रकाशित नहीं कर रहा है, इसलिए इसकी port mapping और network mode की जांच करें।

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

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

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

FAQ

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

नहीं। Console harnesses बनाता है, हर transcript को पढ़ता है, shell और filesystem access के साथ agents चलाता है, और आपके द्वारा कनेक्ट की गई provider key को सुरक्षित रखता है। इसलिए, एक असुरक्षित console इन सभी चीजों को उजागर कर देता है। इसे -p 127.0.0.1:3000:3000 के साथ loopback पर publish करें और SSH tunnel या TLS-terminating reverse proxy के माध्यम से एक्सेस करें। केवल एक ufw deny rule पर्याप्त नहीं है: Docker, ufw द्वारा प्रबंधित chains से पहले ही published container traffic को divert कर देता है। sudo ss -ltnp | grep 3000 के साथ इसकी पुष्टि करें, जिसे 127.0.0.1:3000 प्रिंट करना चाहिए, और किसी अन्य मशीन से access का परीक्षण करें। पुराने same-L2 localhost exposure से बचने के लिए Docker 28.0.0 या उसके बाद के वर्ज़न का उपयोग करें, और जाँचें कि direct routing सक्षम तो नहीं है।

किस HarnessRouter वर्ज़न में login gate जोड़ा गया था?

0.3.0। वर्ज़न 0.1.x और 0.2.0 बिना किसी authentication के जारी किए गए थे, इसलिए जो कोई भी उन्हें चला रहा है, वह इस भरोसे पर है कि किसी को port का पता नहीं चलेगा। इस पृष्ठ पर अंतिम बार उन tags को 12 October 2026 को प्रकाशित और pullable के रूप में दर्ज किया गया था; 8 November 2026 को उनकी वर्तमान उपलब्धता की पुष्टि नहीं की गई थी। 19 August 2026 तक नवीनतम tag 0.5.5 था, जो 18 August 2026 का है; 8 November 2026 को latest, 0.38.5 की ओर इशारा कर रहा था। आपके पास क्या है यह देखने के लिए docker image ls harnessrouter/harnessrouter चलाएँ, इसकी तुलना इस पृष्ठ के बजाय Docker Hub पर मौजूद tag सूची से करें, और अपना पासवर्ड चुनें। वर्तमान installations पुराने साझा डिफ़ॉल्ट को स्वीकार करने के बजाय एक प्रारंभिक पासवर्ड उत्पन्न करती हैं।

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

वर्तमान release पर ऐसा नहीं होना चाहिए। self-hosting गाइड कहती है कि किसी भी ऐसे backend को छोड़ दें जिसका आप उपयोग नहीं करेंगे, और जो backend install होने में विफल रहता है, वह fatal नहीं होता। एक पुराने implementation में hermes के न होने पर container status 1 के साथ और बिना किसी error message के exit हो जाता था, लेकिन 0.5.5 source ने उस विफलता को ठीक कर दिया है, भले ही इसकी README में अभी भी इसका उल्लेख हो। हाल के tag पर, docker logs पढ़ें: 0.8.2 से, --user के साथ शुरू किया गया container एक लाइन के साथ exit हो जाता है जिसमें कहा गया है कि इसे root के रूप में शुरू होना चाहिए।

क्या HarnessRouter को पहली बार शुरू करने पर internet access की आवश्यकता होती है?

हाँ। agent CLIs को image में शामिल करने के बजाय पहली बार शुरू करने पर fetch किया जाता है, और प्रत्येक CLI अपने स्वयं के licence और शर्तों के अधीन रहता है। 0.5.5 और वर्तमान releases दोनों ही log में विफल installs का नाम बताते हैं और अन्य backends को शुरू होने देते हैं। Installed CLIs को volume पर cache किया जाता है, इसलिए बाद की शुरुआत आमतौर पर तेज़ होती है, हालाँकि backend tools और आपके द्वारा चलाए जाने वाले tasks को अभी भी network access की आवश्यकता हो सकती है, और एक नया या पहले विफल रहा backend फिर से install की प्रक्रिया शुरू कर सकता है।

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

स्थानीय Console login के लिए कोई reset email नहीं है। Container को रोकें, volume से /data/selfhost-auth.json को हटा दें, इसे फिर से शुरू करें, फिर अपने कॉन्फ़िगर किए गए HR_AUTH_USER और HR_AUTH_PASSWORD के साथ, या यदि आपने अपना पासवर्ड नहीं दिया है तो उत्पन्न प्रारंभिक पासवर्ड के साथ sign in करें, और Profile पृष्ठ से एक नया पासवर्ड सेट करें। यदि container और volume दोनों का नाम harnessrouter है, तो वह docker stop harnessrouter है, फिर docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json, और फिर docker start harnessrouter है। उत्पन्न पासवर्ड को docker exec harnessrouter cat /data/selfhost-initial-password के साथ पढ़ें।

क्या यह लेख उपयोगी था?