Встановлення SearXNG

Встановлення ПЗ — покроково

Ми будемо встановлювати SearXNG за допомогою Docker Compose. Цей підхід забезпечує ізоляцію програми, спрощує керування залежностями та полегшує оновлення. Для 2026 року Docker та Docker Compose є стандартом де-факто для розгортання багатьох веб-сервісів.

1. Встановлення Docker Engine та Docker Compose

Спочатку встановимо необхідні компоненти Docker. Ми будемо використовувати офіційні репозиторії Docker для отримання актуальних версій.

# Оновлення індексу пакетів (актуально на 2026 рік)
sudo apt update

# Встановлення пакетів, необхідних для використання репозиторію Docker через HTTPS
sudo apt install -y ca-certificates curl gnupg

# Додавання офіційного GPG ключа 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

# Додавання репозиторію Docker до 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

# Оновлення індексу пакетів після додавання репозиторію Docker
sudo apt update

# Встановлення Docker Engine, Docker CLI та Docker Compose (актуальні версії на 2026 рік)
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Додавання поточного користувача до групи docker для роботи з Docker без sudo
sudo usermod -aG docker $USER

# Застосування змін для групи docker (необхідно перелогінитися або виконати newgrp docker)
newgrp docker

# Перевірка встановлення Docker
docker run hello-world

Команда docker run hello-world повинна вивести вітальне повідомлення, що підтверджує успішне встановлення Docker.

2. Створення директорії для SearXNG та конфігурації

Створимо робочу директорію для SearXNG, де зберігатимуться всі конфігураційні файли та Docker Compose.

mkdir ~/searxng
cd ~/searxng

3. Створення файлу docker-compose.yml

Створіть файл docker-compose.yml. Цей файл визначатиме, як Docker повинен запускати SearXNG.

nano docker-compose.yml

Вставте наступний вміст. Це базова конфігурація, що використовує офіційний образ SearXNG та проксі-сервер Caddy для HTTPS.

version: '3.8'

services:
  searxng:
    image: searxng/searxng:latest # Актуальна версія SearXNG на 2026 рік
    container_name: searxng
    ports:
      - "8080:8080" # SearXNG буде доступний на порту 8080 всередині контейнера
    volumes:
      - ./searxng_settings.yml:/etc/searxng/settings.yml:ro # Монтуємо наш конфіг
      - ./data/searxng:/data # Директорія для даних та кешу SearXNG
    environment:
      - SEARXNG_BASE_URL=https://ВАШ_ДОМЕН_ДЛЯ_SEARXNG/ # Замініть на ваш домен
      - SEARXNG_URL=http://searxng:8080/ # Внутрішній URL для Caddy
    restart: unless-stopped
    networks:
      - searxng_network

  caddy:
    image: caddy:2-alpine # Актуальна версія Caddy на 2026 рік
    container_name: caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro # Монтуємо наш конфіг Caddy
      - ./data/caddy:/data # Директорія для даних Caddy (сертифікати Let's Encrypt)
    environment:
      - CADDY_EMAIL=ВАШ[email protected] # Email для Let's Encrypt
    restart: unless-stopped
    networks:
      - searxng_network

networks:
  searxng_network:
    driver: bridge

Важливо: Замініть ВАШ_ДОМЕН_ДЛЯ_SEARXNG на ваш реальний домен (наприклад, searx.mydomain.com) та ВАШ[email protected] на вашу адресу електронної пошти для отримання сповіщень від Let's Encrypt.

4. Налаштування файлу searxng_settings.yml

SearXNG має безліч налаштувань, які можна змінити у файлі settings.yml. Для початку ми створимо базовий файл.

nano searxng_settings.yml

Вставте наступний мінімальний вміст. Для отримання повного списку налаштувань зверніться до офіційної документації SearXNG.

# searxng_settings.yml - Приклад базової конфігурації

# Загальні налаштування
debug: False
limiter: True # Увімкнути обмеження швидкості запитів
user_agent: 'SearXNG/1.3' # Приклад user-agent, актуальний на 2026 рік

# Налаштування приватності
no_cookie_tracking: True
no_session_tracking: True
no_result_urls_tracking: True

# Налаштування рушіїв (приклад - увімкнено основні)
# Для повного списку та налаштування див. https://docs.searxng.org/admin/settings.html#engines
engines:
  - google
  - duckduckgo
  - bing
  - wikipedia
  - startpage
  - yandex

# Налаштування інтерфейсу (опціонально)
# theme: simple
# autocomplete: 'duckduckgo'

# Додаткові опції
# image_proxy: True
# timezone: 'Europe/Moscow'

# Secret key для захисту сесій (ОБОВ'ЯЗКОВО ЗГЕНЕРУЙТЕ СВІЙ!)
secret_key: "ЗГЕНЕРУЙТЕ_СВІЙ_СЕКРЕТНИЙ_КЛЮЧ"

Дуже важливо: Замініть "ЗГЕНЕРУЙТЕ_СВІЙ_СЕКРЕТНИЙ_КЛЮЧ" на випадковий рядок. Ви можете згенерувати його, наприклад, так:

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

Скопіюйте отриманий рядок та вставте у searxng_settings.yml.

5. Створення файлу Caddyfile

Caddy виступатиме в ролі зворотного проксі, перенаправляючи запити до SearXNG та автоматично налаштовуючи HTTPS за допомогою Let's Encrypt.

nano Caddyfile

Вставте наступний вміст:

ВАШ_ДОМЕН_ДЛЯ_SEARXNG {
    # Замініть на ваш домен, наприклад, searx.mydomain.com
    # Caddy автоматично отримає SSL-сертифікат від Let's Encrypt

    reverse_proxy searxng:8080 {
        # Перенаправляє запити до контейнера 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}
    }

    # Додаткові заголовки для безпеки (рекомендується)
    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
    }

    # Логування (опціонально)
    log {
        output file /data/access.log {
            roll_size 10mb
            roll_keep 5
            roll_keep_for 720h
        }
        format json
    }
}

Важливо: Замініть ВАШ_ДОМЕН_ДЛЯ_SEARXNG на ваш реальний домен. Переконайтеся, що DNS-запис (тип A) для цього домену вказує на IP-адресу вашого VPS. Без коректного DNS-запису Caddy не зможе отримати SSL-сертифікат.

6. Запуск SearXNG з Docker Compose

Після створення всіх необхідних файлів можна запустити SearXNG.

# Створення директорії для даних Caddy та SearXNG
mkdir -p data/caddy data/searxng

# Запуск контейнерів у фоновому режимі
docker compose up -d

# Перевірка статусу запущених контейнерів
docker compose ps

Команда docker compose ps повинна показати, що контейнери searxng та caddy запущені та знаходяться у статусі Up. Якщо Caddy не запускається відразу, дайте йому кілька хвилин, щоб отримати сертифікат Let's Encrypt. Ви можете перевірити логи Caddy, якщо виникнуть проблеми:

docker compose logs caddy

Тепер ваш приватний метапошуковик SearXNG повинен бути доступний за вашим доменним іменем через HTTPS.

Резервні копії та обслуговування

Регулярне резервне копіювання та своєчасне обслуговування є критично важливими для стабільної та безпечної роботи будь-якого сервісу, включно з SearXNG. Хоча SearXNG сам по собі не зберігає конфіденційних користувацьких даних (оскільки це приватний пошуковик), важливо зберігати його конфігурацію та дані Caddy (сертифікати Let's Encrypt), щоб уникнути переналаштування у випадку збою.

1. Що резервувати

Для SearXNG на Docker Compose основні елементи, які вимагають резервного копіювання, це:

• Файли конфігурації SearXNG: searxng_settings.yml. Це основний файл, що визначає поведінку вашого пошуковика.
• Файли Docker Compose: docker-compose.yml. Визначає, як запустити SearXNG та Caddy.
• Файли конфігурації Caddy: Caddyfile. Містить налаштування вашого зворотного проксі та HTTPS.
• Дані Caddy: Директорія ./data/caddy (у нашому випадку ~/searxng/data/caddy). Тут зберігаються сертифікати Let's Encrypt та інша службова інформація Caddy.
• Дані SearXNG: Директорія ./data/searxng (у нашому випадку ~/searxng/data/searxng). Може містити кеш, логи та інші тимчасові дані SearXNG.

Користувацькі дані не резервуються, оскільки SearXNG не зберігає їх.

2. Простий скрипт авторезервування

Ми створимо простий скрипт, який архівуватиме всі необхідні файли та директорії. Як інструмент для резервного копіювання можна використовувати tar для архівації та rsync для синхронізації з віддаленим сховищем. Для більш просунутих сценаріїв можна розглянути borgbackup або restic, які підтримують дедуплікацію та шифрування.

Створіть файл скрипта, наприклад, backup_searxng.sh, у вашій домашній директорії:

nano ~/backup_searxng.sh

Вставте наступний вміст:

#!/bin/bash

# Шлях до директорії SearXNG
SEARXNG_DIR="/home/searxng_admin/searxng" # Замініть на шлях до вашої директорії 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 # Зберігати резервні копії за останні 7 днів

# Створення директорії для резервних копій, якщо її немає
mkdir -p "$BACKUP_DIR"

echo "Починаємо резервне копіювання SearXNG до $BACKUP_FILE..."

# Зупинка SearXNG для консистентності даних (опціонально, але рекомендується для caddy/searxng data)
# docker compose -f "$SEARXNG_DIR/docker-compose.yml" stop

# Архівування необхідних файлів та директорій
tar -czf "$BACKUP_FILE" -C "$SEARXNG_DIR" \
    docker-compose.yml \
    searxng_settings.yml \
    Caddyfile \
    data/caddy \
    data/searxng \
    --remove-files-from data/searxng/cache # Очищення кешу SearXNG, якщо він великий

# Запуск SearXNG назад (якщо було зупинено)
# docker compose -f "$SEARXNG_DIR/docker-compose.yml" start

echo "Резервне копіювання завершено."

# Видалення старих резервних копій
echo "Видалення старих резервних копій (старше $RETENTION_DAYS днів)..."
find "$BACKUP_DIR" -name "searxng_backup_.tar.gz" -type f -mtime +$RETENTION_DAYS -delete
echo "Очищення старих резервних копій завершено."

# Приклад відправки резервної копії на віддалений сервер через 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"

# Приклад відправки резервної копії до S3-сумісного сховища за допомогою s3cmd/awscli
# s3cmd put "$BACKUP_FILE" s3://your-s3-bucket/searxng/

Зробіть скрипт виконуваним:

chmod +x ~/backup_searxng.sh

Налаштуйте cron для автоматичного запуску скрипта. Наприклад, для щоденного резервного копіювання о 03:00 ночі:

crontab -e

Додайте наступний рядок у кінець файлу crontab:

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

Це запускатиме скрипт щодня о 3 годині ночі та перенаправлятиме вивід у файл логів /var/log/searxng_backup.log.

3. Куди зберігати резервні копії

Зберігати резервні копії на тому ж сервері, що й основний сервіс, не рекомендується. Якщо сервер вийде з ладу (наприклад, відмова диска), ви втратите і сервіс, і резервні копії. Рекомендовані місця для зберігання:

• Зовнішнє S3-сумісне сховище: Такі сервіси, як Backblaze B2, Amazon S3, DigitalOcean Spaces, MinIO (self-hosted), пропонують надійне та недороге зберігання об'єктів. Ви можете використовувати s3cmd або awscli для автоматичного завантаження резервних копій.
• Окремий VPS або виділений сервер: Якщо у вас є інший сервер, ви можете використовувати rsync або scp для копіювання резервних копій.
• NAS/локальне сховище: Для особистого використання можна налаштувати копіювання резервних копій на локальне мережеве сховище.

Завжди шифруйте резервні копії, особливо якщо вони зберігаються на сторонніх сервісах. Інструменти на кшталт borgbackup або restic роблять це автоматично.

4. Оновлення: rolling vs maintenance window

Підтримка системи та додатків в актуальному стані є критично важливою для безпеки та стабільності.

• Оновлення операційної системи: Регулярно запускайте sudo apt update && sudo apt upgrade -y. Для Ubuntu LTS рекомендується це робити хоча б раз на місяць. Розгляньте можливість використання unattended-upgrades для автоматичного застосування патчів безпеки.
• Оновлення Docker-образів (SearXNG, Caddy):
  • Rolling updates (безперервні оновлення): Для SearXNG, який не має складної бази даних або стану, можна просто періодично виконувати:

    
    docker compose pull # Завантажити останні версії образів
    docker compose up -d # Перестворити контейнери з новими образами
    

    Це можна робити раз на кілька тижнів. Caddy автоматично оновить свої сертифікати Let's Encrypt, якщо вони підходять до кінця терміну дії.
  • Maintenance window (вікно обслуговування): Якщо ви хочете бути впевнені у відсутності проблем, плануйте невелике вікно обслуговування (наприклад, 15-30 хвилин раз на місяць), коли ви вручну виконуєте docker compose pull && docker compose up -d, а потім перевіряєте логи та працездатність. Це дозволяє вам бути готовим до можливих проблем та відкотити зміни, якщо щось піде не так.

Завжди робіть резервну копію перед великими оновленнями або змінами конфігурації.

Висновки та наступні кроки

Вітаємо! Ви успішно встановили та налаштували свій власний приватний метапошуковик SearXNG на VPS. Тепер ви контролюєте свою пошукову активність, захищені від стеження та персоналізації видачі, і можете насолоджуватися чистим, неупередженим пошуком в інтернеті. Ви також освоїли базові навички роботи з Docker Compose, Caddy та управління Linux-сервером, що є цінним досвідом.

Куди рухатися далі?

• Тонке налаштування: Вивчіть повну документацію SearXNG, щоб максимально адаптувати searxng_settings.yml під свої потреби. Експериментуйте з різними темами, вмикайте та вимикайте пошукові системи, налаштовуйте ліміти.
• Інтеграція з браузером: Налаштуйте ваш браузер (Firefox, Chrome, Brave) для використання вашого нового SearXNG-інстансу як пошуковика за замовчуванням. Це значно спростить використання.
• Моніторинг та масштабування: Якщо ви плануєте обслуговувати велику кількість користувачів, вивчіть інструменти моніторингу сервера (наприклад, Prometheus + Grafana) та розгляньте можливість запуску кількох інстансів SearXNG за балансувальником навантаження.