Установка CrowdSec с брандмауэрным bouncer
Защитите сервер Debian или Ubuntu с помощью CrowdSec: установка, список разрешённых для вашего IP, брандмауэрный bouncer, коллекции, решения и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
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 listBouncer, установленный на том же сервере, автоматически регистрируется в 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:
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:
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-bouncerent: 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.