RU

Linux и сеть

Установка CrowdSec с брандмауэрным bouncer

Защитите сервер Debian или Ubuntu с помощью CrowdSec: установка, список разрешённых для вашего IP, брандмауэрный bouncer, коллекции, решения и устранение неполадок.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

CrowdSec анализирует журналы вашего сервера, выявляет вредоносное поведение (перебор паролей по SSH, веб-сканирование и т. д.) и принимает решение о блокировке соответствующих адресов. Это руководство покажет, как установить его на VPS или выделенный сервер, защитить ваш собственный IP-адрес, а затем применять блокировки на уровне брандмауэра.

Как работает CrowdSec

Компонент Роль
Security Engine Читает журналы и обнаруживает атаки с помощью сценариев
Local API (LAPI) Хранит решения, по умолчанию слушает 127.0.0.1:8080
Брандмауэрный bouncer Получает решения и блокирует адреса в брандмауэре
cscli Утилита командной строки для администрирования всего этого

Предварительные требования

  • Сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04
  • SSH-доступ под root или пользователем с правами sudo
  • Публичный IP-адрес, с которого вы администрируете сервер
  • Запасной способ доступа: на VPS это VNC-консоль в вашем личном кабинете. Для выделенного сервера проверьте доступный способ доступа или обратитесь в поддержку из личного кабинета

Порты: открывать входящие порты не нужно. LAPI (8080) и метрики (6060) слушают только 127.0.0.1 и не должны быть доступны снаружи. Сервер должен иметь возможность обращаться к api.crowdsec.net по HTTPS.

Шаг 1: проверьте локальные порты

Терминал
sudo ss -ltnp | grep -E ':(8080|6060) '

Если команда ничего не выводит, переходите к следующему шагу. Если порт 8080 уже занят, например контейнером Docker, продолжайте тоже: этот случай решает шаг 3.

Шаг 2: установите CrowdSec

Скачайте официальный скрипт добавления репозитория, просмотрите его, затем выполните:

Терминал
curl -fsSL https://install.crowdsec.net -o crowdsec-repo.sh
less crowdsec-repo.sh
sudo sh crowdsec-repo.sh

Затем установите пакет:

Терминал
sudo apt update
sudo apt install crowdsec

Проверьте службу:

Терминал
sudo systemctl status crowdsec
sudo cscli version

Шаг 3: изменить порт LAPI при необходимости

Если порт 8080 занят, пакет устанавливается без запуска службы и выводит Not attempting to start crowdsec, port 8080 is already used. Выберите свободный порт, здесь 8180, и измените два нужных файла:

Терминал
sudo sed -i 's|listen_uri: 127.0.0.1:8080|listen_uri: 127.0.0.1:8180|' /etc/crowdsec/config.yaml
sudo sed -i 's|^url: .*|url: http://127.0.0.1:8180|' /etc/crowdsec/local_api_credentials.yaml
sudo systemctl restart crowdsec
sudo cscli lapi status

Сообщение You can successfully interact with Local API (LAPI) подтверждает, что всё работает.

Шаг 4: разрешите ваш IP-адрес

Сделайте это до установки bouncer, чтобы не рисковать заблокировать собственный доступ. В своей SSH-сессии выведите используемый адрес:

Терминал
echo $SSH_CONNECTION | awk '{print $1}'

Создайте список разрешённых и добавьте в него этот адрес:

Терминал
sudo cscli allowlists create admins -d 'Admin addresses'
sudo cscli allowlists add admins ВАШ_IP -d 'Admin workstation'
sudo cscli allowlists inspect admins

Диапазон добавляется так же, например 198.51.100.0/24. Список разрешённых препятствует новым решениям, но не снимает уже существующие. Если ваш адрес уже был заблокирован:

Терминал
sudo cscli decisions delete --ip ВАШ_IP

Шаг 5: установите брандмауэрный bouncer

Терминал
sudo apt install crowdsec-firewall-bouncer-iptables
sudo systemctl status crowdsec-firewall-bouncer
sudo cscli bouncers list

Bouncer, установленный на том же сервере, автоматически регистрируется в LAPI: он должен появиться в списке с отметкой в столбце Valid. Его конфигурация находится в /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.

Этот пакет использует iptables и ipset, что работает и с UFW, и с цепочкой DOCKER-USER Docker. Для конфигураций, целиком основанных на nftables, существует пакет crowdsec-firewall-bouncer-nftables.

Шаг 6: проверьте обнаружение и блокировку

Общее состояние

Терминал
sudo cscli capi status
sudo cscli metrics show acquisition parsers

Таблица источников может оставаться пустой, пока после запуска службы в журналы не записана ни одна новая строка.

Проверка обнаружения SSH

С машины, адреса которой нет в вашем списке разрешённых, выполните это подключение, которое, как и ожидается, завершится ошибкой:

Терминал
ssh crowdsec-test-NtktlJHV4TfBSK3wvlhiOBnl@IP_ВАШЕГО_СЕРВЕРА

На сервере должно появиться тестовое оповещение:

Терминал
sudo cscli alerts list -s crowdsecurity/ssh-generic-test

Проверка блокировки

Используйте доступный вам публичный адрес, отличный от вашего административного, вместо 203.0.113.10:

Терминал
sudo cscli decisions add --ip 203.0.113.10 --duration 5m --reason 'Test'
sudo cscli decisions list

Через несколько секунд адрес добавляется в брандмауэр и больше не может обращаться к серверу:

Терминал
sudo iptables -S CROWDSEC_CHAIN
sudo ipset list crowdsec-blacklists-0 | tail -n 5

Затем снимите решение:

Терминал
sudo cscli decisions delete --ip 203.0.113.10

Коллекции и источники журналов

Коллекция объединяет анализаторы и сценарии одной службы. При установке CrowdSec обнаруживает имеющиеся службы и записывает соответствующие источники в /etc/crowdsec/acquis.d/.

Терминал
sudo cscli collections list
sudo cscli collections list -a

Для службы, установленной после CrowdSec, например Nginx, добавьте коллекцию:

Терминал
sudo cscli collections install crowdsecurity/nginx

Затем создайте /etc/crowdsec/acquis.d/nginx.yaml:

YAML
filenames:
  - /var/log/nginx/*.log
labels:
  type: nginx

Проверьте конфигурацию и перезапустите:

Терминал
sudo crowdsec -t && sudo systemctl restart crowdsec
sudo cscli metrics show acquisition

Управление решениями

Действие Команда
Список решений sudo cscli decisions list
Заблокировать адрес на 24 ч sudo cscli decisions add --ip 203.0.113.10 --duration 24h --reason 'Manual ban'
Заблокировать диапазон sudo cscli decisions add --range 203.0.113.0/24 --reason 'Manual ban'
Разблокировать адрес sudo cscli decisions delete --ip 203.0.113.10
Просмотреть оповещения sudo cscli alerts list
Оповещения по адресу sudo cscli alerts list --ip 203.0.113.10

Без --duration ручное решение действует 4 часа. Избегайте sudo cscli decisions delete --all: эта команда удаляет также локальные и общественные решения.

Защита контейнеров Docker

Порты, опубликованные Docker, проходят через цепочку FORWARD, а не INPUT. Чтобы bouncer их охватывал, создайте /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local:

YAML
iptables_chains:
  - INPUT
  - DOCKER-USER

Список в этом файле заменяет список из основного файла: поэтому оставьте INPUT. Docker должен быть установлен, так как именно он создаёт цепочку DOCKER-USER. Чтобы bouncer запускался после Docker, добавьте дополнение systemd:

Терминал
sudo systemctl edit crowdsec-firewall-bouncer
Конфигурация
[Unit]
After=docker.service
Wants=docker.service

Перезапустите и проверьте:

Терминал
sudo systemctl restart crowdsec-firewall-bouncer
sudo iptables -S DOCKER-USER

Консоль CrowdSec (необязательно)

Веб-консоль позволяет следить за оповещениями и серверами. Создайте учётную запись на app.crowdsec.net, получите ключ регистрации (enrollment), затем выполните:

Терминал
sudo cscli console enroll ENROLLMENT_KEY

Подтвердите сервер в консоли, затем перезапустите службу командой sudo systemctl restart crowdsec. CrowdSec работает и без этого шага.

Обновления

Обновите пакеты, затем элементы Hub (коллекции, сценарии, анализаторы):

Терминал
sudo apt update
sudo apt install --only-upgrade crowdsec crowdsec-firewall-bouncer-iptables
sudo cscli hub update
sudo cscli hub upgrade
sudo systemctl restart crowdsec

Элементы, которые вы изменили локально, cscli hub upgrade не обновляет.

Резервное копирование

Конфигурация находится в /etc/crowdsec, а данные, в том числе база SQLite по умолчанию, в /var/lib/crowdsec/data. Остановите службу на время копирования, чтобы получить согласованную базу:

Терминал
sudo systemctl stop crowdsec
sudo tar czf crowdsec-backup.tar.gz /etc/crowdsec /var/lib/crowdsec/data
sudo systemctl start crowdsec
sudo chmod 600 crowdsec-backup.tar.gz

Этот архив содержит учётные данные: храните его в надёжном месте, вне сервера.

Если что-то пошло не так

CrowdSec заблокировал вас

Подключитесь через VNC-консоль (для выделенного сервера обратитесь в поддержку), затем снимите решение и разрешите ваш адрес:

Терминал
sudo cscli decisions delete --ip ВАШ_IP
sudo cscli allowlists add admins ВАШ_IP

При необходимости sudo systemctl stop crowdsec-firewall-bouncer приостанавливает блокировки на время исправления.

bind: address already in use

Другая служба использует порт LAPI. Определите её командой sudo ss -ltnp | grep 8080, затем примените шаг 3. Если bouncer уже был установлен, обновите также api_url в его конфигурации и перезапустите его.

Bouncer выводит connection refused

  • Убедитесь, что CrowdSec работает: sudo systemctl status crowdsec
  • Сравните api_url в конфигурации bouncer с listen_uri в /etc/crowdsec/config.yaml
  • Посмотрите /var/log/crowdsec-firewall-bouncer.log

Bouncer выводит API error: access forbidden

Его ключ больше не распознаётся. Создайте новый под другим именем, впишите его в api_key, затем перезапустите bouncer:

Терминал
sudo cscli bouncers add firewall-bouncer-2
sudo nano /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml
sudo systemctl restart crowdsec-firewall-bouncer

ent: machine not found или incorrect Username or Password

Локальные учётные данные больше не соответствуют базе:

Терминал
sudo cscli machines add -a --force
sudo systemctl restart crowdsec

Ни одна строка не анализируется

  • Выведите источники: sudo cscli metrics show acquisition
  • Проверьте файлы в /etc/crowdsec/acquis.d/ и реальный путь к вашим журналам
  • Найдите ошибки: sudo grep -E 'level=(error|fatal)' /var/log/crowdsec.log

Bouncer не запускается после добавления DOCKER-USER

Цепочка не существует, пока Docker не запущен. Проверьте sudo systemctl status docker, затем sudo iptables -S DOCKER-USER.

Ссылки