basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалHomelabCrowdSec

    CrowdSec против перебора SSH: бан на всём сервере

    CrowdSec в контейнере читает /var/log/auth.log, узнаёт перебор паролей и ключей и выносит решение о бане, а crowdsec-firewall-bouncer на хосте отбрасывает пакеты с этого адреса в nftables — на всех портах, включая сайты в Docker. Схема с рабочих серверов; Traefik и Cloudflare здесь не нужны, с ними — «CrowdSec с Traefik за Cloudflare».

    Как это устроено

    sshd ── попытки входа ──→ /var/log/auth.log (rsyslog)
                                    │ том /var/log, только чтение
                                    ▼
                         crowdsec (контейнер)  сценарии crowdsecurity/sshd: подбор пароля, подбор пользователей,
                                    │          медленный перебор → решение «ban 90d»
                                    │ LAPI на 127.0.0.1:8080
                                    ▼
                    crowdsec-firewall-bouncer (хост)  раз в 10 с забирает решения
                                    │
                                    ▼
                         nftables: таблицы crowdsec и crowdsec6, хуки input и forward
                         пакеты от адреса отбрасываются на всех портах

    Детектор и исполнитель разделены. CrowdSec только решает, кого банить, — сам он ничего не блокирует. Блокирует bouncer. Так один CrowdSec может кормить и фаервол, и плагин в Traefik («CrowdSec с Traefik за Cloudflare»).

    Кроме своих решений, CrowdSec получает блок-лист сообщества (CAPI): адреса, которые атаковали другие серверы с CrowdSec. Bouncer банит и их — до того, как они постучатся к нам.

    Чем ещё останавливают перебор

    Чем Как работает Когда берём
    CrowdSec + firewall-bouncer сценарии по логам, бан в nftables на всех портах, блок-лист сообщества сервер в интернете с сайтами и SSH — схема этого мануала
    fail2ban регулярки по логам, бан через iptables, nftables или ufw один сервер, без Docker; знакомый инструмент, без внешнего сервиса
    PerSourcePenalties в sshd сам sshd отбивает адрес, который проваливает вход Ubuntu 26.04 (OpenSSH 10.2): включено по умолчанию, работает только для SSH
    ufw limit не больше 6 соединений за 30 с с адреса ничего не ставить; мешает своим скриптам («Фаервол ufw»)

    При входе только по ключу («sshd_config») перебор и так бесполезен. Бан нужен для другого: адрес, который подбирает SSH, обычно потом сканирует и сайты, а блок-лист сообщества отсекает его заранее.

    Настройка

    Docker на сервере уже стоит («Docker на Ubuntu»).

    1. Стек CrowdSec

      /opt/crowdsec/docker-compose.yaml
      services:
        crowdsec:
          image: crowdsecurity/crowdsec:latest
          container_name: crowdsec
          restart: unless-stopped
          mem_limit: 256M
          memswap_limit: 384M

      mem_limit — предел памяти контейнера, memswap_limit — вместе с подкачкой. Без предела при больших логах и многих сценариях CrowdSec съедает сотни мегабайт, на VPS с 1–2 ГБ это заметно.

          environment:
            COLLECTIONS: "crowdsecurity/linux crowdsecurity/sshd"

      Какие наборы сценариев скачать при старте: linux разбирает syslog, sshd — сценарии перебора SSH.

          volumes:
            - ./data/config:/etc/crowdsec
            - ./data/db:/var/lib/crowdsec/data
            - /var/log:/var/log:ro
      Главное

      Всё, что CrowdSec пишет, лежит в data/ стека: в config — конфиг и ключи к LAPI и CAPI, в db — база решений. Логи хоста /var/log CrowdSec читает, но менять не может (:ro). Из data/ в git идут только свои файлы — источники и профили («Конфиги серверов в git»).

          ports:
            - "127.0.0.1:8080:8080"

      LAPI на 127.0.0.1:8080: к нему ходит bouncer с хоста, снаружи порта нет («Порт только для хоста — на 127.0.0.1»).

    2. Источник — auth.log

      Образ кладёт в acquis.yaml заглушку с путём /does/not/exist. Настоящие источники — отдельными файлами в acquis.d/.

      /opt/crowdsec/data/config/acquis.d/auth.yaml
      filenames:
        - /var/log/auth.log
      labels:
        type: syslog

      Какой файл читать и каким разборщиком: type: syslog — строки syslog, из них сценарии sshd берут попытки входа.

      Каталог data/config появится после первого запуска, поэтому этот файл кладём после шага 4 и перезапускаем контейнер.

    3. Срок бана

      /opt/crowdsec/data/config/profiles.yaml
      name: default_ip_remediation
      filters:
       - Alert.Remediation == true && Alert.GetScope() == "Ip"
      decisions:
       - type: ban
         duration: 90d
      on_success: break
      Главное

      Бан адреса на 90 дней вместо 4 часов по умолчанию: адрес, который подбирал SSH, не станет через неделю безобидным. Срок пишется в решение при создании — правка касается только новых банов.

      ---
      name: default_range_remediation
      filters:
       - Alert.Remediation == true && Alert.GetScope() == "Range"
      decisions:
       - type: ban
         duration: 90d
      on_success: break

      Второй профиль — то же для подсетей, когда решение выносится на диапазон адресов.

      Файл заменяет profiles.yaml из образа целиком. Свой адрес, если попал в бан, снимаем руками.

    4. Запускаем

      cd /opt/crowdsec && docker compose up -d
      docker logs crowdsec 2>&1 | tail -5

      Первый запуск — около минуты: CrowdSec скачивает коллекции и регистрируется в CAPI.

    5. Ставим bouncer на хост

      Пакет — из репозитория CrowdSec. Скрипт добавляет репозиторий и ключ подписи, сам ничего не устанавливает:

      curl -s https://install.crowdsec.net | sudo sh
      sudo apt install crowdsec-firewall-bouncer-nftables

      Команды — по документации CrowdSec на 2026-10-18; на рабочих серверах bouncer ставился раньше и по шагам заново не проходился.

      Bouncer работает на хосте, а не в контейнере: ему нужен доступ к nftables хоста.

    6. Даём bouncer'у ключ

      docker exec crowdsec cscli bouncers add firewall-bouncer
      # API key for 'firewall-bouncer':
      #
      #    Kx9…
      #
      # Please keep this key since you will not be able to retrieve it!

      Ключ показывается один раз. Вписываем его в конфиг bouncer’а, не оставляя в истории команд: открываем файл редактором, а не echo в командной строке.

      sudo nano /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml
      mode: nftables
      api_url: http://127.0.0.1:8080/
      api_key: Kx9…
      update_frequency: 10s
      sudo chmod 600 /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml
      sudo systemctl restart crowdsec-firewall-bouncer
    7. Проверяем хуки

      sudo nft list table ip crowdsec | grep hook
      # type filter hook input priority filter - 10; policy accept;
      # type filter hook forward priority filter - 10; policy accept;

      Оба хука — и input, и forward. Без forward бан не закрывает контейнеры с опубликованными портами («Порты Docker идут мимо цепочки input»). Если хука forward нет — смотрим настройку nftables_hooks в том же yaml. В конфиге из пакета там input и forward, а если строки нет вовсе, bouncer берёт только input. В документации bouncer’а этой настройки нет — только в его конфиге и коде.

    Если не работает

    cscli metrics не показывает строк из auth.log

    Причина
    Файл не виден в контейнере: нет тома /var/log:/var/log:ro или источник лежит не в acquis.d/. Бывает и так, что auth.log нет вовсе — на сервере без rsyslog события входа есть только в журнале systemd.
    Делаем
    docker exec crowdsec ls -l /var/log/auth.log — файл должен быть. Нет на хосте — sudo apt install rsyslog: в обычном образе Ubuntu он стоит, в minimal-образах и у части хостеров — нет.

    Bouncer не стартует, в journalctl -u crowdsec-firewall-bouncer — ошибка ключа или 403

    Причина
    В crowdsec-firewall-bouncer.yaml пустой или чужой api_key. Пакет сам регистрирует ключ, только если CrowdSec стоит на хосте; при CrowdSec в контейнере ключ вписываем руками.
    Делаем
    docker exec crowdsec cscli bouncers add firewall-bouncer, ключ — в api_key, sudo systemctl restart crowdsec-firewall-bouncer.

    Забанили свой адрес, SSH — Connection timed out

    Причина
    Несколько неудачных входов подряд: ключ не тот, ssh перебрал все ключи из агента.
    Делаем
    С телефона по мобильному интернету или через консоль провайдера: docker exec crowdsec cscli decisions delete --ip <адрес>. На будущее — IdentitiesOnly yes («~/.ssh/config»).

    Решения о бане есть, а адрес по-прежнему подключается

    Причина
    Bouncer не забирает решения (cscli bouncers list — давний Last API pull) или стоит только на хуке input, а адрес ходит к контейнеру через forward.
    Делаем
    sudo systemctl status crowdsec-firewall-bouncer и sudo nft list table ip crowdsec | grep hook — нужны оба хука («Порты Docker идут мимо цепочки input»).

    Контейнер CrowdSec съедает сотни мегабайт и растёт

    Причина
    Без предела память контейнера не ограничена; при больших логах и многих сценариях это заметно на VPS с 1–2 ГБ.
    Делаем
    mem_limit: 256M в compose — так на рабочих серверах.

    Как проверить

    CrowdSec читает auth.log и разбирает строки:

    docker exec crowdsec cscli metrics show acquisition
    # │ file:/var/log/auth.log │ 1.24k │ 1.24k │ - │ - │

    Числа в первых двух колонках — прочитано и разобрано. Нули — источник не работает.

    Bouncer на связи:

    docker exec crowdsec cscli bouncers list
    # Name              IP Address  …  Last API pull         Type
    # firewall-bouncer  172.17.0.1  …  2026-10-18T19:41:02Z  crowdsec-firewall-bouncer

    Last API pull — секунды назад.

    Бан работает — действием, с телефона по мобильному интернету. Его адрес видно на ifconfig.me. Бан ставим на 2 минуты: если ошиблись адресом, он снимется сам.

    docker exec crowdsec cscli decisions add --ip <адрес телефона> --duration 2m --reason test
    # с телефона: SSH и сайты на сервере — тайм-аут
    docker exec crowdsec cscli decisions delete --ip <адрес телефона>

    Кто уже в бане — docker exec crowdsec cscli decisions list; остальные команды — «cscli и bouncer'ы».