SearXNGのデプロイ
Docker ComposeとNginxを使用してセルフホスト型SearXNGメタ検索エンジンをデプロイする。
使用タイミング
- プライベートなセルフホスト型検索エンジンのセットアップ
- トラッキングなしで複数検索プロバイダーからの結果を集約
- チームや組織向けの検索インスタンスの運用
- 単一検索プロバイダーへの依存の排除
入力
- 必須: Dockerがインストールされたサーバーまたはマシン
- 任意: パブリックアクセス用ドメイン名
- 任意: SSL証明書またはLet's Encryptのセットアップ
- 任意: カスタムエンジンの設定
手順
ステップ1: プロジェクト構造の作成
mkdir -p searxng/{config,nginx}
cd searxng
ステップ2: Docker Composeファイルの作成
docker-compose.yml:
services:
searxng:
image: searxng/searxng:latest
container_name: searxng
volumes:
- ./config:/etc/searxng:rw
environment:
- SEARXNG_BASE_URL=https://search.example.com/
cap_drop:
- ALL
cap_add:
- CHOWN
- SETGID
- SETUID
restart: unless-stopped
networks:
- searxng
nginx:
image: nginx:1.27-alpine
container_name: searxng-nginx
ports:
- "8080:80"
volumes:
- ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
depends_on:
- searxng
restart: unless-stopped
networks:
- searxng
networks:
searxng:
driver: bridge
ステップ3: SearXNG設定の構成
config/settings.yml:
use_default_settings: true
general:
instance_name: "My SearXNG"
privacypolicy_url: false
contact_url: false
search:
safe_search: 0
autocomplete: "google"
default_lang: "en"
server:
secret_key: "generate-a-random-secret-key-here"
limiter: true
image_proxy: true
port: 8080
bind_address: "0.0.0.0"
ui:
static_use_hash: true
default_theme: simple
infinite_scroll: true
engines:
- name: google
engine: google
shortcut: g
disabled: false
- name: duckduckgo
engine: duckduckgo
shortcut: ddg
disabled: false
- name: wikipedia
engine: wikipedia
shortcut: wp
disabled: false
- name: github
engine: github
shortcut: gh
disabled: false
- name: stackoverflow
engine: stackoverflow
shortcut: so
disabled: false
- name: arxiv
engine: arxiv
shortcut: arx
disabled: false
シークレットキーの生成:
openssl rand -hex 32
ステップ4: Nginxフロントエンドの設定
nginx/nginx.conf:
events {
worker_connections 1024;
}
http {
server {
listen 80;
location / {
proxy_pass http://searxng: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;
proxy_set_header Connection "";
proxy_buffering off;
}
location /static/ {
proxy_pass http://searxng:8080/static/;
expires 1y;
add_header Cache-Control "public, immutable";
}
}
}
ステップ5: レート制限の設定
config/limiter.toml:
[botdetection.ip_limit]
link_token = true
[botdetection.ip_lists]
block_ip = []
pass_ip = ["127.0.0.1/8", "::1/128"]
pass_searxng_org = false
ステップ6: デプロイと検証
# Start the stack
docker compose up -d
# Check logs
docker compose logs -f searxng
# Verify it's running
curl -s http://localhost:8080 | head -5
# Test a search
curl -s "http://localhost:8080/search?q=test&format=json" | head -20
期待結果: SearXNGがNginx経由でポート8080で応答する。検索クエリが集約された結果を返す。
失敗時: docker compose logs searxngで設定エラーを確認する。settings.ymlのYAML構文を検証する。
ステップ7: SSLの追加(本番環境)
パブリックデプロイにはSSL終端を追加する。docker-compose.ymlを更新する:
services:
nginx:
ports:
- "80:80"
- "443:443"
volumes:
- ./nginx/nginx-ssl.conf:/etc/nginx/nginx.conf:ro
- certbot-certs:/etc/letsencrypt:ro
- certbot-webroot:/var/www/certbot:ro
certbot:
image: certbot/certbot
volumes:
- certbot-certs:/etc/letsencrypt
- certbot-webroot:/var/www/certbot
volumes:
certbot-certs:
certbot-webroot:
完全なSSL Nginx設定についてはconfigure-nginxスキルを参照。
ステップ8: 更新とメンテナンス
# Pull latest image
docker compose pull searxng
# Restart with new image
docker compose up -d
# Backup configuration
cp -r config/ config-backup-$(date +%Y%m%d)/
バリデーション
- SearXNGがログにエラーなく起動する
- 検索クエリが設定されたエンジンからの結果を返す
- イメージプロキシが動作する(画像がSearXNG経由で読み込まれる)
- レート制限が過剰なリクエストをブロックする
- 設定がコンテナ再起動間で永続化される
- Nginxがリクエストを正しくプロキシする
よくある落とし穴
- secret_keyの不足: SearXNGはsettings.ymlに
secret_keyがないと起動を拒否する - 設定の権限: SearXNGは設定ディレクトリに書き込む。ボリュームは
:roではなく:rwでなければならない - エンジンのブロック: 一部のエンジンがサーバーIPからのリクエストをブロックする場合がある。エンジンをローテーションするかイメージプロキシを使用する
- YAMLインデント:
settings.ymlはインデントに敏感。デプロイ前にYAMLリンターで検証する - ベースURLの不一致:
SEARXNG_BASE_URLはユーザーがアクセスする実際のURLと一致する必要がある(プロトコルと末尾スラッシュを含む) - DockerでのDNS解決: Google/Bingを使用するエンジンにはホストネットワークまたは適切なDNSが必要な場合がある。デフォルトのDocker DNSは通常動作する
関連スキル
setup-compose-stack- ここで使用される一般的なDocker Composeパターンconfigure-nginx- SSLとセキュリティヘッダー用のNginx設定configure-reverse-proxy- Nginxフロントエンド用の高度なプロキシパターン