basforge

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

    EN
    ШпаргалкаHomelabCrowdSec

    cscli и bouncer'ы: команды на каждый день

    Кто в бане и за что, как снять бан со своего адреса, жив ли bouncer, что CrowdSec читает из логов. Если CrowdSec работает в контейнере, все cscli — с префиксом docker exec crowdsec; на хосте префикс не нужен.

    Баны

    Команда Что делает
    cscli decisions list кто сейчас в бане, за что, сколько осталось
    cscli decisions list --ip <IP> есть ли решение по конкретному адресу
    cscli decisions add --ip <IP> --duration 2m --reason test бан на 2 минуты — проверка, что bouncer’ы работают
    cscli decisions delete --ip <IP> снимает бан, например со своего адреса

    Срабатывания

    Команда Что делает
    cscli alerts list --limit 10 последние срабатывания сценариев
    cscli alerts inspect <id> -d подробно: какие строки логов привели к бану

    Bouncer’ы

    Команда Что делает
    cscli bouncers list все bouncer’ы и время последнего обращения (Last API pull) — жив ли
    cscli bouncers add <имя> выпускает ключ для нового bouncer’а; ключ показывается один раз
    cscli bouncers delete <имя> отзывает ключ; вместе с записью уходят все её <имя>@<IP>
    cscli bouncers prune -d 168h --force удаляет записи, которые не обращались к LAPI неделю

    Записи вида <имя>@172.18.0.x — тот же bouncer, пришедший с нового адреса контейнера после пересоздания. Живая — со свежим Last API pull. По имени такую запись не удалить — только prune.

    Что CrowdSec читает и как разбирает

    Команда Что делает
    cscli metrics сводка: источники, парсеры, сценарии, обращения bouncer’ов
    cscli metrics show acquisition сколько строк прочитано по каждому источнику — жив ли источник
    cscli explain --file /var/log/auth.log --type syslog как CrowdSec разбирает строки файла — подходит ли парсер

    Коллекции и хаб

    Команда Что делает
    cscli hub update обновляет список того, что есть в хабе
    cscli hub upgrade обновляет установленные коллекции, парсеры, сценарии
    cscli collections list что установлено
    cscli collections install crowdsecurity/nginx ставит коллекцию; её же дописываем в COLLECTIONS в compose, чтобы пережила пересоздание

    Связь с сообществом

    Команда Что делает
    cscli capi status подключён ли CrowdSec к общим блок-листам (CAPI)
    cscli lapi status отвечает ли локальный API, через который ходят bouncer’ы

    Bouncer на хосте

    Команда Что делает
    systemctl status crowdsec-firewall-bouncer работает ли
    nft list table ip crowdsec | grep hook на каких хуках стоит; нужны input и forward («Порты Docker идут мимо цепочки input»)
    nft list table ip crowdsec | grep -A1 'counter crowdsec' счётчики: сколько пакетов отброшено по каждому списку

    Что обычно спрашивают

    • Срок бана — duration: в profiles.yaml, после правки docker compose restart crowdsec. Новый срок получают только новые решения.
    • Новый источник — файл в acquis.d/ и restart. Подхватился ли, видно в cscli metrics show acquisition.
    • В crowdsecurity/base-http-scenarios входит http-probing — бан за серию 404 на /.env, /.git, wp-admin и т. п.