SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor · अपडेट किया गया: 2026-11-20

Hister को self-host कैसे करें: अपना personal search engine

अपने VPS पर Hister को install करने का तरीका जानें। यह guide binary और Docker setup, TLS configuration, login security और MCP endpoint को सेटअप करने की पूरी प्रक्रिया समझाती है।

Hister क्या है, और क्या नहीं है

Hister एक personal search engine है जिसे आप स्वयं host करते हैं। यह आपके द्वारा देखे गए पेजों और आपके पास मौजूद फाइलों के full text को index करता है, और फिर आपको उस संग्रह को web interface, terminal client, HTTP API, या AI (artificial intelligence) assistant के माध्यम से खोजने की सुविधा देता है। Hister एक सवाल का जवाब देता है: मैंने वह कहाँ पढ़ा था।

अधिकांश पाठक इस विचार से SearXNG के माध्यम से परिचित होते हैं, और ये दोनों एक ही tool नहीं हैं। यदि आप जिस नाम को जानते हैं वह पुराना Searx है, तो वह project अब maintain नहीं किया जाता है, और इसका README अब पाठकों को Hister की ओर निर्देशित करता है, जो इसके लेखक का नया project है। Searx और SearXNG अलग-अलग projects बने हुए हैं, और SearXNG ही वह maintained fork है, इसलिए एक नया metasearch instance खड़ा करने के लिए यही सही विकल्प है। SearXNG एक metasearch proxy है। आपकी query उस तक जाती है, वह आपकी ओर से अन्य engines से पूछता है, और tracking हटाकर आपको उनके परिणाम वापस देता है। index उन engines का होता है। Hister आपके द्वारा दी गई सामग्री से अपना खुद का index बनाता है: browser extension द्वारा capture किए गए पेज, import की गई browser history, crawl किए गए URLs, और वे फाइलें जो उन directories में हैं जिन्हें आप इसे point करते हैं। एक self-hosted SearXNG instance आपको public web तक private access देता है। Hister आपको अपनी खुद की reading पर search करने की सुविधा देता है। दोनों के काम अलग हैं, इसलिए एक ही box पर दोनों को चलाना सामान्य है। यदि आप ऐसा करते हैं, तो यह जानना उपयोगी है कि SearXNG वास्तव में आपकी कितनी search को छिपाता है, क्योंकि यह queries को छिपाने के बजाय engines पर आपकी IP को आपके server की IP से बदल देता है।

Hister, AGPLv3 (GNU Affero General Public License, version 3) या उसके बाद के संस्करण के अंतर्गत free software है। इसमें कोई telemetry नहीं है और इसे किसी cloud service की आवश्यकता नहीं है। यह guide v0.17.0 version पर आधारित है, जो 2026-07-28 को current release था। 2026-10-12 को current release v0.20.0 था। 2026-10-29 को current release v0.21.0 था। 2026-11-19 को current release v0.22.0 है, जो project के नए नाम, Nogon के अंतर्गत पहली release है। नीचे दिए गए commands v0.17.0 के लिए लिखे गए थे, और यहाँ उल्लिखित कुछ features जो बाद में आए, उन्हें उस release के साथ चिह्नित किया गया है जिसमें उन्हें जोड़ा गया था। कुछ भी copy करने से पहले releases page पर current tag देखें, और फिर वहां मिलने वाले tag को pin करें।

v0.22.0 पर upgrade करने के लिए नीचे दिए गए version number को बदलने से कहीं अधिक काम करने की आवश्यकता है। नई downloads में nogon binary name का उपयोग होता है, config create, create-config की जगह लेता है, और user create तथा user update, create-user और update-user की जगह लेते हैं। upgrade करने से पहले server को stop करें और एक पूर्ण backup लें, साथ ही मौजूदा data paths और container volumes को सुरक्षित रखें। मौजूदा browser extension installations को store updates के माध्यम से नया नाम मिल जाता है और उनकी settings बरकरार रहती हैं।

VPS पर Hister को self-host क्यों करें

एक index तभी उपयोगी होता है जब वह पूर्ण हो, और वह तभी पूर्ण होता है जब आप पढ़ते समय सर्वर चल रहा हो। लैपटॉप दिन के आधे समय sleep mode में रहता है। उस दौरान आपके फोन पर खोली गई pages उस तक कभी नहीं पहुँचतीं, और रात भर चलने वाला import कभी शुरू नहीं हो पाता। एक VPS (virtual private server) हमेशा चालू रहता है, इसलिए आपके सभी उपकरण एक ही index में डेटा भेजते हैं और crawler आपके सोते समय भी काम करता रहता है।

दूसरा कारण है अलगाव (separation)। user_handling: true को app section में सेट करने से प्रत्येक account को एक ही instance पर अपने स्वयं के credentials और अपना document collection मिलता है। इस प्रकार एक सर्वर किसी परिवार या छोटी टीम का डेटा रख सकता है, बिना किसी के दूसरे की reading history को खोजे।

तीसरा कारण infrastructure है। VPS पर पहले से public hostname और certificate मौजूद हैं। Browser extension को ऐसे network से server तक पहुँचने के लिए इनकी आवश्यकता होती है, जिस पर आपका नियंत्रण नहीं है। यही hostname और certificate server पर दूसरे काम भी करते हैं, क्योंकि openGym अपना पहला passkey उस hostname के विरुद्ध register करता है जो उस समय live होता है। इसलिए पहला account बनाने से पहले hostname और certificate तय होने चाहिए।

इंस्टॉलेशन का पहला तरीका: रिलीज़ बाइनरी

Hister प्रत्येक प्लेटफॉर्म के लिए एक बाइनरी रिलीज़ करता है। इसे checksums फ़ाइल के साथ डाउनलोड करें और इंस्टॉल करने से पहले सत्यापित करें।

cd /tmp
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_linux_amd64
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_checksums.txt
sha256sum --ignore-missing -c hister_0.17.0_checksums.txt

एक सफल परिणाम hister_0.17.0_linux_amd64: OK की एक पंक्ति होती है। FAILED पंक्ति का अर्थ है कि डाउनलोड क्षतिग्रस्त या परिवर्तित हो गया है, इसलिए इसे इंस्टॉल करने के बजाय दोबारा डाउनलोड करें।

बाइनरी इंस्टॉल करें, फिर एक सिस्टम अकाउंट और वे निर्देशिकाएँ (directories) बनाएँ जिनका उपयोग यह करेगा।

sudo install -m 755 /tmp/hister_0.17.0_linux_amd64 /usr/local/bin/hister
sudo useradd --system --home-dir /var/lib/hister --shell /usr/sbin/nologin hister
sudo install -d -o hister -g hister -m 750 /var/lib/hister
sudo install -d -m 755 /etc/hister
sudo hister create-config /etc/hister/config.yml

create-config एक डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल लिखता है, और यह यह भी सिद्ध करता है कि बाइनरी इस मशीन पर चलती है। गलत आर्किटेक्चर के लिए किया गया डाउनलोड यहीं पर cannot execute binary file: Exec format error के साथ विफल हो जाता है।

उन कुछ सेटिंग्स को संपादित करें जो महत्वपूर्ण हैं। उत्पन्न फ़ाइल का शेष भाग वैसा ही रह सकता है जैसा वह है।

app:
  directory: /var/lib/hister
  access_token: 'paste-a-long-random-string-here'
server:
  address: 127.0.0.1:4433
  base_url: https://hister.example.com

openssl rand -hex 32 के साथ टोकन उत्पन्न करें। फ़ाइल में अब एक क्रेडेंशियल है, इसलिए सेवा शुरू होने से पहले इसे प्रतिबंधित (restrict) करें।

sudo chown root:hister /etc/hister/config.yml
sudo chmod 640 /etc/hister/config.yml

इसे systemd के अंतर्गत चलाएं

/etc/systemd/system/hister.service लिखें:

[Unit]
Description=Hister personal search engine
After=network-online.target
Wants=network-online.target

[Service]
User=hister
Group=hister
Environment=HISTER_CONFIG=/etc/hister/config.yml
ExecStart=/usr/local/bin/hister listen
Restart=on-failure
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/var/lib/hister

[Install]
WantedBy=multi-user.target

HISTER_CONFIG कॉन्फ़िगरेशन पाथ के लिए प्रलेखित environment variable है, इसलिए unit hister अकाउंट की home directory पर निर्भर नहीं करती है। ProtectSystem=strict इस सर्विस के लिए पूरे filesystem को read-only बना देता है, यही कारण है कि ReadWritePaths को data directory का नाम देना पड़ता है। ProtectHome=yes सर्विस से /home को छिपा देता है, इसलिए /home के अंतर्गत देखी जाने वाली directory indexer को खाली दिखाई देगी। यदि आपको वहां फाइलों को index करने की आवश्यकता है, तो उस लाइन को हटा दें।

sudo systemctl daemon-reload
sudo systemctl enable --now hister
systemctl status hister --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4433/

पिछले कमांड द्वारा प्रिंट किया गया कोई भी HTTP status code यह दर्शाता है कि process listening मोड में है। curl: (7) Failed to connect का अर्थ है कि यह listening मोड में नहीं है, और journalctl -u hister -n 50 --no-pager कारण बताएगा।

इंस्टॉलेशन का दूसरा तरीका: Docker Compose

यह इमेज GitHub container registry पर प्रकाशित की गई है, जिसमें प्रत्येक release के लिए एक tag उपलब्ध है।

services:
  hister:
    image: ghcr.io/asciimoo/hister:v0.17.0
    container_name: hister
    user: '1000:1000'
    restart: unless-stopped
    environment:
      - HISTER__SERVER__ADDRESS=0.0.0.0:4433
      - HISTER__SERVER__BASE_URL=https://hister.example.com
      - HISTER__APP__ACCESS_TOKEN=${HISTER_ACCESS_TOKEN}
    volumes:
      - ./data:/hister/data
    ports:
      - 127.0.0.1:4433:4433

प्रत्येक configuration key का एक environment override होता है जिसका प्रारूप HISTER__<SECTION>__<KEY> है, जिसमें विभाजक के रूप में दो underscores का उपयोग किया जाता है। इसलिए, container deployment के लिए किसी mounted config file की आवश्यकता नहीं होती है। HISTER_ACCESS_TOKEN को compose file के बगल में एक .env file में रखें। यदि आप किसी file को edit करना पसंद करते हैं, तो docker run --rm ghcr.io/asciimoo/hister:v0.17.0 create-config > config.yml defaults को print कर देता है।

ऊपर दी गई दो पंक्तियों में गलती करना आसान है, और दोनों को समझना महत्वपूर्ण है।

Container के अंदर का address 0.0.0.0:4433 होना चाहिए। एक container का अपना network namespace होता है, इसलिए वहां 127.0.0.1 पर bound process केवल उस container के अंदर से ही पहुंच योग्य होती है, और published port के पास forward करने के लिए कुछ नहीं होता है।

Published port को 127.0.0.1:4433:4433 लिखा जाता है, न कि 4433:4433। Docker अपने स्वयं के netfilter rules डालकर ports को publish करता है, और उन rules का मूल्यांकन ufw rules से पहले किया जाता है। इसलिए, एक साधारण 4433:4433 उस server पर भी internet से पहुंच योग्य रहता है जहां ufw status यह दिखाता है कि port बंद है। Host side को 127.0.0.1 पर bind करने से reverse proxy ही अंदर आने का एकमात्र रास्ता बचता है। यही trap server पर मौजूद हर container पर लागू होता है, और Docker Compose on a VPS इस विषय के बाकी पहलुओं को कवर करता है।

user: '1000:1000' पंक्ति container को UID 1000 और GID 1000 के रूप में चलाती है, जो official v0.17.0 image के default UID और GID 65532 को override करती है। इसलिए, ./data को UID 1000 और GID 1000 द्वारा writable होना चाहिए। यदि directory मौजूद नहीं है, तो इसे mkdir -p ./data के साथ बनाएं; sudo chown -R 1000:1000 ./data उस account को ownership देता है। SELinux सक्षम host पर, ./data:/hister/data:Z का उपयोग करें ताकि Docker एक उपयुक्त label assign कर सके। यदि ये numbers आपके लिए नए हैं, तो पहले which UID and GID a container writes files as पढ़ें।

पर्सनल सर्च इंडेक्स को एक्सपोज़ करना सबसे खतरनाक क्यों है

Hister डिफ़ॉल्ट रूप से 127.0.0.1:4433 पर listen करता है, और यह डिफ़ॉल्ट जानबूझकर रखा गया है। सोचें कि एक महीने के उपयोग के बाद इंडेक्स में क्या-क्या होता है: इंटरनल विकी पेज, इनवॉइस, लॉग-इन रहने के दौरान खोली गई सपोर्ट टिकट, पासवर्ड रीसेट पेज, और आपके द्वारा पढ़ी गई हर चीज़ का पूरा टेक्स्ट। प्रोजेक्ट डॉक्यूमेंटेशन इसे सीधे तौर पर कहता है: "Hister आपके पूरे ब्राउज़िंग इतिहास को, पेज की सामग्री के साथ, सर्वर तक और वहां से ट्रांसमिट करता है।"

एक लीक हुए पासवर्ड डेटाबेस को अभी भी क्रैक करना पड़ता है। एक लीक हुआ पर्सनल इंडेक्स प्लेन टेक्स्ट में होता है और पहले से ही सर्च करने योग्य होता है, इसलिए यह उस छोटे से self-hosted ऐप की तुलना में कहीं अधिक सावधानी का हकदार है जैसा यह दिखता है।

इससे दो तथ्य सामने आते हैं। Hister को आउट-ऑफ़-द-बॉक्स किसी ऑथेंटिकेशन की आवश्यकता नहीं होती है, इसलिए केवल एक reverse proxy इसे किसी भी ऐसे व्यक्ति के लिए सर्च करने योग्य बना देता है जिसे hostname का पता चल जाए। MCP endpoint भी डिफ़ॉल्ट रूप से /mcp पर सर्व किया जाता है, और बिना किसी टोकन के, कोई भी क्लाइंट जो वहां तक पहुँचता है, इंडेक्स पर सर्च चला सकता है।

सर्विस को पहली बार localhost से बाहर ले जाने से पहले ऑथेंटिकेशन कॉन्फ़िगर करें। एक सिंगल यूजर को केवल app.access_token की आवश्यकता होती है, जो ब्राउज़र एक्सटेंशन, टर्मिनल क्लाइंट और किसी भी MCP क्लाइंट द्वारा भेजा गया एक साझा सीक्रेट है। कई लोगों के लिए, user_handling: true सेट करें और अकाउंट बनाएँ:

sudo -u hister hister create-user alice --admin --config /etc/hister/config.yml

यह कमांड 8 से 72 UTF-8 बाइट्स के पासवर्ड के लिए प्रॉम्प्ट करती है। एक Unicode कैरेक्टर कई बाइट्स ले सकता है, इसलिए आठ से कम कैरेक्टर भी मान्य हो सकते हैं। प्रत्येक अकाउंट को अपने स्वयं के दस्तावेज़ और एक पर्सनल API टोकन मिलता है, जिसे ओनर प्रोफाइल पेज से या hister update-user पर --regen-token फ्लैग के साथ रीजेनरेट कर सकता है। नया टोकन जनरेट करने से पिछला टोकन तुरंत अमान्य हो जाता है, इसलिए उस अकाउंट का उपयोग करने वाले प्रत्येक डिवाइस को बाद में अपडेट करना पड़ता है।

app.public को तब तक न छुएं जब तक आप वास्तव में ऐसा न करना चाहते हों। पब्लिक मोड अनऑथेंटिकेटेड सर्च, प्रीव्यू, फाइल सर्विंग और MCP सर्च की अनुमति देता है, जबकि यह राइट्स, हिस्ट्री एक्सेस और एडमिन ऑपरेशंस को ब्लॉक रखता है।

Reverse proxy, TLS और firewall

Hister स्वयं HTTPS serve नहीं करता है, इसलिए इसके सामने TLS (transport layer security) को terminate करें। Caddy सबसे सरल विकल्प है, क्योंकि यह ACME (automatic certificate management environment) के माध्यम से स्वयं certificates का अनुरोध और नवीनीकरण करता है।

hister.example.com {
    reverse_proxy 127.0.0.1:4433
}

इसे sudo systemctl reload caddy के साथ reload करें। इस configuration के लिए, hister.example.com के DNS records को इस सर्वर पर point करना चाहिए, चाहे वह IPv4 के लिए A record हो, IPv6 के लिए AAAA record हो, या दोनों हों। Caddy डिफ़ॉल्ट रूप से port 80 पर HTTP-01 validation और port 443 पर TLS-ALPN-01 validation को सक्षम करता है, इसलिए जब validation port 443 पर सफल हो जाता है तो port 80 की आवश्यकता नहीं होती है। Let’s Encrypt IPv4 के साथ-साथ IPv6 पर भी validation करता है और पहले AAAA address को आज़माता है, इसलिए पुराने host से बचा हुआ कोई भी stale AAAA record validation को विफल कर सकता है, भले ही A record सही हो। जब DNS गलत होता है या कोई भी challenge सफल नहीं होता है, तो browser को page के बजाय TLS error मिलती है और Caddy log विफल challenge को दोहराता है।

फिर बाकी सब कुछ बंद कर दें।

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

Port 4433 जानबूझकर उस सूची से बाहर रखा गया है। अंदर आने का एकमात्र तरीका public hostname नहीं है, और उसी loopback port पर point किया गया एक onion service बिना किसी DNS record या किसी inbound port को खोले आपके अपने उपकरणों से आपके index तक पहुँच सकता है।

server.base_url को उस address से मेल खाना चाहिए जिसे आप browser में type करते हैं, जिसमें scheme भी शामिल है। base_url में गलत path prefix asset links को तोड़ देता है और interface को बिना style वाले text और गायब images के साथ छोड़ देता है। वही URL browser extension में भी डाला जाता है।

इंडेक्स भरना

Browser extension मुख्य डेटा संग्रहकर्ता है। इसे Mozilla Add-ons या Chrome Web Store से इंस्टॉल करें, इसके options पेज को खोलें, सर्वर URL को https://hister.example.com पर सेट करें और access token पेस्ट करें। Extension में token का समर्थन v0.18.0 के साथ आया था; v0.17.0 extension इसके बजाय वेब इंटरफेस में साइन-इन करने से प्राप्त session का उपयोग करता है। यह आपके द्वारा देखे जाने वाले प्रत्येक पेज का शीर्षक, पूर्ण टेक्स्ट, HTML और favicon कैप्चर करता है और उन्हें आपके सर्वर पर पोस्ट कर देता है। Extraction क्लाइंट-साइड पर, ब्राउज़र के अंदर होता है। Extension किसी तीसरे पक्ष से संपर्क नहीं करता है, और यह केवल पेज favicon के लिए बाहरी अनुरोध करता है।

क्लाइंट-साइड extraction ही वह चीज़ है जो एक निजी इंडेक्स को संभव बनाती है। Extension पेज को बिल्कुल वैसे ही देखता है जैसे आप उसे देखते हैं, लॉगिन के बाद और रेंडरिंग के बाद, इसलिए एक आंतरिक wiki पेज या भुगतान किया गया लेख सही ढंग से इंडेक्स हो जाता है और आपके सर्वर को कभी भी क्रेडेंशियल्स की आवश्यकता नहीं होती है। इसका मतलब यह भी है कि आप जो कुछ भी देखते हैं वह इंडेक्स के लिए एक उम्मीदवार है, यही कारण है कि अधिक सामग्री से पहले skip rules आते हैं।

Skip rules सिंगल-यूज़र इंस्टॉल में rules.json में रहते हैं, या डेटाबेस में प्रति यूज़र होते हैं, और वेब इंटरफेस में Rules टैब उन्हें संपादित करने का सबसे आसान तरीका है। वे Go regular expressions हैं जिनका मिलान पूर्ण URL के विरुद्ध किया जाता है:

^https://mail\.example\.com
^https://bank\.example\.com

^mail.example.com जैसा पैटर्न कभी मैच नहीं होता, क्योंकि टेस्ट की जा रही स्ट्रिंग https:// से शुरू होती है। नॉर्मलाइजेशन के बाद जब query string बाकी रह जाती है तो एक ट्रेलिंग $ विफल हो जाता है। केवल utm_* पैरामीटर्स को हटाया जाता है, इसलिए /login$, https://example.com/login?utm_source=email से मैच कर सकता है, लेकिन https://example.com/login?auth=1 से नहीं।

मौजूदा हिस्ट्री को ब्राउज़र के अपने डेटाबेस को पढ़कर इम्पोर्ट किया जाता है, इसलिए वह कमांड उस मशीन पर चलती है जिसमें ब्राउज़र प्रोफाइल है, जो कि आपका लैपटॉप है न कि VPS। वहां वही बाइनरी इंस्टॉल करें और इसे सर्वर की ओर पॉइंट करें:

export HISTER_TOKEN='your-access-token'
hister import browser firefox -u https://hister.example.com -t "$HISTER_TOKEN"

एक इम्पोर्ट browser-import-YYYY-MM-DD नामक एक रिज़्यूमेबल जॉब के रूप में चलता है, इसलिए आप इसे बीच में रोक सकते हैं और बाद में फिर से शुरू कर सकते हैं। बुकमार्क सेवाएं भी इसी तरह इम्पोर्ट होती हैं। v0.17.0 Linkwarden, Karakeep और Shaarli का समर्थन करता है, v0.18.0 ने Linkding, Readeck और Wallabag को जोड़ा, और v0.20.0 ने Raindrop.io को जोड़ा। Linkwarden, Karakeep, Shaarli, Linkding, Readeck या Wallabag से एक रिपीट इम्पोर्ट केवल वही डेटा लाता है जो पिछले इम्पोर्ट से नया है।

सर्वर पर फाइलें कॉन्फ़िगरेशन में डायरेक्टरीज़ का नाम देकर इंडेक्स की जाती हैं:

indexer:
  directories:
    - path: '/var/lib/hister/documents'
      filetypes: ['pdf', 'docx', 'md', 'txt']

PDF, DOCX, Markdown, Org mode और वैध UTF-8 टेक्स्ट फाइलों को पूर्ण टेक्स्ट के रूप में पढ़ा जाता है। फोटो और वीडियो उस सूची में नहीं हैं, इसलिए एक इमेज लाइब्रेरी को ऐसे सर्वर की आवश्यकता होती है जो टेक्स्ट के बजाय चेहरों, स्थानों और तारीखों को इंडेक्स करे, और PhotoPrism और Immich वे दो हैं जिनकी आमतौर पर उस काम के लिए तुलना की जाती है। एक सिंगल पेज hister index https://example.com के साथ जोड़ा जाता है। पूरी साइटों को अन्य टूल्स के लिए साफ टेक्स्ट में बदलना एक अलग काम है, जिसे पेजों को साफ टेक्स्ट में बदलने वाले self-hosted crawlers द्वारा संभाला जाता है।

सर्च फील्ड-आधारित है, इसलिए क्वेरी भाषा को पढ़ने में बिताए गए दस मिनट सार्थक होते हैं:

"connection reset" domain:github.com added:<30d
title:(wireguard|nftables) -tutorial sort:-visits

sort: फील्ड v0.18.0 में आया था, इसलिए v0.17.0 पर दूसरी क्वेरी से इसे हटा दें।

MCP के माध्यम से अपने स्वयं के इंडेक्स पर कोडिंग एजेंट को पॉइंट करें

MCP (model context protocol) वह interface है जिसका उपयोग assistant server पर tools call करने के लिए करता है। Hister इसे उसी base URL के अंतर्गत POST /mcp पर streamable HTTP transport के माध्यम से उपलब्ध कराता है और search, get_preview तथा get_history expose करता है। Authentication के लिए API के बाकी हिस्सों में उपयोग होने वाला वही bearer token इस्तेमाल होता है। यदि tool calling आपके लिए नया विषय है, तो अपना छोटा agent loop लिखना यह समझने का सबसे तेज तरीका है कि इस जैसे endpoint से assistant को वास्तव में क्या मिलता है।

{
  "mcpServers": {
    "hister": {
      "url": "https://hister.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

एक X-Access-Token हेडर Authorization के विकल्प के रूप में काम करता है।

यहाँ इसका लाभ इस बात में है कि एजेंट क्या सर्च करता है। ओपन वेब सर्च वही परिणाम देता है जो आज रैंक कर रहे हैं, जो तेजी से बदलते सॉफ्टवेयर के लिए अक्सर उस वर्ज़न का डॉक्यूमेंटेशन होता है जिसे आप रन नहीं कर रहे हैं। आपका अपना इंडेक्स वह पेज लौटाता है जिसे आपने पहले ही पढ़ लिया है और जिसे आपने रखने का निर्णय लिया है, और get_preview संग्रहीत कॉपी को सर्व करता है, इसलिए मूल पेज के ऑफलाइन होने पर भी उत्तर सुरक्षित रहता है। यदि आप सार्वजनिक परिणाम भी चाहते हैं तो एजेंट को दोनों स्रोत दें: SearXNG द्वारा समर्थित ब्राउज़र सर्च स्किल ओपन वेब को एक अलग टूल के रूप में जोड़ती है। एक बार जब आप इनमें से एक से अधिक एंडपॉइंट्स रन कर लेते हैं, तो VPS पर MCP सर्वर होस्ट करना पढ़ना सार्थक है, क्योंकि उनमें से प्रत्येक इस एक्सपोज़र समस्या को साझा करता है।

डिस्क, बैकअप और रखरखाव

दस्तावेज़ीकरण के अनुसार एक इंडेक्स किया गया पेज लगभग 100 KB का होता है, जिसमें कंप्रेस्ड प्रीव्यू भी शामिल है, इसलिए एक लाख पेज लगभग 10 GB के बराबर होते हैं। इसमें कोई कोटा सिस्टम नहीं है। दो सेटिंग्स को अक्सर एक समझ लिया जाता है: indexer.max_file_size_mb (डिफ़ॉल्ट रूप से 1 MiB) एक सिंगल वॉच की गई फ़ाइल को सीमित करता है, और server.max_batch_body_size (डिफ़ॉल्ट रूप से 40 MiB) बैच API के एक अनुरोध को सीमित करता है। यह दूसरी सेटिंग v0.17.0 के बाद आई है, जो बैच अनुरोध को 5 MiB पर सीमित करती है।

app.directory द्वारा नामित डायरेक्टरी में index.db (भाषा-वार इंडेक्स फ़ाइलों के साथ), खातों और जॉब्स के लिए db.sqlite3, प्रीव्यू के लिए data/html/, और rules.json शामिल होते हैं। बैकअप का अर्थ है सर्विस को रोकना और उस पूरी डायरेक्टरी तथा कॉन्फ़िगरेशन फ़ाइल की एक कॉपी बनाना। hister export backup.json माइग्रेशन के लिए दस्तावेज़ों को JSON के रूप में लिखता है, और यह सर्वर बैकअप नहीं है।

रखरखाव के दो कमांड जानना उपयोगी है। hister reindex सर्च इंडेक्स को फिर से बनाता है, जो इंडेक्सर सेटिंग्स बदलने के बाद आवश्यक होता है। यदि बड़े इम्पोर्ट के दौरान मेमोरी का उपयोग बढ़ जाता है, तो indexer सेक्शन में detect_languages: false सेट करें और फिर से इंडेक्स करें। hister cleanup उन अनाथ (orphaned) प्रीव्यू और फ़ेविकॉन फ़ाइलों को हटा देता है जो डिलीट करने के बाद पीछे रह जाती हैं।

डिलीट करना एक क्वेरी है, इसलिए इसे पहले ड्राई मोड में चलाएं:

hister delete 'domain:example.com' --dry --verbose

यदि कोई कलेक्टर अभी भी इसे सबमिट करता है, तो डिलीट किया गया पेज वापस आ जाता है, इसलिए डिलीट करने से पहले स्किप नियम जोड़ें।

Hister की एक अपरिवर्तित कॉपी स्वयं चलाने पर कोई बाध्यता नहीं है, क्योंकि AGPLv3 अपरिवर्तित प्रोग्राम को चलाने की असीमित अनुमति देता है। अन्य लोगों को कॉपी देना, चाहे वे बदली गई हों या नहीं, कुछ शर्तों के साथ आता है, जैसे कॉपीराइट और लाइसेंस नोटिस को बरकरार रखना और प्राप्तकर्ताओं को लाइसेंस की एक कॉपी देना। यदि आप Hister को संशोधित करते हैं और अन्य लोगों को नेटवर्क पर अपने वर्ज़न का उपयोग करने देते हैं, तो लाइसेंस यह भी मांग करता है कि आप उन्हें अपना संशोधित सोर्स कोड प्रदान करें।

विफलता के प्रकार और दिखाई देने वाले संदेश

सर्वर स्टार्ट नहीं होता है। पोर्ट 4433 का पहले से उपयोग में होना या YAML सिंटैक्स में त्रुटि इसके दो मुख्य कारण हैं; कॉन्फ़िगरेशन वैलिडेशन और डेटा-डायरेक्टरी तक पहुँच न होना भी स्टार्टअप को रोक देते हैं। server.base_url के बिना 0.0.0.0 पर बाइंड करने से base_url must be specified when listening on उत्पन्न होता है, और सीक्रेट की (secret key) लिखने में विफलता से failed to create secret key file उत्पन्न होता है। sudo ss -lntp | grep 4433 यह दिखाता है कि पोर्ट को किसने रोक रखा है, और journalctl -u hister -n 50 --no-pager स्टार्टअप त्रुटि को प्रिंट करता है।

इंटरफ़ेस लोड होता है लेकिन टूटा हुआ दिखता है। अव्यवस्थित टेक्स्ट और गायब छवियों के लिए, server.base_url में पाथ प्रीफिक्स की जाँच करें। Hister उस सेटिंग से ट्रेलिंग स्लैश (trailing slash) को हटा देता है।

एक्सटेंशन कनेक्ट नहीं होता है। एक्सटेंशन में सर्वर URL का base_url के समान होना आवश्यक है, सर्वर का चालू और अपडेटेड होना जरूरी है, और बीच में मौजूद कोई फायरवॉल बिना किसी संदेश के इसे ब्लॉक कर सकता है। Firefox एक्सटेंशन लॉग्स को सामान्य कंसोल से दूर रखता है: about:debugging#/runtime/this-firefox खोलें और Hister एक्सटेंशन का निरीक्षण करें।

कंटेनर स्टार्टअप पर ही बंद हो जाता है। ./data पर अनुमति त्रुटि (permission error) होने पर ओनरशिप, राइट परमिशन और SELinux लेबलिंग की जाँच करें। यह compose फ़ाइल स्पष्ट रूप से UID 1000 और GID 1000 के रूप में चलती है, जो इमेज के डिफ़ॉल्ट UID और GID 65532 को ओवरराइड करती है। उस अकाउंट को ./data पर राइट एक्सेस दें; SELinux होस्ट पर, बाइंड माउंट में :Z जोड़ें।

एडमिन रूट से 403 Forbidden त्रुटि। जब यूजर हैंडलिंग चालू होती है, तो POST /api/reindex और POST /api/cleanup केवल एडमिन के लिए होते हैं, इसलिए सामान्य अकाउंट को वहाँ एक्सेस करने से मना कर दिया जाता है।

इंपोर्ट के दौरान मेमोरी का बढ़ना। बड़े इतिहास (history) पर भाषा का पता लगाना (language detection) इसका सामान्य कारण है। detect_languages: false सेट करें और उसके बाद hister reindex चलाएँ।

FAQ

Hister, SearXNG से किस प्रकार भिन्न है?

SearXNG एक metasearch proxy है: यह आपकी query को public search engines को भेजता है और tracking हटाकर परिणाम वापस लाता है, इसलिए index उन engines का ही रहता है। Hister आपके द्वारा देखे गए पृष्ठों और आपके द्वारा रखी गई फाइलों का अपना full-text index रखता है, इसलिए यह "मैंने वह कहाँ पढ़ा था" का उत्तर देता है, जबकि SearXNG "वेब क्या कहता है" का उत्तर देता है। वे अलग-अलग समस्याओं का समाधान करते हैं, और कई लोग एक ही सर्वर पर दोनों को चलाते हैं।

क्या अपनी पूरी browsing history को VPS पर रखना सुरक्षित है?

केवल तभी, जब पहले exposure से संबंधित कार्य पूरे कर लिए जाएं। Hister डिफ़ॉल्ट रूप से 127.0.0.1:4433 पर bind होता है और इसके लिए किसी authentication की आवश्यकता नहीं होती है। app.access_token या user_handling: true सेट करें, इसके सामने TLS के साथ एक reverse proxy लगाएं, और firewall पर port 4433 को बंद रखें। आपके द्वारा पढ़े गए डेटा का full-text index plain text में होता है, इसलिए जो कोई भी उस port तक पहुँच जाएगा, वह बिना कुछ क्रैक किए सब कुछ पढ़ सकेगा।

क्या मुझे browser extension की आवश्यकता है, या मैं केवल अपनी history import कर सकता हूँ?

Import एक बार की जाने वाली प्रक्रिया है। यह browser के अपने history database को पढ़ती है, इसलिए यह सर्वर के बजाय उस कंप्यूटर पर चलती है जिसमें browser profile मौजूद है। इसके बाद extension index को current रखती है, और यह login के पीछे के पृष्ठों को भी capture कर लेती है क्योंकि यह पृष्ठ के render होने के बाद browser में content को extract करती है। एक सामान्य setup में एक बार import करना और फिर extension का उपयोग करना शामिल है।

हाँ। Hister आपके base URL पर POST /mcp पर एक MCP (model context protocol) सर्वर है, जो search, get_preview और get_history को expose करता है। client को https://your-host/mcp पर point करें और उसमें अपने access token के साथ एक Authorization: Bearer header जोड़ें। इसके बाद agent उन documentation को search करता है जिन्हें आपने वास्तव में पढ़ा है, उसी version में जिसे आपने पढ़ा था, न कि उन परिणामों को जो आज public search engine में rank कर रहे हैं।

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