What is SearXNG and how does it work?

SearXNG is a privacy-focused metasearch engine that queries multiple sources and aggregates the results, without tracking users. You can use a public instance or self-host for full control over engines, filters, and privacy settings.

How do I self-host SearXNG with Docker?

Create a Docker Compose service using the official image, set a strong secret key, and expose it behind a reverse proxy with HTTPS. Edit `settings.yml` to enable engines, configure categories, and adjust privacy options.

Can I use SearXNG for programmatic searches via API?

Yes. Call `/search` with parameters like `q`, `categories`, and `format=json` to receive JSON results for automations and apps. This is ideal for research pipelines and internal tools.

How do I choose a safe public SearXNG instance?

Look for active, reputable instances with clear privacy statements, good uptime, and minimal captchas. You can also switch instances or self-host if you encounter rate limits or reliability issues.

Which search operators work in SearXNG?

Common operators like quotes, `site:`, `filetype:`, `inurl:`, and `intitle:` generally work and are passed to underlying engines. You can also use bang shortcuts (e.g., `!g`, `!ddg`, `!yt`) if the instance supports them.

SearXNG Nasıl Kullanılır: İlk Aramadan Kendi Kendine Hosting Uzmanlığına

Eğer Google benzeri sonuçları izlenme olmadan istiyorsanız, SearXNG gizliliğe öncelik veren bir meta arama motorudur. Sizi profillemeden, düzinelerce kaynaktan sonuçları toplar ve filtreler, motorlar ve hatta hosting üzerinde tam kontrol sağlar. Bu kılavuzda üç yolu inceleyeceğiz: genel bir örneği kullanmak, arama deneyiminizi özelleştirmek ve maksimum kontrol için kendi özel SearXNG'nizi dağıtmak.

Bunu uygulanabilir kılmak için, uygulamalı adımlar, kopyalayabileceğiniz ayarlar ve kaçınılması gereken yaygın tuzaklarla pratik ve çözüm odaklı bir yaklaşım benimseyeceğiz.

SearXNG Nedir ve Neden Kullanılır?

SearXNG, açık kaynaklı bir meta arama motorudur. Web'i kendisi taramak yerine, diğer arama motorlarını sorgular ve sonuçları birleşik bir arayüzde sunar. Buradaki püf noktası: izlemeyi bırakır, reklamları kaldırır (çoğu örnekte) ve hangi motorların dahil edileceği, hangi kategorilerin aranacağı (web, resimler, videolar, dosyalar, BT, haberler, bilim) ve sonuçların nasıl sunulacağı üzerinde ince ayar yapmanızı sağlar.

Varsayılan olarak izleme veya profilleme yok

Yapılandırılabilir motorlar ve kategoriler

Tam kontrol için kendi kendine barındırılabilir

Geliştiriciler ve otomasyonlar için API dostu.

Hızlı Başlangıç: Genel Bir SearXNG Örneği Kullanmak

Genel bir örnekle (gönüllüler tarafından çalıştırılan bir SearXNG sunucusu) başlayabilirsiniz. Tipik akış:

Güvenilir bir genel örnek açın ("SearXNG örnekleri listesi" veya aktif, saygın sunucuları bulmak için topluluk başlıklarını arayın). Çalışma süresini, oran sınırlarını ve gizlilik bildirimlerini değerlendirin.

Sorgunuzu yazın ve üstteki sekmeler aracılığıyla kategorileri (örneğin, Web, Resimler, Haberler) seçin.

Şunları ayarlamak için Tercihler'i (dişli simgesi) kullanın:

Arayüz dili

Güvenli Arama düzeyi

Varsayılan kategoriler

UI teması ve sonsuz kaydırma

"Bangs" ve operatörleri kullanın:

!g sorgunuz, Google motorunu zorlar (o örnekte etkinse)

Örnek yapılandırmasına bağlı olarak !ddg, !bing, !yt, !wp vb.

Tırnak işaretleri, site:, filetype:pdf, inurl:, intitle: gibi standart operatörler birçok motorda çalışır

Favori örneğinizi yer imlerine ekleyin ve UI tarafından destekleniyorsa Tercihleri bir JSON blobu olarak dışa/içe aktarın.

Profesyonel ipucu: Genel örnekler, kendilerini kötüye kullanımdan korumak için anonim kullanıcıları oran sınırlayabilir. Captcha veya yavaşlama görürseniz, başka bir örnek deneyin veya kendi kendinize barındırın.

Arayüzde Güçlü Kullanıcı Hareketleri

Motorları anında değiştirin: Tercihler → Motorlar'da, kategori başına belirli kaynakları açıp kapatın.

Sonuçları ayarlayın: Yinelenenleri gizleyin, zaman aralığını değiştirin (örneğin, geçen yıl), alaka düzeyine veya tarihe göre sıralayın.

Gizlilik geçişleri: Sorgulanmasını istemediğiniz herhangi bir motoru devre dışı bırakın. Bazı motorlar API anahtarları gerektirir; yoksa, basitçe kullanılmazlar.

Klavye kısayolları: Birçok SearXNG teması, arama kutusuna odaklanmak için / ve sonuçlarda gezinmek için ok tuşlarını destekler.

SearXNG'yi Kendiniz Nasıl Barındırırsınız (Docker Yolu)

Kendi kendine hosting, hangi motorların kullanılacağı üzerinde güvenilirlik, hız ve kontrol sağlar. Docker yolu en basitidir.

Gereksinimler

Bir Linux VPS veya bir ev sunucusu (hafif kullanım için 2 vCPU/2 GB RAM yeterlidir)

Docker ve Docker Compose kurulu

HTTPS için bir alan/alt alan adı ve isteğe bağlı ters proxy (Caddy/Traefik/Nginx)

Adımlar

SearXNG dağıtım deposunu klonlayın (veya minimal bir Compose dosyası kullanın):

version: "3.8"
services:
searxng:
image: searxng/searxng:latest
container_name: searxng
environment:
- BASE_URL=
- SEARXNG_SECRET_KEY=change_me_to_a_long_random_value
volumes:
- ./searxng:/etc/searxng
ports:
- "8080:8080"
restart: unless-stopped

Güçlü bir SEARXNG_SECRET_KEY oluşturun (örneğin, openssl rand -hex 32).

Hizmeti başlatın:

docker compose up -d

HTTPS ile ters proxy'yi yapılandırın (Caddy örneği):

search.example.com {
reverse_proxy 127.0.0.1:8080
}

Caddy, Let's Encrypt aracılığıyla TLS'yi otomatik olarak sağlayacaktır.

` adresini ziyaret edin ve yüklendiğini onaylayın.

Çekirdek Yapılandırma: `settings.yml`

İlk çalıştırmadan sonra, bağlı biriminiz altında bir yapılandırmanız olacak (örneğin, ./searxng/settings.yml). Ana bölümler:

general: ad, hata ayıklama modu, sonuç sayısı

server: gizli anahtar, bağlama adresi, oran sınırları

engines: motorları etkinleştirme/devre dışı bırakma, kategoriler, zaman aşımları

ui: tema, sonsuz kaydırma, otomatik tamamlama

search: güvenli arama varsayılanları, dil, yerel ayar

Örnek snippet:

general:
instance_name: "My Private SearXNG"
server:
secret_key: "<same as env or longer>"
image_proxy: true
rate_limit: "60/minute"
search:
safe_search: 1 # 0 off, 1 moderate, 2 strict
autocomplete: "duckduckgo"
ui:
default_theme: "simple"
infinite_scroll: true
engines:
- name: duckduckgo
engine: duckduckgo
categories: .
### Quick Example
- Endpoint: `/search`
- Methods: GET or POST
- Parameters: `q` (query), `categories`, `language`, `format=json`, `time_range`, `safesearch`
```bash
curl "

Yanıt, organik sonuçları, kullanılan motorları ve zamanlamaları içerir. Araştırma otomasyonları, yerel panolar ve özel UI'lar oluşturmak için harika.

Motorları ve Kategorileri Ayarlama

Hızlı, gizlilik dostu kaynakları tercih edin (örneğin, Wikipedia, Stack Exchange, MDN, DuckDuckGo, izin verilirse Brave, YouTube/Reddit/Mastodon için resmi API'ler).

Ağınızda sık sık captcha veya yüksek gecikme süresi olan motorları devre dışı bırakın.

Kategori başına varsayılanları kullanın; örneğin, “BT” altında GitHub, Stack Overflow ve PyPI'yi etkinleştirin, “Bilim” altında arXiv/Crossref'i etkinleştirin ve “Haberler” için time_range'i en son olarak ayarlayın.

Sorun Giderme Kontrol Listesi

Captcha veya boş sonuçlar mı görüyorsunuz? Bloklara neden olan motorları azaltın veya döndürün; zaman aşımlarını biraz artırın; önbelleğe almayı etkinleştirin.

API istekleri başarısız mı oluyor? Ters proxy başlıklarını ve CORS'u kontrol edin; format=json'ı onaylayın.

UI yavaş mı? Sayfa başına sonuç sayısını azaltın; ağır motorları devre dışı bırakın; Redis önbelleğini etkinleştirin.

Docker yeniden başlatma döngüsü mü? settings.yml sözdizimini ve ortam değişkenlerinizi doğrulayın.

Ekipler ve Güçlü Kullanıcılar İçin En İyi Uygulamalar

Değişiklikleri izlemek için settings.yml dosyanızı (sırlar olmadan) dışa aktarın ve sürüm kontrolüne alın.

API anahtarları için sır yöneticileri veya .env dosyaları kullanın.

Motor değişikliklerinden haberdar olmak için haftalık konteyner yenilemeleri planlayın.

Motor hataları veya oran limiti isabetleri için günlükleri izleyin.

SearXNG'yi uygulamalara yerleştirirseniz, yasaklardan kaçınmak için yeniden denemelerde geri çekilin ve gecikmeleri rastgele hale getirin.

İsteğe bağlı: SearXNG'yi Diğer Araçlara Bağlayın

Araştırma not defterlerinizde veya sohbet iş akışlarınızda JSON API'sini kullanın.

Gizliliği korumak için uygulama tabanlı web aramayı özel örneğiniz üzerinden yönlendirin.

Bazı AI/web UI'ları, kendi uç noktanız üzerinden göz atmak için SearXNG'ye bağlanabilir (temel URL'yi ve API parametrelerini buna göre yapılandırın).

Belirtmekte fayda var: Eğer araştırma iş akışları hazırlıyor veya sonuçları ölçekte özetliyorsanız, Sider.AI gibi bir araç, birden fazla sekme veya sorgu genelinde okuma ve özetleme adımını kolaylaştırabilir. Gözatmanızı özel bir SearXNG uç noktasına yönlendirebilir, ardından içgörüleri yakalamak, özetler hazırlamak veya alıntıları otomatik olarak derlemek için Sider.AI'yı kullanabilirsiniz; bu da art arda birçok arama yaptığınızda zaman kazandırır.

Güvenlik ve Etik

Etkinleştirdiğiniz motorların şartlarına uyun.

Örneğinizin genel istismara maruz kalmasına izin vermeyin; oran sınırlayın ve gerekirse erişimi kısıtlayın.

Ekip üyelerini gizlilik beklentileri hakkında bilgilendirin; günlükler, IP'leri veya sorguları depolamaktan kaçınmak için yapılandırılabilir.

İlk 15 Dakikalık Kurulumunuz: Mini Bir Kontrol Listesi

Docker'ı başlatın ve bir Compose dosyası oluşturun

SEARXNG_SECRET_KEY'i ayarlayın

Konteyneri başlatın ve :8080'in çalıştığını onaylayın

Bir proxy ile HTTPS'nin arkasına koyun

Güvendiğiniz motorları etkinleştirmek için settings.yml dosyasını düzenleyin

Varsayılan kategorileri ve Güvenli Aramayı ayarlayın

Bir curl isteğiyle API'yi test edin

Örneğinizi yer imlerine ekleyin ve ekibinizle paylaşın

Temel Çıkarımlar

SearXNG, bir web tarayıcısı yazmadan size gizlilik, kontrol ve esneklik sağlar.

Önce genel bir örnekte başlayın, ardından güvenilirlik ve özelleştirme için kendi kendinize barındırın.

Hız ve alaka düzeyi için motorları ve kategorileri ayarlayın.

JSON API, SearXNG'yi araştırma ve otomasyon için ideal hale getirir.

HTTPS, oran sınırları ve minimum günlük kaydı ile dağıtımınızı güçlendirin.

Referanslar ve İleri Okuma

Parametreler ve biçimler için resmi Arama API'si genel bakışı.

Adım adım kendi kendine hosting kılavuzları ve topluluk eğitimleri, Docker ve Windows kurulumları için yardımcı olabilir.

SearXNG'yi uygulama iş akışlarına ve araçlarına entegre etmek genellikle yukarıda kullanılan aynı API modelini izler.

SSS

S1: SearXNG nedir ve nasıl çalışır? SearXNG, kullanıcıları izlemeden birden çok kaynağı sorgulayan ve sonuçları toplayan, gizliliğe odaklı bir meta arama motorudur. Motorlar, filtreler ve gizlilik ayarları üzerinde tam kontrol için genel bir örnek kullanabilir veya kendi kendinize barındırabilirsiniz.

S2: SearXNG'yi Docker ile nasıl kendi kendime barındırabilirim? Resmi görüntüyü kullanarak bir Docker Compose hizmeti oluşturun, güçlü bir gizli anahtar ayarlayın ve HTTPS ile bir ters proxy'nin arkasında yayınlayın. Motorları etkinleştirmek, kategorileri yapılandırmak ve gizlilik seçeneklerini ayarlamak için settings.yml dosyasını düzenleyin.

S3: API aracılığıyla programatik aramalar için SearXNG'yi kullanabilir miyim? Evet. Otomasyonlar ve uygulamalar için JSON sonuçları almak üzere q, categories ve format=json gibi parametrelerle /search'ü çağırın. Bu, araştırma boru hatları ve iç araçlar için idealdir.

S4: Nasıl güvenli bir genel SearXNG örneği seçerim? Açık gizlilik bildirimleri, iyi çalışma süresi ve minimum captcha ile aktif, saygın örnekler arayın. Oran sınırlarıyla veya güvenilirlik sorunlarıyla karşılaşırsanız, örnekleri değiştirebilir veya kendi kendinize barındırabilirsiniz.

S5: SearXNG'de hangi arama operatörleri çalışır? Tırnak işaretleri, site:, filetype:, inurl: ve intitle: gibi yaygın operatörler genellikle çalışır ve temel motorlara geçirilir. Örnek bunları destekliyorsa, bang kısayollarını da (örneğin, !g, !ddg, !yt) kullanabilirsiniz.