Instalación de SearX

Instalación de software — paso a paso

Instalaremos SearXNG utilizando Docker Compose. Este enfoque proporciona aislamiento de la aplicación, simplifica la gestión de dependencias y facilita las actualizaciones. Para 2026, Docker y Docker Compose son el estándar de facto para el despliegue de muchos servicios web.

1. Instalación de Docker Engine y Docker Compose

Primero, instalaremos los componentes necesarios de Docker. Utilizaremos los repositorios oficiales de Docker para obtener las versiones más recientes.

# Actualización del índice de paquetes (actualizado para 2026)
sudo apt update

# Instalación de paquetes necesarios para usar el repositorio de Docker a través de HTTPS
sudo apt install -y ca-certificates curl gnupg

# Añadir la clave GPG oficial de Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Añadir el repositorio de Docker a las fuentes de APT
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Actualizar el índice de paquetes después de añadir el repositorio de Docker
sudo apt update

# Instalación de Docker Engine, Docker CLI y Docker Compose (versiones actuales para 2026)
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Añadir el usuario actual al grupo docker para trabajar con Docker sin sudo
sudo usermod -aG docker $USER

# Aplicar cambios para el grupo docker (es necesario volver a iniciar sesión o ejecutar newgrp docker)
newgrp docker

# Verificar la instalación de Docker
docker run hello-world

El comando docker run hello-world debería mostrar un mensaje de bienvenida, confirmando la instalación exitosa de Docker.

2. Creación de directorio para SearXNG y configuración

Crearemos un directorio de trabajo para SearXNG, donde se almacenarán todos los archivos de configuración y Docker Compose.

mkdir ~/searxng
cd ~/searxng

3. Creación del archivo docker-compose.yml

Cree el archivo docker-compose.yml. Este archivo definirá cómo Docker debe ejecutar SearXNG.

nano docker-compose.yml

Pegue el siguiente contenido. Esta es una configuración básica que utiliza la imagen oficial de SearXNG y el servidor proxy Caddy para HTTPS.

version: '3.8'

services:
  searxng:
    image: searxng/searxng:latest # Versión actual de SearXNG para 2026
    container_name: searxng
    ports:
      - "8080:8080" # SearXNG estará disponible en el puerto 8080 dentro del contenedor
    volumes:
      - ./searxng_settings.yml:/etc/searxng/settings.yml:ro # Montamos nuestra configuración
      - ./data/searxng:/data # Directorio para los datos y la caché de SearXNG
    environment:
      - SEARXNG_BASE_URL=https://ВАШ_ДОМЕН_ДЛЯ_SEARXNG/ # Reemplace con su dominio
      - SEARXNG_URL=http://searxng:8080/ # URL interna para Caddy
    restart: unless-stopped
    networks:
      - searxng_network

  caddy:
    image: caddy:2-alpine # Versión actual de Caddy para 2026
    container_name: caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro # Montamos nuestra configuración de Caddy
      - ./data/caddy:/data # Directorio para los datos de Caddy (certificados Let's Encrypt)
    environment:
      - CADDY_EMAIL=ВАШ[email protected] # Email para Let's Encrypt
    restart: unless-stopped
    networks:
      - searxng_network

networks:
  searxng_network:
    driver: bridge

Importante: Reemplace ВАШ_ДОМЕН_ДЛЯ_SEARXNG con su dominio real (por ejemplo, searx.mydomain.com) y ВАШ[email protected] con su dirección de correo electrónico para recibir notificaciones de Let's Encrypt.

4. Configuración del archivo searxng_settings.yml

SearXNG tiene muchas configuraciones que se pueden modificar en el archivo settings.yml. Para empezar, crearemos un archivo base.

nano searxng_settings.yml

Pegue el siguiente contenido mínimo. Para obtener una lista completa de configuraciones, consulte la documentación oficial de SearXNG.

# searxng_settings.yml - Ejemplo de configuración básica

# Configuraciones generales
debug: False
limiter: True # Habilitar limitación de velocidad de solicitudes
user_agent: 'SearXNG/1.3' # Ejemplo de user-agent, actual para 2026

# Configuraciones de privacidad
no_cookie_tracking: True
no_session_tracking: True
no_result_urls_tracking: True

# Configuraciones de motores (ejemplo - los principales están habilitados)
# Para la lista completa y configuración, consulte https://docs.searxng.org/admin/settings.html#engines
engines:
  - google
  - duckduckgo
  - bing
  - wikipedia
  - startpage
  - yandex

# Configuraciones de interfaz (opcional)
# theme: simple
# autocomplete: 'duckduckgo'

# Opciones adicionales
# image_proxy: True
# timezone: 'Europe/Moscow'

# Clave secreta para proteger sesiones (¡DEBE GENERAR LA SUYA PROPIA!)
secret_key: "GENERE_SU_PROPIA_CLAVE_SECRETA"

Muy importante: Reemplace "GENERE_SU_PROPIA_CLAVE_SECRETA" con una cadena aleatoria. Puede generarla, por ejemplo, así:

python3 -c 'import secrets; print(secrets.token_hex(32))'

Copie la cadena resultante y péguela en searxng_settings.yml.

5. Creación del archivo Caddyfile

Caddy actuará como un proxy inverso, redirigiendo las solicitudes a SearXNG y configurando automáticamente HTTPS con Let's Encrypt.

nano Caddyfile

Pegue el siguiente contenido:

ВАШ_ДОМЕН_ДЛЯ_SEARXNG {
    # Reemplace con su dominio, por ejemplo, searx.mydomain.com
    # Caddy obtendrá automáticamente un certificado SSL de Let's Encrypt

    reverse_proxy searxng:8080 {
        # Redirige las solicitudes al contenedor SearXNG
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }

    # Encabezados adicionales para seguridad (recomendado)
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains"
        X-Frame-Options DENY
        X-Content-Type-Options nosniff
        X-XSS-Protection "1; mode=block"
        Referrer-Policy no-referrer-when-downgrade
    }

    # Registro (opcional)
    log {
        output file /data/access.log {
            roll_size 10mb
            roll_keep 5
            roll_keep_for 720h
        }
        format json
    }
}

Importante: Reemplace ВАШ_ДОМЕН_ДЛЯ_SEARXNG con su dominio real. Asegúrese de que el registro DNS (tipo A) para este dominio apunte a la dirección IP de su VPS. Sin un registro DNS correcto, Caddy no podrá obtener un certificado SSL.

6. Ejecución de SearXNG con Docker Compose

Una vez creados todos los archivos necesarios, puede iniciar SearXNG.

# Creación de directorio para datos de Caddy y SearXNG
mkdir -p data/caddy data/searxng

# Iniciar contenedores en segundo plano
docker compose up -d

# Verificar el estado de los contenedores en ejecución
docker compose ps

El comando docker compose ps debería mostrar que los contenedores searxng y caddy están en ejecución y en estado Up. Si Caddy no se inicia inmediatamente, dele unos minutos para obtener el certificado de Let's Encrypt. Puede verificar los registros de Caddy si surgen problemas:

docker compose logs caddy

Ahora su metabuscador privado SearXNG debería estar accesible a través de su nombre de dominio mediante HTTPS.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son cruciales para el funcionamiento estable y seguro de cualquier servicio, incluido SearXNG. Aunque SearXNG en sí mismo no almacena datos confidenciales del usuario (ya que es un motor de búsqueda privado), es importante guardar su configuración y los datos de Caddy (certificados Let's Encrypt) para evitar la reconfiguración en caso de fallo.

1. Qué hacer copia de seguridad

Para SearXNG en Docker Compose, los elementos principales que requieren copia de seguridad son:

• Archivos de configuración de SearXNG: searxng_settings.yml. Este es el archivo principal que define el comportamiento de su motor de búsqueda.
• Archivos de Docker Compose: docker-compose.yml. Define cómo iniciar SearXNG y Caddy.
• Archivos de configuración de Caddy: Caddyfile. Contiene la configuración de su proxy inverso y HTTPS.
• Datos de Caddy: El directorio ./data/caddy (en nuestro caso ~/searxng/data/caddy). Aquí se almacenan los certificados de Let's Encrypt y otra información de servicio de Caddy.
• Datos de SearXNG: El directorio ./data/searxng (en nuestro caso ~/searxng/data/searxng). Puede contener caché, registros y otros datos temporales de SearXNG.

Los datos del usuario no se copian, ya que SearXNG no los almacena.

2. Script simple de copia de seguridad automática

Crearemos un script simple que archivará todos los archivos y directorios necesarios. Como herramienta de copia de seguridad, se puede usar tar para archivar y rsync para sincronizar con un almacenamiento remoto. Para escenarios más avanzados, se pueden considerar borgbackup o restic, que admiten la deduplicación y el cifrado.

Cree un archivo de script, por ejemplo, backup_searxng.sh, en su directorio de inicio:

nano ~/backup_searxng.sh

Pegue el siguiente contenido:

#!/bin/bash

# Ruta al directorio de SearXNG
SEARXNG_DIR="/home/searxng_admin/searxng" # Reemplace con la ruta a su directorio de SearXNG
BACKUP_DIR="/var/backups/searxng"
TIMESTAMP=$(date +"%Y%m%d%H%M%S")
BACKUP_FILE="$BACKUP_DIR/searxng_backup_$TIMESTAMP.tar.gz"
RETENTION_DAYS=7 # Mantener copias de seguridad de los últimos 7 días

# Creación del directorio para copias de seguridad, si no existe
mkdir -p "$BACKUP_DIR"

echo "Iniciando la copia de seguridad de SearXNG en $BACKUP_FILE..."

# Detener SearXNG para la consistencia de los datos (opcional, pero recomendado para datos de caddy/searxng)
# docker compose -f "$SEARXNG_DIR/docker-compose.yml" stop

# Archivando los archivos y directorios necesarios
tar -czf "$BACKUP_FILE" -C "$SEARXNG_DIR" \
    docker-compose.yml \
    searxng_settings.yml \
    Caddyfile \
    data/caddy \
    data/searxng \
    --remove-files-from data/searxng/cache # Limpieza de la caché de SearXNG, si es grande

# Iniciar SearXNG de nuevo (si se detuvo)
# docker compose -f "$SEARXNG_DIR/docker-compose.yml" start

echo "Copia de seguridad completada."

# Eliminación de copias de seguridad antiguas
echo "Eliminando copias de seguridad antiguas (más de $RETENTION_DAYS días)..."
find "$BACKUP_DIR" -name "searxng_backup_.tar.gz" -type f -mtime +$RETENTION_DAYS -delete
echo "Limpieza de copias de seguridad antiguas completada."

# Ejemplo de envío de copia de seguridad a un servidor remoto a través de rsync
# REMOTE_USER="backup_user"
# REMOTE_HOST="your_backup_server_ip"
# REMOTE_PATH="/mnt/backups/searxng/"
# rsync -avzh "$BACKUP_FILE" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH"

# Ejemplo de envío de copia de seguridad a un almacenamiento compatible con S3 usando s3cmd/awscli
# s3cmd put "$BACKUP_FILE" s3://your-s3-bucket/searxng/

Haga el script ejecutable:

chmod +x ~/backup_searxng.sh

Configure cron para ejecutar el script automáticamente. Por ejemplo, para una copia de seguridad diaria a las 03:00 de la madrugada:

crontab -e

Añada la siguiente línea al final del archivo crontab:

0 3   * /home/searxng_admin/backup_searxng.sh >> /var/log/searxng_backup.log 2>&1

Esto ejecutará el script diariamente a las 3 de la madrugada y redirigirá la salida al archivo de registro /var/log/searxng_backup.log.

3. Dónde almacenar las copias de seguridad

No se recomienda almacenar las copias de seguridad en el mismo servidor que el servicio principal. Si el servidor falla (por ejemplo, un fallo de disco), perderá tanto el servicio como las copias de seguridad. Lugares de almacenamiento recomendados:

• Almacenamiento externo compatible con S3: Servicios como Backblaze B2, Amazon S3, DigitalOcean Spaces, MinIO (autoalojado), ofrecen almacenamiento de objetos fiable y asequible. Puede usar s3cmd o awscli para la carga automática de copias de seguridad.
• VPS o servidor dedicado separado: Si tiene otro servidor, puede usar rsync o scp para copiar las copias de seguridad.
• NAS/almacenamiento local: Para uso personal, puede configurar la copia de seguridad en un almacenamiento de red local.

Siempre cifre las copias de seguridad, especialmente si se almacenan en servicios de terceros. Herramientas como borgbackup o restic lo hacen automáticamente.

4. Actualizaciones: rolling vs maintenance window

Mantener el sistema y las aplicaciones actualizadas es fundamental para la seguridad y la estabilidad.

• Actualización del sistema operativo: Ejecute regularmente sudo apt update && sudo apt upgrade -y. Para Ubuntu LTS, se recomienda hacerlo al menos una vez al mes. Considere usar unattended-upgrades para aplicar automáticamente los parches de seguridad.
• Actualización de imágenes Docker (SearXNG, Caddy):
  • Rolling updates (actualizaciones continuas): Para SearXNG, que no tiene una base de datos o estado complejo, simplemente puede ejecutar periódicamente:

    
    docker compose pull # Descargar las últimas versiones de las imágenes
    docker compose up -d # Volver a crear los contenedores con las nuevas imágenes
    

    Esto se puede hacer cada pocas semanas. Caddy actualizará automáticamente sus certificados Let's Encrypt si están a punto de caducar.
  • Maintenance window (ventana de mantenimiento): Si desea asegurarse de que no haya problemas, planifique una pequeña ventana de mantenimiento (por ejemplo, 15-30 minutos una vez al mes) cuando ejecute manualmente docker compose pull && docker compose up -d y luego verifique los registros y la operatividad. Esto le permite estar preparado para posibles problemas y revertir los cambios si algo sale mal.

Siempre haga una copia de seguridad antes de realizar actualizaciones importantes o cambios de configuración.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado con éxito su propio metabuscador privado SearXNG en un VPS. Ahora controla su actividad de búsqueda, está protegido del seguimiento y la personalización de resultados, y puede disfrutar de una búsqueda limpia e imparcial en internet. También ha adquirido habilidades básicas para trabajar con Docker Compose, Caddy y la administración de un servidor Linux, lo que es una experiencia valiosa.

¿Qué sigue?

• Ajustes finos: Explore la documentación completa de SearXNG para adaptar searxng_settings.yml al máximo a sus necesidades. Experimente con diferentes temas, active y desactive motores de búsqueda, configure límites.
• Integración con el navegador: Configure su navegador (Firefox, Chrome, Brave) para usar su nueva instancia de SearXNG como motor de búsqueda predeterminado. Esto simplificará significativamente su uso.
• Monitoreo y escalado: Si planea atender a un gran número de usuarios, explore herramientas de monitoreo de servidores (por ejemplo, Prometheus + Grafana) y considere la posibilidad de ejecutar varias instancias de SearXNG detrás de un balanceador de carga.