Desplegar SearXNG

Desplegar un metabuscador SearXNG auto-alojado con Docker y configuración personalizada.

Cuándo Usar

• Necesitando un metabuscador privado sin rastreo
• Queriendo agregar resultados de múltiples motores de búsqueda
• Desplegando una alternativa auto-alojada a buscadores comerciales
• Requiriendo búsqueda personalizable para un equipo u organización
• Integrando búsqueda privada con otras herramientas (MCP, API)

Entradas

• Requerido: Servidor con Docker y Docker Compose instalados
• Requerido: Nombre de dominio (para acceso externo) o acceso localhost
• Opcional: Certificados TLS para HTTPS
• Opcional: Configuración de motores de búsqueda preferidos
• Opcional: Personalización de interfaz (tema, idioma)

Procedimiento

Paso 1: Configurar Estructura del Proyecto

mkdir -p searxng/{config,data}
cd searxng

Crear

docker-compose.yml

:

version: '3.8'

services:
  searxng:
    image: searxng/searxng:latest
    container_name: searxng
    ports:
      - "8080:8080"
    volumes:
      - ./config:/etc/searxng:rw
      - ./data:/var/log/searxng:rw
    environment:
      - SEARXNG_BASE_URL=https://busqueda.ejemplo.com/
      - SEARXNG_SECRET_KEY=clave_secreta_larga_y_aleatoria
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETGID
      - SETUID
    restart: unless-stopped

Esperado: Estructura de directorios creada, docker-compose.yml configurado.

En caso de fallo: Verificar permisos de escritura en los directorios, asegurar que Docker está instalado.

Paso 2: Configurar SearXNG

Crear

config/settings.yml

:

use_default_settings: true

general:
  debug: false
  instance_name: "Mi Buscador"

search:
  safe_search: 0
  autocomplete: "google"
  default_lang: "es"

server:
  secret_key: "clave_secreta_larga_y_aleatoria"
  bind_address: "0.0.0.0"
  port: 8080
  limiter: true

ui:
  default_theme: simple
  default_locale: es
  query_in_title: 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

Esperado: SearXNG configurado con motores de búsqueda, idioma predeterminado, y seguridad.

En caso de fallo: Validar sintaxis YAML, verificar que el secret_key es único y largo.

Paso 3: Configurar Proxy Inverso (Opcional)

Para acceso externo con HTTPS, configurar Nginx:

server {
    listen 443 ssl http2;
    server_name busqueda.ejemplo.com;

    ssl_certificate /etc/ssl/certs/cert.pem;
    ssl_certificate_key /etc/ssl/private/key.pem;

    location / {
        proxy_pass http://localhost: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;

        # Limitar acceso (opcional)
        # allow 192.168.0.0/16;
        # deny all;
    }
}

Esperado: SearXNG accesible vía HTTPS a través de Nginx.

En caso de fallo: Verificar certificados TLS, comprobar que Nginx puede resolver el upstream.

Paso 4: Iniciar y Verificar

# Iniciar SearXNG
docker compose up -d

# Verificar estado
docker compose ps
docker compose logs searxng

# Probar búsqueda
curl "http://localhost:8080/search?q=test&format=json"

Esperado: SearXNG ejecutándose y respondiendo a consultas de búsqueda.

En caso de fallo: Revisar logs del contenedor, verificar configuración de motores de búsqueda, comprobar conectividad de red.

Validación

• SearXNG se inicia sin errores
• La interfaz web es accesible y funcional
• Las búsquedas devuelven resultados de múltiples motores
• El idioma predeterminado es el configurado
• Las capacidades de seguridad están limitadas (cap_drop: ALL)
• HTTPS funciona a través del proxy inverso (si está configurado)

Errores Comunes

• Secret key débil o predeterminada: Usar una clave aleatoria larga. SearXNG rechaza claves débiles.
• Rate limiting de motores: Los motores de búsqueda pueden bloquear IPs con muchas solicitudes. Habilitar el limiter integrado.
• Motores deshabilitados silenciosamente: Algunos motores requieren configuración adicional. Verificar en la página de preferencias.
• Permisos de directorio: Los directorios montados deben ser escribibles por el usuario del contenedor.
• Base URL incorrecta: Debe coincidir exactamente con la URL de acceso, incluyendo el protocolo y la barra final.

Habilidades Relacionadas

• configure-nginx

  - Configuración detallada de Nginx como proxy

• configure-reverse-proxy

  - Patrones de proxy inverso con Traefik

• setup-compose-stack

  - Stacks Docker Compose multi-servicio