SearXNG ను స్వయంగా హోస్ట్ చేసి private search నడపడం
Docker Compose తో మీ VPS పై SearXNG నడపండి: settings.yml, limiter, TLSతో nginx, అలాగే మీ scripts ఉపయోగించగల JSON search APIని సెట్ చేయడం నేర్చుకోండి.
మీరు నిర్మించేది
SearXNG ను self-hosting చేయడం ద్వారా మీ సొంత server పై నడిచే private search engine మీకు లభిస్తుంది. SearXNG ఒక metasearch engine. ఇది మీ query ను Google, Bing, DuckDuckGo, Wikipedia వంటి ఇతర engines కు పంపి, వచ్చిన ఫలితాలను ఒకే result page లో కలిపి చూపిస్తుంది. ఎలాంటి profile నిర్మించబడదు. Tracking cookie కూడా set చేయబడదు. ఎందుకంటే మీ query ను నిల్వ ఉంచే machine మీది మాత్రమే. కేవలం Searx అని పిలిచే పాత guides మీకు కనిపించి ఉంటే, ఈ project దాని నుంచి fork చేయబడింది. దాని స్వంత repository ప్రకటించిన ప్రకారం Searx ఇక maintained కాదు. ఇది September 2023 నుంచి unmaintained గా ఉంది. ఆ తరువాత వచ్చిన ఏకైక commit, May 2026 లోని documentation note, ఈ పరిస్థితిని మార్చలేదు. అందువల్ల ఒకదాన్ని అనుసరించే ముందు రెండింటి స్థితిని పరిశీలించండి.
ఈ stack చిన్నది. రెండు containers, ఒక settings file, ఒక reverse proxy ఉంటాయి. ఇది చిన్న VPS పై సులభంగా నడుస్తుంది. అయితే ప్రతి self-hosted service విషయంలో ఇది నిజం కాదు. PhotoPrism మరియు Immich మధ్య పరిశీలించిన photo libraries లో RAM అవసరాన్ని web app కాకుండా indexer నిర్ణయిస్తుంది. అసలు నిర్ణయం instance private గా ఉండాలా, public గా ఉండాలా అనేదే. Private అంటే మీరు మరియు మీ సొంత scripts మాత్రమే దాన్ని చేరుకోవడం. Public అంటే internet పై ఉన్న ఎవరైనా దానిని query చేయగలగడం. ఈ ఎంపిక security settings ను మార్చుతుంది. కాబట్టి ఏదైనా type చేయడానికి ముందు దీనిని నిర్ణయించండి. Default ఎంపిక private.
దీన్ని నడపడానికి మరో కారణం ఉంది. SearXNG instance JSON ను అందిస్తుంది. అందువల్ల మీరు రాసే ఏ script లేదా AI agent అయినా మీ సొంత search API ను ఉపయోగించగలదు. Key అవసరం లేదు. ప్రతి query కు billing ఉండదు. Quota గురించి mail కూడా రాదు.
Docker Compose తో SearXNG ఇన్స్టాల్ చేయడం
ఈ ప్రాజెక్ట్ ఒక container image మరియు Compose file ను విడుదల చేస్తుంది. ఇప్పటికే Docker Engine మరియు Compose plugin ఉన్న కొత్త Ubuntu 24.04 server కు రెండింటినీ pull చేయండి. Docker మీకు కొత్త అయితే, ముందుగా VPS పై Docker Compose ప్రాథమికాలు చదివి, తరువాత ఇక్కడికి తిరిగి రండి.
sudo install -d -o "$USER" -g "$USER" -m 750 /opt/searxng
cd /opt/searxng
mkdir -p core-config
curl -fsSL \
-O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
-O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
cp -i .env.example .envCompose file లో రెండు services నిర్వచించబడ్డాయి. core అనేది SearXNG స్వయంగా, valkey అనేది rate limiting మరియు స్వల్పకాలిక state కోసం ఉపయోగించే in-memory data store. ఇది container లోని /etc/searxng/ కు ./core-config/ ను mount చేస్తుంది. అందువల్ల మీరు configure చేసే ప్రతిదీ host లోని ఒకే directory లో ఉంటుంది.
ఇప్పుడు .env ను edit చేయండి. అందించిన example లో ప్రతి line comment చేయబడి ఉంటుంది. అందుకే container ప్రతి address పై port 8080 కు start అవుతుంది. ఈ మూడు lines ను uncomment చేసి set చేయండి.
SEARXNG_VERSION=latest
SEARXNG_HOST=127.0.0.1
SEARXNG_PORT=8080SEARXNG_HOST=127.0.0.1 అత్యంత ముఖ్యమైనది. ఇది published port ను ఖాళీ 8080:8080 బదులుగా 127.0.0.1:8080:8080 గా చేస్తుంది. Docker ఖాళీ 8080:8080 ను ప్రతి address పై publish చేస్తుంది. ఈ మార్పుతో container loopback address పై మాత్రమే స్పందిస్తుంది. Internet దాన్ని నేరుగా చేరుకోలేను. దీన్ని మరిస్తే container start అయిన వెంటనే expose అవుతుంది. కారణం, published Docker port మీ firewall rules కంటే ముందుగా insert చేయబడుతుంది. ఈ సమస్యను పూర్తిగా చదవడం విలువైనది: published Docker ports ufw ను దాటిపోతాయి.
మీరు నేర్చుకుంటున్న సమయంలో SEARXNG_VERSION=latest సరిపోతుంది. ముఖ్యమైన server పై tag ను నిర్దిష్టంగా pin చేయండి. October 2026 నాటికి release tags తేదీ ఆధారంగా ఉంటాయి. అవి 2026.10.4-d48c4b555 లాగా కనిపిస్తాయి. అందువల్ల registry లో మార్పు వచ్చినప్పుడు కాకుండా, మీరు నిర్ణయించినప్పుడు pinned deployment upgrade అవుతుంది. Server పై ఎక్కువకాలం నడిచే ఇతర వాటికీ ఇదే క్రమశిక్షణ ఉపయోగపడుతుంది. అందుకే self-hosted RustDesk relay కూడా తన image tags ను pin చేస్తుంది. Remote access service కు unattended upgrade జరిగితే, అది అత్యంత అననుకూల సమయంలోనే తెలుస్తుంది.
settings.yml: ముఖ్యమైన భాగాలు
మొదటి start కు ముందు core-config/settings.yml ను సృష్టించండి. use_default_settings: true వలన SearXNG ముందుగా తాను shipped చేసిన default విలువలను load చేసి, మీరు రాసిన keys ను మాత్రమే వర్తింపజేస్తుంది. అందువల్ల మీ file చిన్నగా ఉంటుంది. కొత్త options చేర్చే upgrades తర్వాత కూడా ఇది సులభంగా కొనసాగుతుంది.
ముందుగా secret ను generate చేయండి. ఆ విలువ నేరుగా file లోకి వెళ్తుంది.
openssl rand -hex 32use_default_settings: true
general:
instance_name: "search.example.com"
server:
base_url: "https://search.example.com/"
secret_key: "paste-the-openssl-output-here"
limiter: false
public_instance: false
image_proxy: true
valkey:
url: valkey://valkey:6379/0
search:
safe_search: 0
autocomplete: "duckduckgo"
formats:
- html
- jsonSession మరియు token data పై secret_key signature వేస్తుంది. Shipped default అక్షరాలా ultrasecretkey. దీన్ని అలాగే ఉంచితే, ఆ default తెలిసిన ఎవరైనా ఆ tokens ను forge చేయగలరు. దీన్ని ఒక్కసారి మార్చి, తరువాత అలాగే ఉంచండి. తరువాత మార్చితే సేవ్ చేసిన ప్రతి preference తొలగిపోతుంది.
base_url trailing slash తో ఉన్న public HTTPS address కావాలి. SearXNG render చేసే links లో ఈ address ను రాస్తుంది. దీన్ని localhost కు ఉంచితే, remote browser లోని "next page" link ఆ browser నడుస్తున్న వ్యక్తి స్వంత machine వైపు చూపిస్తుంది. అది విఫలమవుతుంది.
Web endpoint ఏ output types ను అందించాలో formats నిర్ణయిస్తుంది. Default list లో json ఉండదు. అందువల్ల దాన్ని add చేసే వరకు JSON request 403 ను return చేస్తుంది. image_proxy: true result thumbnails ను మీ server ద్వారా route చేస్తుంది. దాంతో ఆ images ను host చేసే sites కు మీ visitors addresses కనిపించవు.
valkey.url లో valkey hostname ను ఉపయోగించాలి. Compose file లో service name అదే. Compose రెండు containers ను ఒకే network పై ఉంచుతుంది, అక్కడ service names resolve అవుతాయి. దాన్ని localhost కు point చేస్తే limiter విఫలమవుతుంది. ఎందుకంటే core container లో localhost అంటే ఆ container నే.
Secret plain file లో ఉంటుంది. అందువల్ల దాని చుట్టూ ఉన్న directory ను కూడా protect చేయాలి. chmod 750 /opt/searxng ఇతర host users ను దూరంగా ఉంచుతుంది. ఏదీ విరగకుండా core-config/settings.yml ను mode 600 కు కూడా కఠినతరం చేయవచ్చు. Official container యొక్క entrypoint root గా ప్రారంభమవుతుంది. FORCE_OWNERSHIP ను దాని default అయిన true గా ఉంచితే, SearXNG start అయ్యే ముందు mounted config directory ను container యొక్క స్వంత searxng user కు అప్పగిస్తుంది. అందువల్ల ఆ user file ను చదవగలుగుతుంది. దీని ప్రభావం host పై కనిపిస్తుంది: అదే దశ core-config/ owner ను container user ID కు మార్చుతుంది. కాబట్టి తరువాత file ను edit చేయడానికి sudo అవసరం అవుతుంది.
Stack ను start చేసి తనిఖీ చేయండి.
cd /opt/searxng
docker compose up -d
docker compose ps
curl -I http://127.0.0.1:8080/docker compose ps రెండు containers ను running state లో చూపించాలి. curl, HTTP/1.1 200 OK కు సమాధానం ఇవ్వాలి. ఏ సమాధానం రాకపోతే docker compose logs core ను చదవండి. settings.yml లోని YAML తప్పు అక్కడ line ను పేర్కొనే parse error గా కనిపిస్తుంది.
nginx తో TLS వెనుక దీన్ని అమర్చండి
Container loopback పై మాత్రమే వినుతుంది. అందువల్ల దాన్ని చేరుకోగలిగేలా చేసేది nginx. Transport layer security (TLS) ను కూడా nginx జోడిస్తుంది. /etc/nginx/sites-available/searxng ను రాయండి.
server {
listen 80;
server_name search.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/searxng /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d search.example.comReload చేయడానికి ముందు nginx -t, syntax is ok మరియు test is successful ను ముద్రిస్తుంది. Certbot అదే file ను తిరిగి రాసి, certificate తో 443 పై listen అయ్యేలా చేస్తుంది. అలాగే port 80 నుంచి redirect ను జోడిస్తుంది. search.example.com కోసం DNS record ఇప్పటికే ఈ server వైపు చూపాలి. Certificate authority HTTP ద్వారా file ను పొందడం ద్వారా ownership ను నిర్ధారిస్తుంది. Renewal తో సహా పూర్తి విధానం Ubuntu 24.04 కోసం Certbot మరియు nginx guide లో ఉంది.
ఈ రెండు forwarding headers కేవలం అలంకారం కావు. X-Forwarded-For మరియు X-Real-IP లేకపోతే, SearXNG కు వచ్చే ప్రతి request లో proxy address ఉంటుంది. అందువల్ల rate limiter మొత్తం traffic ను ఒకే client పంపుతున్నట్లు చూస్తుంది. Visitors ను వేర్వేరుగా గుర్తించలేరు.
స్క్రిప్ట్లు మరియు ఏజెంట్లకు JSON search API ఎందుకు అవసరం
json ను formats లో ఉపయోగించినప్పుడు, పేజీని render చేసే అదే endpoint structured data ను కూడా అందిస్తుంది.
curl -s 'http://127.0.0.1:8080/search?q=wireguard+mtu&format=json' \
| jq -r '.results[0:5][] | .url'మీకు url, title, content మరియు దాన్ని అందించిన engine ఉన్న results array కలిగిన object తిరిగి వస్తుంది. అందులో answers, infoboxes మరియు suggestions కూడా ఉంటాయి. ఇది summariser, link checker లేదా research loop కు నేరుగా data అందించడానికి సరిపోతుంది. ఈ ఫలితాలను language model కు అందించడం కనిపించేదానికంటే పెద్ద దశ. Search results నమ్మదగని text కావడంతో, అవి తమ స్వంత instructions ను కూడా కలిగి ఉండవచ్చు. మీ SearXNG instance వైపు AI agent ను మళ్లించడం అనే అంశం దీనిని వివరంగా పరిశీలిస్తుంది.
Agent ఆధారిత వ్యవస్థలకు ఇది ముఖ్యమైన విషయం. Language model కు training cutoff ఉంటుంది. అందువల్ల ప్రస్తుత విషయాలపై ప్రశ్నలకు సమాధానం ఇవ్వడానికి దీనికి live search అవసరం. Commercial search APIs ప్రతి query కు ఛార్జ్ చేస్తాయి మరియు rate limit ను కఠినంగా అమలు చేస్తాయి. మీరు ఇప్పటికే చెల్లిస్తున్న server పై local instance ను ఒక container గా నడపవచ్చు. Queries ఆ instance ను ఎప్పుడూ దాటి బయటకు వెళ్లవు. Model కు tools ను అనుసంధానిస్తున్నప్పుడు ఇదే కారణంతో VPS పై MCP servers ను నడపడం ఉపయోగకరంగా ఉంటుంది. Search tool సాధారణంగా ప్రజలు ముందుగా జోడించేది.
API ఉపయోగానికి రెండు నియమాలు ఉన్నాయి. Instance ను private గా ఉంచండి. API వైపు loopback address లేదా private network కు bind చేయండి. మీ స్వంత hosts మాత్రమే దాన్ని చేరుకునేలా చేయండి. మీ phone తన స్థానాన్ని report చేసే endpoint కు self-hosted location tracker కు ఇచ్చే రక్షణ కూడా ఇదే. తరువాత queries ను నియంత్రిత వేగంతో పంపండి. SearXNG మీ request ను నిజమైన search engines కు forward చేస్తుంది. అందువల్ల ప్రతి సెకనుకు వంద queries నడిపే script మీ server ను Google block చేయమని అడుగుతున్నట్టే.
పరిమితి వ్యవస్థ మరియు public instance కోసం మార్పులు
పరిమితి వ్యవస్థ SearXNG యొక్క bot రక్షణ. ఇది request headers, addresses మరియు request rates ను పర్యవేక్షించి, automated traffic లా కనిపించే traffic ను తొలగిస్తుంది. ఈ స్థితిని నిల్వ చేయడానికి దీనికి Valkey అవసరం. అందుకే Compose file లో Valkey ఉంటుంది.
Private instance లో limiter: false ను ఉంచండి. మీ scripts స్వభావతః automated traffic అవుతాయి. కాబట్టి instance కోసం మీరు రూపొందించిన JSON calls నే limiter block చేస్తుంది. దానికి బదులుగా access control ను reverse proxy వద్ద నిర్వహించాలి: nginx location లో allow మరియు deny జత, HTTP basic authentication, లేదా మీ ఇతర servers ను మాత్రమే అనుమతించే firewall ఉపయోగించవచ్చు. Networks మధ్య మారే laptop నుంచి private instance ను చేరుకోవాల్సి ఉంటే, దాని ముందు v3 onion address ఉంచడం నాలుగో ఎంపిక. అప్పుడు internet కు కొత్తగా ఏదీ expose చేయకుండా tor అదే loopback port కు connect అవుతుంది.
ఇతర వ్యక్తుల కోసం instance ను public గా అందుబాటులో ఉంచితే, రెండు switches ను on చేయండి.
server:
limiter: true
public_instance: trueమరింత ఖచ్చితమైన నియంత్రణ core-config/limiter.toml లో ఉంటుంది. Container దీనిని /etc/searxng/limiter.toml వద్ద చదువుతుంది. మార్చాలనుకునే keys ను మాత్రమే రాయండి. Proxy వెనుక నడుపుతున్నప్పుడు proxy ను తప్పనిసరిగా declare చేయాలి. లేకపోతే limiter మీ nginx address నే abuse చేస్తున్న client గా పరిగణిస్తుంది.
[botdetection]
trusted_proxies = [
'127.0.0.0/8',
'::1',
]
[botdetection.ip_limit]
link_token = truelink_token = true SearXNG ద్వారా token ను జారీ చేస్తుంది. దాన్ని నిజమైన browser session మాత్రమే పొందుతుంది. దీనివల్ల సాధారణ scrapers లో ఎక్కువ భాగం ఆగిపోతాయి. Public instance ను ప్రారంభించిన కొన్ని రోజుల్లోనే scrapers చేరుతాయని భావించండి. Engine errors కూడా వస్తాయి. మీరు ఎక్కువ traffic ను forward చేస్తే, upstream engines మీ server address కు CAPTCHAs పంపడం త్వరగా ప్రారంభిస్తాయి. Public SearXNG instance నిరంతరం నిర్వహించాల్సిన పని. Private instance కు ఇది అవసరం లేదు. అందుకే 2026 లో self-hosting చేయదగిన విలువైన విషయాల short lists లో private instance ఎక్కువగా ఉంటుంది. ఆ lists లోని ప్రతి అంశం infrastructure కాదు: Jellyfin library ను నడిచి చూడగల 90s rental store గా మళ్లీ నిర్మించడం కూడా అదే nginx block వెనుక ఉన్న ఒకే container ను ఉపయోగిస్తుంది. అయితే అది workflow కంటే ఒక సాయంత్రం అనుభవం కోసం ఉద్దేశించబడుతుంది.
శోధనలకు ఎలాంటి ఫలితాలు రాకపోవడానికి కారణాలు
మీ instanceలో /stats తెరవండి. ఇది ప్రతి engine యొక్క error rate మరియు response time ను చూపిస్తుంది. ఫలితాలు తక్కువగా కనిపించినప్పుడు ముందుగా పరిశీలించాల్సిన స్థలం ఇదే.
"Access denied" లేదా "CAPTCHA" errors గా కనిపించే engine మీ server address ను block చేసింది. Data centre ranges లోని addresses కు ఇది సాధారణం. ఎందుకంటే search engines వాటిని scrapers కు చెందినవిగా భావిస్తాయి. విఫలమైన engine ను మళ్లీ ప్రయత్నించకుండా SearXNG కొంతకాలం suspend చేస్తుంది. అందువల్ల ఒక engine block కావడం మీ results నుంచి నిశ్శబ్దంగా తొలగిపోతుంది. దాన్ని settings.yml లో disable చేయండి లేదా ఆ engine ను కోల్పోవడాన్ని అంగీకరించండి. ఇవే రెండు మార్గాలు కావు. ఎందుకంటే కొన్ని CAPTCHA blocks కు restart తర్వాత కూడా పనిచేసే పరిష్కారం ఉంది. మిగిలిన engines ఇప్పటికీ సమాధానం ఇస్తాయి. 429 అనేది స్పష్టంగా నిర్ధారించలేని పరిస్థితి. అది మీ స్వంత limiter నుంచి రావచ్చు లేదా upstream engine మీ server ను నిరాకరించడం వల్ల రావచ్చు. Settings మార్చడం ప్రారంభించే ముందు మీరు ఎదుర్కొంటున్నది ఈ రెండింటిలో ఏదో log line చెబుతుంది.
ప్రతి engine ఒకేసారి విఫలమైతే, container లో పనిచేసే outbound name resolution లేదు లేదా internet కు route లేదు. దీన్ని container లోపల నుంచే పరీక్షించండి.
docker compose exec core wget -qO- https://duckduckgo.com > /dev/null && echo okఆ పరీక్ష విఫలమవడం ప్రారంభించినప్పుడు box లోని ఏదీ మీకు తెలియజేయదు. అందువల్ల దాన్ని cron నుంచి అమలు చేయండి. Results తక్కువగా కనిపించే వరకు వేచి ఉండకుండా, failure ను మీ స్వంత ntfy server నుంచి మీ phone కు alert పంపేలా చేయండి.
FAQ
SearXNG నా శోధనలను అనామకంగా చేస్తుందా?
ఇది శోధన అభ్యర్థనలను స్వీకరించే engines నుంచి మీ గుర్తింపును దాచుతుంది. ఎందుకంటే అభ్యర్థన మీ browser నుంచి కాకుండా మీ server నుంచి వచ్చినట్లు engines కు కనిపిస్తుంది. అయితే ఇది మీ server నుంచి query ను దాచదు. మీ server ను engines నుంచి కూడా దాచదు. Single-user instance లో ఆ address నుంచి వచ్చే మొత్తం traffic మీదే ఉంటుంది. అందువల్ల addressనే identifierగా ఉపయోగించవచ్చు. మీ browser మరియు instance మధ్య traffic TLS certificate ద్వారా రక్షించబడుతుంది. మీ ISP, public instance operator మరియు engines విషయంలో వాస్తవంగా ఏ సమాచారం దాచబడుతుందో SearXNG వాస్తవంగా ఏం దాచుతుంది లో వివరించారు.
JSON అభ్యర్థనకు 403 Forbidden ఎందుకు వస్తుంది?
దీనికి రెండు కారణాలు ఉన్నాయి. రెండూ configurationకు సంబంధించినవే. settings.yml లోని search: కింద ఉన్న formats జాబితాలో json లేకపోవచ్చు. ఇదే default state. లేదా limiter ఆన్లో ఉండి మీ scriptను botగా గుర్తించి ఉండవచ్చు. ముందుగా formatను జోడించండి. docker compose restart core తో restart చేసి, మళ్లీ ప్రయత్నించండి. ఇంకా విఫలమైతే limiter: false సెట్ చేసి, reverse proxy వద్ద accessను నియంత్రించండి.
Limiterను offలో ఉంచితే Valkey container అవసరమా?
దాన్ని runningలో ఉంచండి. SearXNG అది లేకుండానూ పనిచేస్తుంది. కానీ దాని లేకుండా limiterను తరువాత ఆన్ చేయలేరు. ఇది ఇతర స్వల్పకాలిక stateను కూడా నిల్వ చేస్తుంది. Container చిన్నదిగా ఉంటుంది. ఇది cached dataను మాత్రమే నిల్వ చేస్తుంది. కాబట్టి దాన్ని తొలగించడం వల్ల చాలా తక్కువ ప్రయోజనం ఉంటుంది. దానికి బదులుగా ఆ ఎంపికను కోల్పోతారు.
SearXNGను ఎలా update చేయాలి?
/opt/searxng లో docker compose pull తరువాత docker compose up -d అమలు చేయండి. Image మారిన ప్రతి containerను Compose మళ్లీ సృష్టిస్తుంది. మీ core-config/ directoryను మార్చదు. అందువల్ల settings.yml అలాగే ఉంటుంది. use_default_settings: true మీ keysను shipped defaultsపై merge చేస్తుంది. కాబట్టి upstreamలో జోడించిన options సరైన default valuesతో వస్తాయి. File విరిగిపోదు.
ఒకే instanceను పలువురు పంచుకోవచ్చా?
అవును. ఆ సందర్భంలో limiterను ఆన్ చేసి public_instance: true సెట్ చేయాలి. Preferences ప్రతి visitorకి చెందిన browserలోనే నిల్వ అవుతాయి. కాబట్టి accountsను నిర్వహించాల్సిన అవసరం లేదు. Instanceను అందుబాటులోకి తెచ్చిన తరువాత ఒక వారం పాటు /stats ను monitor చేయండి. Missing results మీకు కనిపించకముందే upstream engines మీ serverను తిరస్కరించడం ప్రారంభించవచ్చు.