CrowdSec Collaborative IPS
Distributed IPS + community threat intel — agent trên mọi VM.
Bối cảnh & Lý do triển khai
Fail2ban và UFW đang bảo vệ các VM riêng lẻ nhưng không chia sẻ thông tin với nhau: IP tấn công SSH VM246 vẫn tự do scan VM242. CrowdSec giải quyết vấn đề này bằng kiến trúc centralized: một Local API (LAPI) server nhận báo cáo từ agent trên tất cả VM, ra quyết định ban IP, và phân phối quyết định đó về bouncer trên từng VM để block đồng bộ. Community blocklist miễn phí bổ sung thêm hàng triệu IP xấu được cộng đồng toàn cầu report.
Kiến trúc triển khai: VM271 chạy CrowdSec Security Engine (LAPI) trong container Docker bằng image chính thức crowdsecurity/crowdsec (quy tắc của series: ứng dụng nào chạy được trên Docker thì ưu tiên Docker); mỗi VM còn lại cài agent và firewall bouncer nftables trực tiếp trên host bằng gói apt: agent đọc log cục bộ rồi gửi alert về LAPI, bouncer kéo danh sách IP bị ban từ LAPI và chặn bằng nftables. Lý do bouncer không chạy trong container nằm ở bảng "Phương án triển khai" trong phần Thông tin VM.
| Mục | Nội dung |
|---|---|
| Ứng dụng trong doanh nghiệp | Distributed IPS: block IP xấu đồng bộ trên toàn hạ tầng |
| Tác dụng chính | Phát hiện brute force, web scanning, port probing; block bằng nftables |
| Nếu không triển khai | Mỗi VM bị tấn công độc lập, không có correlation giữa các VM |
| Các service phụ thuộc vào đây | Wazuh (nhận CrowdSec decisions), Prometheus (metrics), Mattermost (#security) |
Danh sách máy chủ & IP liên quan
Bảng dưới liệt kê các máy chủ mà bài này tạo hoặc kết nối tới. Địa chỉ, VMID, VLAN và node lấy từ bảng quy hoạch chung của lab, dùng thống nhất cho cả bộ bài lab.
| Máy chủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| crowdsec (CrowdSec LAPI) · VM271 | 10.11.35.20 | 35 (DMZ) · node3 | Máy chủ của bài — LAPI CrowdSec chạy trong container Docker (mạng host) cổng 8080, metrics Prometheus cổng 6060, Metabase tùy chọn cổng 3000; ra quyết định ban cho các bouncer. |
| node3 (Proxmox VE) | 10.11.45.212 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM271; tạo VM Ubuntu Server 24.04 (scsi0 20 GB trên SSD vm-ceph) tại đây. |
| authentik (Authentik SSO) · VM234 | 10.11.25.40 | 25 (SEC) · node1 | Chạy CrowdSec agent và bouncer nftables (gói apt), gửi alert về LAPI cổng 8080 và chặn IP bị ban (bài 14). |
| prometheus (Prometheus + Alertmanager) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Chạy agent và bouncer; thêm job crowdsec-lapi và crowdsec-agents vào prometheus.yml để scrape metrics cổng 6060, import dashboard Grafana 19013 (bài 15). |
| harbor (Harbor Registry) · VM239 | 10.11.45.39 | 45 (MGMT) · node2 | Chạy CrowdSec agent và bouncer nftables, dùng file credentials và API key sinh trên LAPI bằng cscli machines add --auto và cscli bouncers add (bài 21). |
| gitea (Gitea + Actions) · VM240 | 10.11.45.40 | 45 (MGMT) · node2 | Chạy agent và bouncer; acquis.d/docker.yaml cho agent đọc log container, type theo collection Hub tương ứng (bài 22). |
| step-ca (step-CA PKI) · VM242 | 10.11.25.42 | 25 (SEC) · node1 | Chạy agent và bouncer; cấp chứng chỉ TLS tùy chọn cho LAPI bằng step ca certificate, hiệu lực 2160h (bài 13). |
| mailu (Mailu Mail Server) · VM246 | 10.11.35.46 | 35 (DMZ) · node2 | Chạy CrowdSec agent và bouncer nftables, chặn IP tấn công sau khi LAPI ra quyết định ban (bài 16). |
| pihole (Pi-hole DNS) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | Chạy agent và bouncer; chứa bản ghi DNS crowdsec.hoatranlabs.local trỏ về LAPI, thêm bằng Admin UI hoặc add_dns_records.sh (bài 12). |
| vault (HashiCorp Vault) · VM269 | 10.11.25.10 | 25 (SEC) · node1 | Chạy agent và bouncer; metrics agent cổng 6060 nằm trong job crowdsec-agents của Prometheus (bài 34). |
| thehive (TheHive + Cortex) · VM270 | 10.11.25.11 | 25 (SEC) · node2 | Chạy agent và bouncer; đọc log container nginx-thehive (type nginx) qua acquis.d/docker.yaml (bài 35). |
| mattermost (Mattermost) · VM272 | 10.11.65.57 | 65 (SRV) · node1 | Chạy agent và bouncer; nhận cảnh báo ban IP qua webhook kênh #security bằng notification slack mattermost-security (bài 37). |
| wazuh-siem (Wazuh SIEM) · VM280 | 10.11.45.25 | 45 (MGMT) · node1 | Manager nhận file JSON quyết định ban từ Wazuh agent trên VM271 qua cổng 1514, rule 100200 cảnh báo ban IP (bài 17). |
| pbs01 (PBS Primary) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Nhận backup /etc/crowdsec, /var/lib/crowdsec/data và /opt/crowdsec bằng proxmox-backup-client, datastore syno-primary, namespace vm-crowdsec (bài 04). |
Gateway của mỗi VLAN là địa chỉ .1. Tên DNS nội bộ do Pi-hole phân giải (bài 12). Tên in đậm là hostname; FQDN = hostname + .hoatranlabs.local.
Thông tin VM (LAPI Server)
| Thông số | Giá trị |
|---|---|
| VMID | 271 |
| Hostname | crowdsec |
| IP | 10.11.35.20/24 |
| Gateway | 10.11.35.1 |
| VLAN | 35 (VLAN_DMZ) |
| vCPU | 2 |
| RAM | 2 GB |
| Disk | 20 GB (scsi0, SSD vm-ceph) |
| OS | Ubuntu Server 24.04 LTS |
| Cách chạy | Docker Engine + Compose plugin; container crowdsec (LAPI, network_mode: host), thư mục dự án /opt/crowdsec; cấu hình /etc/crowdsec, dữ liệu /var/lib/crowdsec/data (bind mount cùng đường dẫn với cài apt) |
| Cổng | 8080/TCP (LAPI, chỉ 10 VM agent/bouncer), 6060/TCP (metrics Prometheus, chỉ VM235), 3000/TCP (Metabase, tùy chọn) |
| Phân bổ node | node3 |
create-lab-vms.sh thì scsi0 = 20 GB trên SSD vm-ceph, không có đĩa dữ liệu scsi1; số 20 GB khớp vms.csv và chỉ là trần danh nghĩa (thin provisioning), môi trường thật nên cấp lớn hơn (bài từng ghi 30 GB). Hệ điều hành cộng Docker và image CrowdSec chỉ chiếm khoảng 9 GB theo ước tính bài 07 mục 8.6; SQLite crowdsec.db trong /var/lib/crowdsec/data và dữ liệu Metabase (tùy chọn, /opt/crowdsec/metabase) nhỏ, log container đã giới hạn max-size: 10m (mục 2.2, 2.6).
Phương án triển khai (quy tắc của series: có image chính thức thì ưu tiên Docker, rồi LXC, cuối cùng mới cài trực tiếp lên VM; các agent chạy trên host vẫn cài trực tiếp):
VM cần bảo vệ (10 VM, cài native bằng apt) VM271 (Docker)
┌───────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
│ crowdsec (agent, gói apt): đọc log cục bộ │ ──alert──► │ container crowdsec = LAPI │
│ crowdsec-firewall-bouncer (gói apt) │◄─decision─ │ :8080 API :6060 metrics │
│ nftables: bảng crowdsec = IP bị ban │ (10 giây) │ /etc/crowdsec /var/lib/crowdsec/data │
└───────────────────────────────────────────┘ └─────────────────────────────────────────┘
| Phương án | Trạng thái trong bài | Lý do chọn / không chọn | Cách chuyển đổi |
|---|---|---|---|
| Docker: LAPI trong container trên VM271 + agent và firewall bouncer cài native (apt) trên từng VM | Khuyến nghị — bài này (mục 1–4) | CrowdSec phát hành image chính thức crowdsecurity/crowdsec (Docker Hub và ghcr.io) có tag theo phiên bản nên ghim được v1.8.1; cấu hình và dữ liệu nằm ở bind mount cùng đường dẫn với cài apt (/etc/crowdsec, /var/lib/crowdsec/data) nên bản backup PBS in-VM (bài 04 mục 5.7) và các đường dẫn tham chiếu trong bài không đổi; nâng cấp hoặc quay lại bản cũ bằng cách đổi tag; VMID, IP, VLAN, node giữ nguyên | Từ apt sang Docker: dừng dịch vụ, giữ nguyên hai thư mục dữ liệu, chạy compose ở mục 2.2 (xem "Phụ lục") |
| VM271 cài apt toàn phần (LAPI + agent cục bộ chạy bằng systemd) | Phương án thay thế (mục "Phụ lục") | Ít lớp nhất, không cần Docker daemon; nhược điểm: lệnh cài và nâng cấp theo gói, không ghim được tag image, listen_uri và Prometheus phải tự sửa vì gói chỉ nghe 127.0.0.1 | Dừng container, cài gói cùng phiên bản 1.8.1 trên cùng hai thư mục dữ liệu (xem "Phụ lục") |
| LXC không đặc quyền (template Ubuntu 24.04) + gói apt | Không dùng | LAPI là một tiến trình Go nhẹ nên chạy được trong LXC, nhưng Docker không chạy trong LXC (Proxmox không khuyến nghị) nên LXC chỉ hợp với cách apt; vì đã có image chính thức nên chọn Docker; chưa chạy thử trên máy thật | Tạo CT theo bài 07 Bước 11 rồi làm theo "Phụ lục"; CT và VM dùng chung VMID 271 và IP 10.11.35.20 nên không chạy song song |
Vì sao agent và firewall bouncer chạy trực tiếp trên host, không chạy trong container (khớp quy tắc của series: agent chạy trên host như node_exporter, Wazuh agent, Alloy, NUT):
- Bouncer phải nạp bảng/set
crowdsecvào nftables của chính kernel VM cần chặn (hookinputvàforward). Trong container việc đó chỉ làm được khi dùngnetwork_mode: hostcùng capabilityNET_ADMIN(vàNET_RAW), tức gần như đặc quyền, mất ý nghĩa cô lập của container. CrowdSec không công bố image chính thức cho firewall bouncer: tài liệu chỉ hướng dẫn cài gói theo backend (crowdsec-firewall-bouncer-nftables) và các image tìm thấy đều của cộng đồng (kiểm ngày 2026-10-16; cần kiểm lại nếu hãng phát hành sau này). - Bouncer phải chặn được IP xấu kể cả khi Docker daemon trên VM đó dừng hoặc đang khởi động lại; đặt ngoài Docker thì luật nftables sống cùng systemd của VM, hook
forwardcủa bouncer còn chặn cả lưu lượng tới cổng container đã publish (bản v0.0.36 mặc địnhnftables_hooks: input, forward). - Agent cần đọc log của chính VM đó (
/var/log/auth.log,/var/log/syslog, socket Docker để đọc log container). Agent có image riêng và có thể chạy container (DISABLE_LOCAL_API=true), nhưng 10 VM cần mount log và socket khác nhau; bài chọn gói apt để các VM đồng nhất. - Riêng VM271 không cài bouncer (chỉ là LAPI). Muốn VM271 tự chặn IP xấu thì cài thêm gói
crowdsec-firewall-bouncer-nftablestrên host VM271 và đặtapi_url: http://127.0.0.1:8080/, theo cùng cách ở mục 3.1 (chưa chạy thử, cần kiểm lại trên máy thật).
Phiên bản phần mềm sử dụng (đã xác minh 2026-10-16):
| Thành phần | Phiên bản | Ghi chú |
|---|---|---|
| Hệ điều hành (VM271 và các VM chạy agent) | Ubuntu Server 24.04.5 LTS "Noble Numbat" (ISO ubuntu-24.04.5-live-server-amd64.iso) | 24.04.5 ra ngày 2026-09-10; hỗ trợ chuẩn tới 04/2029. Kernel GA 6.8, systemd 255, OpenSSH 9.6. |
| CrowdSec Security Engine (LAPI, container VM271) | Image crowdsecurity/crowdsec:v1.8.1 (Alpine, bản đầy đủ có plugin notification) | Tag v1.8.1 đẩy lên Docker Hub ngày 2026-09-03 (cùng ngày với GitHub release v1.8.1; latest trỏ cùng bản này). v1.8.2-rc1 (2026-10-13) là bản thử nên không dùng. Bản slim không có plugin notifier (mục 4.3, 4.4 cần bản đầy đủ); bản -debian chỉ cần khi đọc journald (mục 2.2). Tag ghim, không dùng latest. |
| CrowdSec agent (gói apt trên các VM khác) | crowdsec 1.8.1 (repo packagecloud.io/crowdsec/crowdsec suite noble) | Chỉ mục Packages của suite noble có crowdsec_1.8.1_amd64.deb (kiểm 2026-10-16); cài đúng =1.8.1 để khớp LAPI. Gói crowdsec trong kho Ubuntu (universe) là bản 1.4.6, cũ hơn nhiều, nên phải thêm repo CrowdSec (mục 3.1). |
| Firewall bouncer (gói apt trên các VM khác) | crowdsec-firewall-bouncer-nftables 0.0.36 | Bản mới nhất có trong suite noble của repo (kiểm 2026-10-16); GitHub đã có v0.0.38 (2026-09-29) nhưng chưa thấy trong repo. Ubuntu 24.04 dùng nftables (ufw dùng backend iptables-nft); cấu hình ở /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml, ghi đè bằng .yaml.local (từ v0.0.25). |
| Docker Engine (VM271) | docker-ce 29.9.1, Compose plugin 5.6.0 (repo download.docker.com/linux/ubuntu suite noble) | docker-ce_29.9.1 đăng 2026-10-14, docker-compose-plugin_5.6.0 đăng 2026-10-02 (kiểm trên pool noble ngày 2026-10-16). Gỡ docker.io, docker-compose-v2 của Ubuntu trước khi cài (mục 1.4). |
| Metabase (tùy chọn, container VM271) | v0.47.8 (image ghim) | Giữ nguyên bản ghim; CrowdSec đã ngừng cscli dashboard (Metabase) và chỉ hỗ trợ chính thức Console, nên chỉ mở cổng 3000 cho VLAN quản trị (mục 2.6). |
| Wazuh agent (VM271) | 4.14.9-1 | Khớp manager 4.14.9 của bài 17. |
| proxmox-backup-client | proxmox-backup-client-static 4.x, repo pbs-client suite trixie | Bản tĩnh nên không phụ thuộc glibc của noble; cần kiểm lại trên máy thật (mục 4.6). |
Tạo VM trên Proxmox
Tải Ubuntu ISO (nếu chưa có) · Tạo VM · Cài đặt Ubuntu 24.04
1.1 Tải Ubuntu ISO (nếu chưa có)
wget -O /var/lib/vz/template/iso/ubuntu-24.04-server.iso \
https://releases.ubuntu.com/24.04/ubuntu-24.04.5-live-server-amd64.iso
1.2 Tạo VM
Cách 1: Web UI Proxmox (GUI)
- VM ID:
271 - Name:
crowdsec - Bỏ tick Start after created
- Storage:
local(hoặc nơi chứa ISO) - ISO Image:
ubuntu-24.04-server.iso - Guest OS Type:
Linux, Version:6.x - 2.6 Kernel
- Machine:
q35 - SCSI Controller:
VirtIO SCSI single - BIOS:
SeaBIOS - Qemu Agent: ☑
- Bus/Device:
SCSI 0, Storage:vm-ceph - Disk size:
20 GiB, Cache:Write back, Discard: ☑
- Sockets:
1, Cores:2, Type:x86-64-v2-AES
- Memory (MiB):
2048
- Bridge:
vmbr0, VLAN Tag:35, Model:VirtIO (paravirtualized), Firewall: ☐
Cách 2: CLI (qm create)
qm create 271 --name crowdsec --memory 2048 --cores 2 --sockets 1 \
--net0 virtio,bridge=vmbr0,tag=35 \
--scsi0 vm-ceph:20,cache=writeback \
--ide2 local:iso/ubuntu-24.04-server.iso,media=cdrom \
--boot "order=ide2;scsi0" \
--ostype l26 --machine q35 --bios seabios \
--agent 1 --serial0 socket --vga serial0
qm start 271
1.3 Cài đặt Ubuntu 24.04
Theo dõi console qua qm terminal 271:
- Username:
sysadmin, hostname:crowdsec - Ubuntu Pro: Skip for now (nếu màn hình này xuất hiện)
- SSH: Install OpenSSH server ✓
1.4 Cấu hình sau cài đặt
# Ubuntu 24.04 có needrestart: đặt chế độ tự động để apt không hiện hộp thoại hỏi khởi động lại dịch vụ
export NEEDRESTART_MODE=a
apt update && apt upgrade -y
apt install -y qemu-guest-agent curl wget git vim net-tools ufw ca-certificates
# Docker Engine chạy LAPI CrowdSec (mục 2) và Metabase (mục 2.6). Gỡ gói Docker của Ubuntu (nếu có) rồi cài
# Docker CE từ repo chính thức, suite noble, nguồn deb822 + Signed-By (giống bài 22 mục 2.3)
apt remove -y docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null || true
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources << EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version && docker compose version # bài đã kiểm với docker-ce 29.9.1 và Compose plugin 5.6.0 (repo noble, 2026-10-16)
systemctl enable --now qemu-guest-agent docker
# Static IP
ip -br link # xem tên NIC thật (ens18, enp6s18...) vì máy q35 có thể không phải ens18
NIC=$(ip -br link | awk '$1!="lo"{print $1; exit}')
echo "NIC = $NIC"
# Ubuntu 24.04 ghi mạng của bản cài vào /etc/netplan/50-cloud-init.yaml (DHCP); giữ nguyên tệp đó thì DHCP
# cộng dồn với IP tĩnh. Tắt phần mạng của cloud-init rồi thay bằng một tệp duy nhất:
echo 'network: {config: disabled}' > /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
rm -f /etc/netplan/*.yaml
cat > /etc/netplan/01-netcfg.yaml << EOF
network:
version: 2
ethernets:
${NIC}:
addresses: [10.11.35.20/24]
routes:
- to: default
via: 10.11.35.1
nameservers:
addresses: [10.11.45.53]
search: [hoatranlabs.local]
EOF
chmod 600 /etc/netplan/01-netcfg.yaml
netplan apply # nếu đang SSH bằng IP DHCP thì phiên sẽ đứt; đăng nhập lại bằng 10.11.35.20
# Tin cậy root CA của step-CA: chạy script distribute-root-ca.sh ở bài 13 Bước 9 (cài step-cli 0.31.0, tải root CA,
# update-ca-certificates). Cần cho webhook HTTPS của Mattermost (mục 4.4) và TLS cho LAPI (mục 4.5); container CrowdSec
# mượn bộ chứng chỉ của host (mục 2.2) nên phải làm bước này TRƯỚC khi chạy container
ls -l /usr/local/share/ca-certificates/hoatranlabs-root.crt
# Firewall. LAPI và Metabase chạy network_mode: host (mục 2.2) nên các luật UFW dưới đây lọc được thật sự
# (cổng publish bằng `-p` của Docker đi vòng UFW, xem ghi chú ở mục 2.2)
ufw default deny incoming
ufw default allow outgoing
ufw allow from 10.11.0.0/16 to any port 22 proto tcp comment 'SSH'
# LAPI 8080: chỉ 10 VM chạy agent/bouncer (authentik, prometheus, harbor, gitea, step-ca, mailu, pihole, vault, thehive, mattermost)
for ip in 10.11.25.40 10.11.45.35 10.11.45.39 10.11.45.40 10.11.25.42 10.11.35.46 10.11.45.53 10.11.25.10 10.11.25.11 10.11.65.57; do
ufw allow from "$ip" to any port 8080 proto tcp comment 'CrowdSec LAPI'
done
ufw allow from 10.11.45.35 to any port 6060 proto tcp comment 'Prometheus scrape CrowdSec'
ufw allow from 10.11.45.35 to any port 9100 proto tcp comment 'Prometheus node_exporter (bài 15)'
ufw allow from 10.11.45.0/24 to any port 3000 proto tcp comment 'Metabase (VLAN MGMT)' # đổi theo VLAN của máy quản trị
ufw --force enable
ufw status numbered
10.11.35.20:8080 (và Prometheus tới :6060) đi qua FortiGate; cần có chính sách cho phép TCP 8080 từ các VM trên tới VM271 và TCP 6060 từ 10.11.45.35 (cần kiểm lại theo chính sách thực tế của lab).
Cài đặt CrowdSec LAPI Server (VM271)
Cài CrowdSec (image Docker chính thức) · Cấu hình LAPI — docker-compose.yml, cho phép remote agents đăng ký · Cài đặt Collections (Parsers + Scenarios)
LAPI chạy trong container crowdsec (image chính thức, tag v1.8.1) do Docker Compose quản lý ở thư mục /opt/crowdsec. Mọi lệnh trong mục này chạy bằng root trên VM271.
2.1 Cài CrowdSec (image Docker chính thức)
# Thư mục dự án và hai thư mục dữ liệu của LAPI (cùng đường dẫn trên host và trong container)
mkdir -p /opt/crowdsec
install -d -m 0755 /etc/crowdsec/acquis.d /var/lib/crowdsec/data
# Plugin notification của CrowdSec chạy bằng user nobody (uid 65534): thư mục ghi file JSON cho Wazuh (mục 4.3) phải thuộc uid này
install -d -o 65534 -g 65534 -m 0755 /var/log/crowdsec-wazuh
# Tải image đã ghim tag và kiểm phiên bản bên trong (--entrypoint để không khởi chạy LAPI)
docker pull crowdsecurity/crowdsec:v1.8.1
docker run --rm --entrypoint cscli crowdsecurity/crowdsec:v1.8.1 version
Image chính thức có ba biến thể: vX.Y.Z (Alpine, đầy đủ, hãng khuyến nghị cho production), vX.Y.Z-slim (nhỏ hơn 60% nhưng không có plugin notifier và GeoIP) và vX.Y.Z-debian (có systemd/journalctl). Bài dùng Alpine đầy đủ vì mục 4.3 và 4.4 cần plugin file và slack. Từ CrowdSec 1.7.0, thư mục /var/lib/crowdsec/data bắt buộc là volume: nếu không, entrypoint in thông báo "No volume mounted" rồi thoát với mã 0 (mã 0 để tránh vòng lặp khởi động lại với chính sách on-failure, nhưng restart: unless-stopped vẫn khởi động lại container; đó là lý do cần bind mount ngay từ đầu). Nguồn: https://docs.crowdsec.net/u/getting_started/installation/docker và https://hub.docker.com/r/crowdsecurity/crowdsec (kiểm 2026-10-16).
2.2 Cấu hình LAPI — docker-compose.yml, cho phép remote agents đăng ký
# Acquisition cho log của CHÍNH VM271 (agent nội bộ chạy trong container). Ubuntu 24.04 Server có rsyslog nên hai tệp này tồn tại.
# /var/log của host được gắn chỉ-đọc ở /host/var/log (xem compose bên dưới). Image còn một acquis.yaml mặc định trỏ tới
# tệp giả /does/not/exist: bỏ qua tệp đó, nguồn thật đặt ở acquis.d
cat > /etc/crowdsec/acquis.d/vm271.yaml << 'EOF'
filenames:
- /host/var/log/auth.log
- /host/var/log/syslog
labels:
type: syslog
EOF
cd /opt/crowdsec
cat > docker-compose.yml << 'EOF'
# Không khai báo khóa `version:` (Compose v2 coi là lỗi thời và chỉ cảnh báo)
services:
crowdsec:
image: crowdsecurity/crowdsec:v1.8.1 # ghim tag, không dùng :latest
container_name: crowdsec
restart: unless-stopped
# Mạng host: LAPI :8080 và metrics :6060 nghe thẳng trên 10.11.35.20 nên UFW lọc được
# (cổng publish `-p` của Docker đi vòng UFW, xem ghi chú bên dưới)
network_mode: host
environment:
TZ: Asia/Ho_Chi_Minh
GID: "1000" # nhóm sở hữu file SQLite crowdsec.db (1000 = nhóm của sysadmin)
CUSTOM_HOSTNAME: crowdsec # tên machine của agent nội bộ (đọc log VM271) trong LAPI
COLLECTIONS: "crowdsecurity/linux crowdsecurity/sshd crowdsecurity/nginx"
PARSERS: "crowdsecurity/whitelists"
volumes:
- /etc/crowdsec:/etc/crowdsec # cấu hình, credentials, hub, notifications
- /var/lib/crowdsec/data:/var/lib/crowdsec/data # SQLite crowdsec.db + data file (BẮT BUỘC từ 1.7.0)
- /var/log:/host/var/log:ro # log của chính VM271, chỉ đọc
- /var/log/crowdsec-wazuh:/var/log/crowdsec-wazuh # file JSON cho Wazuh agent (mục 4.3)
# Bộ chứng chỉ của host (đã có root CA step-CA, mục 1.4): webhook HTTPS Mattermost, TLS cho LAPI
- /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt:ro
healthcheck:
test: ["CMD", "cscli", "lapi", "status"]
interval: 30s
timeout: 10s
retries: 3
start_period: 120s # lần đầu còn cập nhật Hub, cài collection, đăng ký CAPI
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
EOF
docker compose config -q && echo "compose OK"
docker compose up -d crowdsec
docker compose logs -f crowdsec # lần đầu: "Populating configuration directory...", cập nhật Hub, "Registration to online API done"; Ctrl+C để thoát
docker compose ps # STATUS phải là healthy
# Trên VM271 không cài gói crowdsec, nên tạo lệnh cscli chạy trong container. Các lệnh `cscli ...` ở mục 2.3 trở đi, mục 5 và 6
# (chạy trên VM271) dùng wrapper này; trên các VM agent (mục 3) cscli là lệnh của gói apt
cat > /usr/local/bin/cscli << 'EOF'
#!/bin/sh
exec docker exec -i crowdsec cscli "$@"
EOF
chmod 755 /usr/local/bin/cscli
cscli version
cscli lapi status # dòng cuối: You can successfully interact with Local API (LAPI)
cscli capi status # dòng cuối: You can successfully interact with Central API (CAPI); chạy một lần, đừng lặp liên tục
cscli machines list # có machine "crowdsec" (CUSTOM_HOSTNAME) của agent nội bộ, trạng thái validated
ss -tlnp | grep -E ':8080|:6060'
curl -s http://10.11.35.20:8080/health # {"status":"up"}
Giải thích các lựa chọn trong compose:
-
network_mode: host, không dùngports:: cổng publish của Docker được DNAT trước khi tới chuỗi INPUT mà UFW lọc, nênufw deny/allow ... port 8080không có tác dụng với container publish (tài liệu Docker: https://docs.docker.com/engine/network/packet-filtering-firewalls/). Với mạng host, LAPI nghe trực tiếp trên VM271 nên các luật UFW ở mục 1.4 (chỉ 10 VM agent vào cổng 8080, chỉ Prometheus vào cổng 6060) hoạt động đúng. Đánh đổi: container dùng chung network namespace của VM. Cách khác là giữ mạng bridge và lọc ở chuỗiDOCKER-USERcủa iptables, nhưng luật phải tự nạp lại sau mỗi lần khởi động nên bài không dùng. - Cấu hình LAPI:
config.yamlcủa image Docker đã đặt sẵnlisten_uri: 0.0.0.0:8080và Prometheus0.0.0.0:6060(khác gói apt, chỉ nghe 127.0.0.1) nên không cầnconfig.yaml.localcho LAPI. Log của CrowdSec ghi ra stdout, xem bằngdocker compose logs. -
COLLECTIONS/PARSERS: danh sách cách nhau bằng dấu cách; entrypoint cài lại mỗi lần container khởi động (và tự cài thêm parsercrowdsecurity/docker-logs,crowdsecurity/cri-logs). Khi dữ liệu nằm trên volume, entrypoint còn chạycscli hub updatevàcscli hub upgrademỗi lần khởi động; đặtNO_HUB_UPGRADE: "true"nếu muốn giữ cố định. -
GID: entrypoint đổi nhóm sở hữu file/var/lib/crowdsec/data/crowdsec.dbthành GID này, để tài khoảnsysadminvà container Metabase (mục 2.6) đọc được file. - Healthcheck: image Docker không có HEALTHCHECK sẵn nên bài khai báo
cscli lapi status(docs CrowdSec không có mục healthcheck riêng cho Docker). - Bộ chứng chỉ của host: gắn một tệp nên container giữ bản tại thời điểm tạo; sau khi thêm hoặc đổi root CA trên host phải tạo lại container (
docker compose up -d --force-recreate crowdsec). - Tắt chia sẻ với CrowdSec: mặc định container đăng ký CAPI để nhận community blocklist và gửi tín hiệu; đặt
DISABLE_ONLINE_API: "true"chỉ khi không dùng cả hai (khi đó không có blocklist cộng đồng).
Nếu VM không có rsyslog (ảnh tối giản) thì dùng image crowdsecurity/crowdsec:v1.8.1-debian, gắn thêm /var/log/journal:/run/log/journal:ro và khai báo nguồn source: journalctl với journalctl_filter: ["_SYSTEMD_UNIT=ssh.service"] thay cho hai tệp log ở trên; không đọc đồng thời cả tệp lẫn journald vì SSH sẽ bị đếm trùng (chưa chạy thử, cần kiểm lại trên máy thật).
2.3 Cài đặt Collections (Parsers + Scenarios)
# Collections và parsers đã được entrypoint cài từ biến COLLECTIONS và PARSERS trong docker-compose.yml. Kiểm tra:
cscli hub update
cscli collections list
cscli parsers list
cscli scenarios list
# Thêm mục mới: sửa COLLECTIONS/PARSERS/SCENARIOS trong docker-compose.yml rồi tạo lại container
# COLLECTIONS: "crowdsecurity/linux crowdsecurity/sshd crowdsecurity/nginx crowdsecurity/postfix"
cd /opt/crowdsec && docker compose up -d crowdsec
# Hoặc cài ngay bằng lệnh (bền vì /etc/crowdsec là bind mount, nhưng nên ghi thêm vào compose để cấu hình tái lập được)
cscli collections install crowdsecurity/postfix
Các scenario ssh-bf, ssh-slow-bf nằm trong collection crowdsecurity/sshd; http-probing, http-bad-user-agent, http-sensitive-files, http-crawl-non_statics nằm trong crowdsecurity/base-http-scenarios (collection crowdsecurity/nginx kéo theo), nên không cần cài lẻ từng scenario. Collection này chỉ phục vụ agent nội bộ của VM271; việc phát hiện trên các VM khác do collection cài ở agent (mục 3.1). Ghi chú về tên Hub: chỉ mục Hub ngày 2026-10-16 không có crowdsecurity/linux-pam, crowdsecurity/http-crawl-non-static-extensions và crowdsecurity/port-scan (bản trước của bài dùng ba tên này nên lệnh cài sẽ lỗi); crowdsecurity/docker-logs là parser (không phải collection) và đã được entrypoint cài sẵn; tên scenario đúng là crowdsecurity/http-crawl-non_statics. Scenario quét cổng cần log từ firewall (collection crowdsecurity/iptables, scenario iptables-scan-multi_ports), bài không bật vì VM chưa ghi log gói bị chặn.
2.4 Đăng ký với CrowdSec Console (Community blocklist)
# Đăng ký tài khoản miễn phí tại app.crowdsec.net → Security Engines → lấy enrollment key, rồi enroll instance này:
cscli console enroll --name crowdsec-lapi --tags hoatranlabs <enrollment-key-from-crowdsec-console>
# Vào Console, chấp nhận (accept) instance vừa enroll, sau đó khởi động lại container để áp dụng
cd /opt/crowdsec && docker compose restart crowdsec
cscli console status
# Community blocklist: container đã tự đăng ký CAPI ở lần chạy đầu nên danh sách cộng đồng được kéo về không cần enroll.
# Kiểm tra (có thể mất vài phút sau lần đầu đồng bộ); enroll chỉ để xem alert trên Console và đăng ký thêm blocklist riêng
cscli capi status
cscli decisions list --origin CAPI | head
# Đăng ký blocklist bổ sung: Console → Blocklists (https://docs.crowdsec.net/u/getting_started/post_installation/console_blocklists/)
Hai điểm khác bản trước của bài: lệnh cscli bouncers add community-blocklist-puller không phải cách bật community blocklist nên đã bỏ; lệnh cscli console enable console_management cũng bỏ vì image 1.8.1 ghi tùy chọn tương ứng (ENABLE_CONSOLE_MANAGEMENT) là deprecated and ignored: quản lý quyết định tự bật theo gói của Console. Có thể truyền khóa enroll bằng biến ENROLL_KEY (kèm ENROLL_INSTANCE_NAME, ENROLL_TAGS) trong compose, nhưng entrypoint chạy lại cscli console enroll ở mỗi lần container khởi động và khóa nằm trong docker inspect; nếu dùng thì đặt khóa trong /opt/crowdsec/.env (quyền 600) rồi tham chiếu ${ENROLL_KEY} (chưa chạy thử, cần kiểm lại trên máy thật).
2.5 Tạo API key cho remote agents
# Chạy trên VM271. Mỗi VM cần một API key cho bouncer và một machine (login + password) cho agent.
# Credentials sinh ra nằm ở /etc/crowdsec/agents (trong container cũng là /etc/crowdsec/agents), quyền 600
umask 077
mkdir -p /etc/crowdsec/agents
LAPI_URL=http://10.11.35.20:8080
for vm in vm234 vm235 vm239 vm240 vm242 vm246 vm247 vm269 vm270 vm272; do
# 1) API key cho bouncer của VM đó (key ngẫu nhiên chữ-số; tên gợi nhớ theo VMID)
KEY=$(openssl rand -hex 24)
cscli bouncers add "${vm}-bouncer" --key "$KEY" > /dev/null
printf '%s\n' "$KEY" > "/etc/crowdsec/agents/${vm}-bouncer.key"
# 2) Machine cho agent: --auto tự sinh mật khẩu và ghi file credentials (login, password, url) sẵn sàng chép sang VM đích.
# Bắt buộc có -f: không có -f thì cscli đòi ghi đè /etc/crowdsec/local_api_credentials.yaml (credentials của agent nội bộ) và báo lỗi
# "credentials file ... already exists". Bắt buộc có -u: URL mặc định trong container là http://0.0.0.0:8080
cscli machines add "${vm}-agent" --auto -u "$LAPI_URL" -f "/etc/crowdsec/agents/${vm}-agent.yaml"
done
umask 022
ls -l /etc/crowdsec/agents/
cscli bouncers list
cscli machines list # machine tạo bằng `cscli machines add` đã validated sẵn, không cần approve
Thay vì --auto, có thể đặt mật khẩu: cscli machines add vm235-agent --password '<mật-khẩu>' -u "$LAPI_URL" -f /dev/null (như entrypoint của image đăng ký machine phụ), rồi tự ghi login, password, url vào local_api_credentials.yaml trên VM đích; bài dùng --auto để mật khẩu ngẫu nhiên, không phải nhớ hay ghi vào script. Sau khi chép file sang các VM agent ở mục 3.1, xóa thư mục /etc/crowdsec/agents (shred -u /etc/crowdsec/agents/*; rmdir /etc/crowdsec/agents) để bản sao lưu PBS không chứa credentials dạng rõ.
Cách khác, không phải tạo trước từng machine: bật tự đăng ký trên LAPI rồi để agent tự đăng ký bằng token (tài liệu https://docs.crowdsec.net/u/user_guides/multiserver_setup; token tối thiểu 32 ký tự, chỉ cho dải IP của lab):
# /etc/crowdsec/config.yaml.local trên VM271 (rồi docker compose restart crowdsec)
api:
server:
auto_registration:
enabled: true
token: "<token-dai-it-nhat-32-ky-tu>"
allowed_ranges:
- 10.11.25.0/24
- 10.11.35.0/24
- 10.11.45.0/24
- 10.11.65.0/24
Trên agent: cscli lapi register --machine vm235-agent --url http://10.11.35.20:8080 --token <token>. Bài chọn cscli machines add vì rõ ràng hơn và không để một token đăng ký còn hiệu lực trên LAPI; cách này chưa chạy thử, cần kiểm lại trên máy thật.
2.6 Cài đặt Metabase Dashboard
Mục này tùy chọn. CrowdSec đã ngừng lệnh cscli dashboard (Metabase) và chỉ hỗ trợ chính thức Console cùng Prometheus/Grafana (mục 4.2); lý do được hãng nêu là công cụ hạn chế và có lỗ hổng chưa vá vì phiên bản Metabase gắn với binary (https://docs.crowdsec.net/blog/cscli_dashboard_deprecation). Metabase ở đây là container tự quản lý, bản ghim v0.47.8 đã cũ nên chỉ mở cổng 3000 cho VLAN quản trị (UFW ở mục 1.4) và cần kiểm lại trên máy thật.
mkdir -p /opt/crowdsec/metabase
cd /opt/crowdsec
# Nối thêm service vào cuối docker-compose.yml (cùng mức thụt lề với service crowdsec)
cat >> docker-compose.yml << 'EOF'
metabase:
image: metabase/metabase:v0.47.8
container_name: crowdsec-metabase
restart: unless-stopped
network_mode: host # nghe :3000 trên VM271, UFW lọc (mục 1.4)
group_add: ["1000"] # cùng GID với file crowdsec.db (biến GID của service crowdsec)
depends_on:
crowdsec:
condition: service_healthy
environment:
MB_DB_TYPE: h2
MB_DB_FILE: /metabase-data/metabase.db
JAVA_OPTS: "-Xmx768m" # VM271 chỉ có 2 GB RAM
volumes:
- /opt/crowdsec/metabase:/metabase-data
- /var/lib/crowdsec/data/crowdsec.db:/metabase-data/crowdsec.db:ro
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
EOF
docker compose config -q && docker compose up -d metabase
Sau khi Metabase khởi động (~2 phút), truy cập http://10.11.35.20:3000:
[email protected] / Hoatran@2024!/metabase-data/crowdsec.db (crowdsec.db là SQLite; H2 chỉ là CSDL nội bộ của Metabase, MB_DB_TYPE: h2)alerts, decisions); template Metabase do cscli dashboard cung cấp không còn được CrowdSec phát hành nên bài không còn bước import template (tên bảng cần kiểm lại trên máy thật)
Cài đặt CrowdSec Agent trên mỗi VM
Script cài đặt agent + bouncer (chạy trên VM đích) · Approve tất cả agents trên LAPI (chạy trên VM271) · Acquisition file cho VM có Docker
Thực hiện script sau trên từng VM trong hạ tầng. Agent và firewall bouncer được cài trực tiếp trên host bằng gói apt (không dùng container; lý do ở bảng "Phương án triển khai" phần Thông tin VM), nối về LAPI trong container ở VM271.
3.1 Script cài đặt agent + bouncer (chạy trên VM đích)
#!/bin/bash
# Chạy bằng root trên VM đích (VM234, 235, 239, 240, 242, 246, 247, 269, 270, 272). Thay các biến cho từng VM.
#
# Bước 0 — trên VM271, với mỗi VM (ví dụ vm235 = 10.11.45.35): chép hai file sinh ở mục 2.5 sang VM đích
# scp /etc/crowdsec/agents/vm235-agent.yaml /etc/crowdsec/agents/vm235-bouncer.key [email protected]:/tmp/
set -euo pipefail
THIS_VM="vm235" # Tên VM (vm235, vm240, v.v.)
LAPI_URL="http://10.11.35.20:8080" # LAPI trong container trên VM271 (mục 2)
CRED_SRC="/tmp/${THIS_VM}-agent.yaml" # credentials của machine, sinh ở mục 2.5
BOUNCER_KEY="$(cat "/tmp/${THIS_VM}-bouncer.key")" # API key của bouncer, sinh ở mục 2.5
export DEBIAN_FRONTEND=noninteractive NEEDRESTART_MODE=a
# --- Repo CrowdSec (Ubuntu 24.04: nguồn deb822 + Signed-By, suite noble; suite noble đã kiểm có trong repo ngày 2026-10-16) ---
apt install -y curl gpg ca-certificates
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://packagecloud.io/crowdsec/crowdsec/gpgkey | gpg --dearmor -o /etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg
chmod 644 /etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg
cat > /etc/apt/sources.list.d/crowdsec.sources << 'SRCEOF'
Types: deb
URIs: https://packagecloud.io/crowdsec/crowdsec/ubuntu/
Suites: noble
Components: main
Signed-By: /etc/apt/keyrings/crowdsec_crowdsec-archive-keyring.gpg
SRCEOF
apt update
apt-cache policy crowdsec # Candidate phải là 1.8.1 từ packagecloud.io, không phải bản 1.4.6 của kho Ubuntu
# --- Cài agent đúng bản với LAPI (1.8.1) ---
# Không đăng ký CAPI trên từng VM agent (chỉ LAPI ở VM271 làm việc đó): trả lời trước câu hỏi debconf của gói
echo 'crowdsec crowdsec/capi boolean false' | debconf-set-selections
apt install -y crowdsec=1.8.1
systemctl stop crowdsec # gói tự khởi động crowdsec kèm LAPI cục bộ; dừng lại để chuyển sang chế độ agent-only
# --- Chế độ agent-only: tắt LAPI cục bộ, trỏ về LAPI trung tâm ---
# Chỉ ghi phần cần đổi vào config.yaml.local (CrowdSec tự gộp lên config.yaml của gói), KHÔNG ghi đè config.yaml:
# bản trước của bài ghi đè toàn bộ config.yaml bằng các khóa cũ (log_max_backups, log_compress, pid_dir, hub_branch...)
# không còn trong config mẫu của 1.8.1
cat > /etc/crowdsec/config.yaml.local << 'CONFEOF'
api:
server:
enable: false # không chạy LAPI cục bộ; agent gửi alert tới LAPI trên VM271
prometheus:
listen_addr: 0.0.0.0 # cho Prometheus scrape cổng 6060 (UFW chỉ mở cho 10.11.45.35, xem cuối script)
CONFEOF
# Credentials của machine ${THIS_VM}-agent: machine này đã được tạo và validated trên LAPI bằng
# `cscli machines add --auto` ở mục 2.5, nên chỉ chép file credentials vào, KHÔNG chạy `cscli lapi register`
install -m 600 "$CRED_SRC" /etc/crowdsec/local_api_credentials.yaml
# --- Collections và acquisition ---
cscli hub update
# Khi cài, gói tự chạy `cscli setup unattended`: phát hiện dịch vụ rồi sinh /etc/crowdsec/acquis.d/setup.*.yaml
# (Ubuntu 24.04: setup.linux.yaml đọc /var/log/syslog và kern.log; setup.sshd.yaml đọc /var/log/auth.log nếu có rsyslog,
# nếu không thì đọc journald của ssh.service; thêm tệp nginx nếu VM có nginx cài trực tiếp). Bài dùng đúng cơ chế này
# và KHÔNG ghi tay acquis.yaml để tránh đọc trùng nguồn (sự kiện SSH sẽ bị đếm hai lần)
ls -l /etc/crowdsec/acquis.d/
head -n 20 /etc/crowdsec/acquis.d/setup.*.yaml || true
cscli collections list # phải có crowdsecurity/linux và crowdsecurity/sshd; nếu thiếu: cscli collections install crowdsecurity/linux crowdsecurity/sshd
# --- Firewall bouncer nftables ---
apt install -y crowdsec-firewall-bouncer-nftables
# postinst của bouncer thử tạo API key bằng cscli trên chính VM này; LAPI nằm ở VM271 nên key đó vô dụng. Ghi đè api_url và
# api_key bằng file .local (có từ bouncer v0.0.25, không bị gói ghi đè khi nâng cấp); các khóa khác giữ mặc định của gói
# (mode nftables, update_frequency 10s, bảng ip crowdsec / ip6 crowdsec6, hook input + forward, deny_action DROP)
cat > /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local << BEOF
api_url: ${LAPI_URL}/
api_key: ${BOUNCER_KEY}
BEOF
chmod 600 /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local
# --- Khởi động services ---
systemctl daemon-reload
systemctl enable crowdsec crowdsec-firewall-bouncer
systemctl restart crowdsec crowdsec-firewall-bouncer
sleep 5
systemctl status crowdsec --no-pager
systemctl status crowdsec-firewall-bouncer --no-pager
# Kiểm tra kết nối với LAPI và bảng nftables của bouncer
cscli lapi status # dòng cuối: You can successfully interact with Local API (LAPI)
nft list tables # có table ip crowdsec và table ip6 crowdsec6
tail -n 5 /var/log/crowdsec-firewall-bouncer.log
# Metrics của agent cho Prometheus (chỉ máy Prometheus 10.11.45.35 được vào cổng 6060); bỏ qua nếu VM không dùng UFW.
# Riêng VM235: Prometheus chạy trong container nên nguồn kết nối tới 10.11.45.35:6060 là IP bridge Docker, không phải 10.11.45.35
# (cần kiểm lại trên máy thật)
command -v ufw >/dev/null && ufw allow from 10.11.45.35 to any port 6060 proto tcp comment 'Prometheus scrape CrowdSec agent' || true
Lưu ý về script:
- Thứ tự cài: agent cài và chuyển sang chế độ agent-only trước, bouncer cài sau. Nếu bouncer báo không tạo được API key trong lúc cài thì bình thường vì key thật lấy từ LAPI và đặt ở
.yaml.local. Nếu VM đã dùng cổng 8080 cho ứng dụng khác thì gói không tự khởi động crowdsec; không ảnh hưởng vì script tự khởi động sau khi tắt LAPI cục bộ (hành vi của postinst gói 1.8.1; chưa chạy thử trên noble, cần kiểm lại trên máy thật). - Chặn cả cổng container: bouncer mặc định nạp luật ở cả hook
inputvàforwardcủa nftables với priority -10 (config mẫu v0.0.36), chạy trước luật iptables-nft của Docker nên IP bị ban cũng không vào được cổng container đã publish trên VM đó (cần kiểm lại trên máy thật). - Nâng cấp: nâng LAPI trước (đổi tag image, mục 5), rồi mới nâng gói
crowdsecvà bouncer trên các VM; giữ cùng phiên bản1.8.1giữa LAPI và agent.
3.2 Approve tất cả agents trên LAPI (chạy trên VM271)
# Machine tạo bằng `cscli machines add` (mục 2.5) đã được validated sẵn nên không cần approve từng cái;
# chỉ cần kiểm tra trên LAPI sau khi các agent khởi động
ssh [email protected]
sudo -i
cscli machines list # cột Status phải là validated (✔️); Last Heartbeat có giá trị khi agent đã kết nối
cscli bouncers list # cột Valid là ✔️; Last API pull có giá trị sau khoảng 10 giây khi bouncer chạy
# CHỈ khi có machine chưa validated (ví dụ agent tự đăng ký bằng `cscli lapi register`
# thay vì được tạo ở mục 2.5) mới approve thủ công:
cscli machines validate vm235-agent
3.3 Acquisition file cho VM có Docker
Thêm vào /etc/crowdsec/acquis.d/docker.yaml trên VMs chạy Docker (mỗi VM chỉ giữ các container có trên VM đó), rồi systemctl restart crowdsec. Agent chạy bằng root nên đọc được socket Docker. Với nguồn source: docker, labels.type phải là kiểu log của ứng dụng trong container (parser tương ứng), không phải docker: ví dụ container nginx dùng type: nginx (tài liệu datasource Docker: https://docs.crowdsec.net/docs/next/log_processor/data_sources/docker/).
---
source: docker
container_name:
- nginx-thehive # VM270 (Bài 35)
- mattermost-nginx # VM272 (Bài 37)
labels:
type: nginx
# Cần collection nginx trên agent: cscli collections install crowdsecurity/nginx
Các container còn lại (thehive VM270, mattermost-app VM272, gitea VM240) chỉ thêm khi đã cài collection tương ứng trên Hub và đặt đúng labels.type theo README của collection đó. Chỉ mục Hub ngày 2026-10-16 có crowdsecurity/thehive và LePresidente/gitea; bản trước của bài gán type: docker cho mọi container, nhưng parser crowdsecurity/docker-logs chỉ xử lý dòng JSON của tệp log Docker (filter: evt.Line.Labels.type == 'docker'), không phải luồng log của datasource Docker (cần kiểm lại trên máy thật).
Tích hợp với hạ tầng
Pi-hole DNS · Prometheus Monitoring · Wazuh Integration
4.1 Pi-hole DNS
# Thêm DNS record crowdsec.hoatranlabs.local → 10.11.35.20
# Cách 1: Pi-hole Admin UI → Settings → Local DNS Records (Domain: crowdsec.hoatranlabs.local, IP: 10.11.35.20)
# Cách 2: SSH vào VM Pi-hole (chạy Docker), thêm dòng add_dns "crowdsec.hoatranlabs.local" "10.11.35.20"
# vào /opt/pihole/scripts/add_dns_records.sh (Bài 12) rồi chạy lại script
ssh [email protected]
4.2 Prometheus Monitoring
# prometheus.yml (VM235) — thêm CrowdSec metrics:
- job_name: 'crowdsec-lapi'
static_configs:
- targets: ['10.11.35.20:6060'] # LAPI trong container (network host), nghe 0.0.0.0:6060
metrics_path: /metrics
- job_name: 'crowdsec-agents'
static_configs:
# Agent (gói apt) trên từng VM; metrics bật ở mục 3.1 (config.yaml.local: prometheus.listen_addr 0.0.0.0)
- targets:
- '10.11.25.40:6060' # VM234 authentik
- '10.11.45.35:6060' # VM235 prometheus
- '10.11.45.39:6060' # VM239 harbor
- '10.11.45.40:6060' # VM240 gitea
- '10.11.25.42:6060' # VM242 step-ca
- '10.11.35.46:6060' # VM246 mailu
- '10.11.45.53:6060' # VM247 pihole
- '10.11.25.10:6060' # VM269 vault
- '10.11.25.11:6060' # VM270 thehive
- '10.11.65.57:6060' # VM272 mattermost
metrics_path: /metrics
Dashboard Grafana: import các dashboard do CrowdSec phát hành trên grafana.com (tổ chức crowdsec; mã nguồn crowdsecurity/grafana-dashboards): ID 19013 (Crowdsec Local API metrics, dùng cho job crowdsec-lapi), 19010 (Crowdsec security engines overview), 19012 (Crowdsec Details per security engine) và 19011 (Crowdsec Insights), nguồn dữ liệu Prometheus. ID 14584 mà bản trước của bài ghi là "CrowdSec Dashboard" thực ra là dashboard ArgoCD nên đã bỏ (kiểm trên grafana.com ngày 2026-10-16).
4.3 Wazuh Integration
CrowdSec → Wazuh: khi CrowdSec ban một IP, plugin file của LAPI (chạy trong container) ghi quyết định ra file JSON trong thư mục /var/log/crowdsec-wazuh/ (bind mount từ VM271, mục 2.2); Wazuh agent trên VM271 (cài theo Bài 17 mục 7.2) đọc file này và gửi về Wazuh manager (VM280, 10.11.45.25) qua cổng agent 1514. Cổng 1514 là cổng giao thức agent của Wazuh (không phải HTTP webhook) nên không POST trực tiếp vào đó.
- Trên VM271 (LAPI): ghi mỗi quyết định ban thành 1 dòng JSON bằng notification plugin
file:
cat > /etc/crowdsec/notifications/file.yaml << 'EOF'
type: file
name: wazuh-file
log_level: info
# Mỗi quyết định = 1 dòng JSON để Wazuh đọc được (log_format json)
format: '{{range . }}{{range .Decisions }}{"crowdsec_decision":{"ip":"{{.Value}}","reason":"{{.Scenario}}","duration":"{{.Duration}}","action":"{{.Type}}"}}{{"\n"}}{{end}}{{end}}'
# Thư mục này là bind mount từ host (mục 2.2) và thuộc uid 65534, vì plugin chạy bằng user nobody:
# ghi thẳng vào /var/log/ sẽ lỗi permission denied. File tạo ra có quyền 644 nên Wazuh agent đọc được
log_path: /var/log/crowdsec-wazuh/decisions.json
rotate:
enabled: true
max_size: 10 # MB
max_files: 5
max_age: 5 # ngày
compress: true
EOF
# Kết nối profile với notification.
# Profile tùy chỉnh đặt trong profiles.yaml.local: file này được đọc TRƯỚC profiles.yaml (docs CrowdSec).
# Không append vào cuối profiles.yaml: profile mặc định default_ip_remediation có on_success: break
# nên với alert IP sẽ không bao giờ xét tới profile đứng sau nó.
# Khối decisions giống profile mặc định (ban 4h); cần có để alert gửi tới plugin đã chứa Decisions
# (template ở trên range .Decisions). on_success: break để profile này thay luôn profile mặc định cho alert IP:
# mỗi alert chỉ tạo MỘT quyết định ban (nếu để continue thì profile này và profile mặc định đều tạo quyết định ban)
cat > /etc/crowdsec/profiles.yaml.local << 'EOF'
name: hoatranlabs_ip_notification
filters:
- Alert.Remediation == true && Alert.GetScope() == "Ip"
decisions:
- type: ban
duration: 4h
notifications:
- wazuh-file
on_success: break
EOF
cd /opt/crowdsec && docker compose restart crowdsec
cscli notifications list
cscli notifications test wazuh-file # gửi alert thử tới plugin dù chưa gắn profile
ls -l /var/log/crowdsec-wazuh/ # file decisions.json do uid 65534 sở hữu
tail -n 3 /var/log/crowdsec-wazuh/decisions.json # mỗi quyết định = 1 dòng JSON (alert thử có thể không chứa Decisions; cần kiểm lại trên máy thật)
- Wazuh agent trên VM271: thêm vào
/var/ossec/etc/ossec.conf(trong khối<ossec_config>):
<localfile>
<log_format>json</log_format>
<location>/var/log/crowdsec-wazuh/decisions.json</location>
</localfile>
systemctl restart wazuh-agent
- Wazuh manager (VM280, chạy Docker — Bài 17 mục 5.6): thêm rule nhận các dòng JSON này vào
local_rules.xmltrong container managersingle-node-wazuh.manager-1(thư mục/var/ossec/etcnằm trong volumesingle-node_wazuh_etc), rồi restart container:
docker exec -i single-node-wazuh.manager-1 bash -c 'cat >> /var/ossec/etc/rules/local_rules.xml' << 'EOF'
<group name="crowdsec,">
<rule id="100200" level="10">
<decoded_as>json</decoded_as>
<field name="crowdsec_decision.action">^ban$</field>
<description>CrowdSec: ban IP $(crowdsec_decision.ip) - $(crowdsec_decision.reason)</description>
</rule>
</group>
EOF
docker restart single-node-wazuh.manager-1
4.4 Mattermost Alerts
cat > /etc/crowdsec/notifications/slack.yaml << 'EOF'
type: slack
name: mattermost-security
log_level: info
# Template nhận DANH SÁCH alert: range qua alert, rồi qua .Decisions (Value/Scenario/Duration là trường của Decision)
format: |
{{range . -}}
{{$alert := . -}}
{{range .Decisions -}}
:rotating_light: **CrowdSec Alert**
IP **{{.Value}}** banned for `{{.Scenario}}`
Duration: `{{.Duration}}`
Reason: {{range $alert.Meta}}{{if eq .Key "service"}}{{.Value}}{{end}}{{end}}
{{end -}}
{{end -}}
webhook: https://mattermost.hoatranlabs.local/hooks/<id-security> # webhook kênh #security (Bài 37 mục 3.3)
group_wait: 60s
group_threshold: 5
EOF
# Gắn notification vào profile: ghi lại profiles.yaml.local của mục 4.3, liệt kê cả hai notification trong MỘT profile
# (không append profile thứ hai: hai profile on_success: continue cùng profile mặc định sẽ tạo quyết định ban lặp)
cat > /etc/crowdsec/profiles.yaml.local << 'EOF'
name: hoatranlabs_ip_notification
filters:
- Alert.Remediation == true && Alert.GetScope() == "Ip"
decisions:
- type: ban
duration: 4h
notifications:
- wazuh-file
- mattermost-security
on_success: break
EOF
cd /opt/crowdsec && docker compose restart crowdsec
cscli notifications test mattermost-security # tin thử xuất hiện ở kênh #security
Plugin slack gọi webhook HTTPS của Mattermost nên container phải tin root CA step-CA: container dùng bộ chứng chỉ của host (mục 2.2), vì vậy root CA cần có trên host trước (mục 1.4). Nếu log báo x509: certificate signed by unknown authority thì chạy lại update-ca-certificates trên host rồi docker compose up -d --force-recreate crowdsec.
4.5 step-CA TLS (tùy chọn cho LAPI)
# Lấy cert để mã hóa lưu lượng LAPI (chạy trên VM271; step-cli đã có từ script bài 13 Bước 9)
mkdir -p /etc/crowdsec/ssl
step ca certificate crowdsec.hoatranlabs.local \
/etc/crowdsec/ssl/crowdsec.crt \
/etc/crowdsec/ssl/crowdsec.key \
--san crowdsec.hoatranlabs.local --san 10.11.35.20 \
--ca-url https://step-ca.hoatranlabs.local:9000 \
--root /usr/local/share/ca-certificates/hoatranlabs-root.crt --not-after 2160h
chmod 600 /etc/crowdsec/ssl/crowdsec.key
# Bật TLS cho LAPI: thêm các biến sau vào service crowdsec trong /opt/crowdsec/docker-compose.yml (phần environment), rồi chạy lại
# USE_TLS: "true"
# LAPI_CERT_FILE: /etc/crowdsec/ssl/crowdsec.crt
# LAPI_KEY_FILE: /etc/crowdsec/ssl/crowdsec.key
# LOCAL_API_URL: https://crowdsec.hoatranlabs.local:8080 # agent nội bộ trong container cũng đi qua TLS
cd /opt/crowdsec && docker compose up -d crowdsec
# Cập nhật tất cả agent và bouncer dùng https:// (tên host phải khớp SAN của cert; VM agent đã tin root CA nhờ bài 13 Bước 9):
# /etc/crowdsec/local_api_credentials.yaml: url: https://crowdsec.hoatranlabs.local:8080
# /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local: api_url: https://crowdsec.hoatranlabs.local:8080/
# rồi trên mỗi VM: systemctl restart crowdsec crowdsec-firewall-bouncer
Các biến USE_TLS, LAPI_CERT_FILE, LAPI_KEY_FILE, LOCAL_API_URL lấy từ entrypoint của image v1.8.1 (khi USE_TLS bật, entrypoint ghi api.server.tls.cert_file và key_file); mục này chưa chạy thử trên máy thật, cần kiểm lại. Cert hiệu lực 2160 giờ (90 ngày): gia hạn bằng step ca renew (bài 13 Bước 11) rồi docker compose restart crowdsec.
4.6 PBS Backup
# Cài proxmox-backup-client (bản static, không phụ thuộc glibc của Ubuntu 24.04) từ client-only repository công khai của Proxmox.
# Suite "trixie" là suite có bản static mới nhất (đã kiểm repo ngày 2026-10-15); chạy trên noble: cần kiểm lại trên máy thật
wget https://enterprise.proxmox.com/debian/proxmox-archive-keyring-trixie.gpg \
-O /usr/share/keyrings/proxmox-archive-keyring.gpg
cat > /etc/apt/sources.list.d/pbs-client.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pbs-client
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
apt update && apt install -y proxmox-backup-client-static
# Token + namespace tạo sẵn theo Bài 04 mục 5.7 (user vm-backup@pbs, token "crowdsec",
# ACL DatastoreBackup tại /datastore/syno-primary/vm-crowdsec)
export PBS_PASSWORD='<TOKEN_SECRET>' # secret của token vm-backup@pbs!crowdsec
# Ba thư mục cần sao lưu: cấu hình + credentials + hub (/etc/crowdsec), SQLite crowdsec.db (/var/lib/crowdsec/data),
# và thư mục dự án Docker (/opt/crowdsec: docker-compose.yml, dữ liệu Metabase). Backup chính của VM vẫn là job vzdump
# tới pbs-primary; bản in-VM là file-level, chép file SQLite đang mở nên có thể không nhất quán tuyệt đối (cần kiểm lại trên máy thật)
proxmox-backup-client backup \
crowdsec-config.pxar:/etc/crowdsec \
crowdsec-data.pxar:/var/lib/crowdsec/data \
crowdsec-compose.pxar:/opt/crowdsec \
--repository 'vm-backup@[email protected]:syno-primary' \
--ns vm-crowdsec
Quản lý decisions hàng ngày
# Trên VM271, `cscli` là wrapper chạy trong container (mục 2.2)
# Xem quyết định ban hiện tại
cscli decisions list
# Ban IP thủ công
cscli decisions add --ip 1.2.3.4 --duration 24h --reason "manual-block"
# Unban IP
cscli decisions delete --ip 1.2.3.4
# Xem alerts
cscli alerts list
# Metrics tổng quan
cscli metrics
# Hub update (cập nhật parsers/scenarios)
cscli hub update && cscli hub upgrade
# Nâng cấp LAPI: sao lưu (mục 4.6), đổi tag image trong docker-compose.yml (tag mới xem ở
# https://hub.docker.com/r/crowdsecurity/crowdsec/tags), rồi kéo image và tạo lại container
cd /opt/crowdsec
docker compose pull crowdsec && docker compose up -d crowdsec
docker compose logs --tail 50 crowdsec
# Quay lại bản cũ: đặt lại tag cũ rồi `docker compose up -d crowdsec` (dữ liệu nằm ở /etc/crowdsec và /var/lib/crowdsec/data
# nên không mất; nếu bản mới đã nâng cấp schema SQLite thì khôi phục từ bản sao lưu)
Kiểm tra & Xác minh
# 1. LAPI health (chạy trên VM được UFW cho phép, ví dụ VM235; trên VM271 dùng 127.0.0.1)
curl -s http://10.11.35.20:8080/health
# Expected: {"status":"up"}
# 2. Container LAPI (trên VM271)
cd /opt/crowdsec && docker compose ps # crowdsec: healthy
docker compose logs --tail 30 crowdsec
cscli lapi status
cscli capi status
# 3. Machines registered
cscli machines list
# 4. Bouncer trên LAPI
cscli bouncers list
# 5. Agent nội bộ của VM271 đọc và parse được log
cscli metrics show acquisition parsers
# 6. Test ban thủ công và verify nftables. Bouncer chạy trên VM agent (ví dụ VM235), không phải VM271
# Trên VM271:
cscli decisions add --ip 192.0.2.1 --duration 5m --reason "test"
# Trên VM235, chờ khoảng 10 giây cho bouncer cập nhật (update_frequency):
sleep 10
nft list table ip crowdsec | grep 192.0.2.1 # IP phải xuất hiện trong set
# 7. Xóa test ban (trên VM271)
cscli decisions delete --ip 192.0.2.1
# 8. Prometheus metrics (trên VM271; Prometheus VM235 scrape qua 10.11.35.20:6060)
curl -s http://127.0.0.1:6060/metrics | grep -m 5 cs_
# 9. Metabase dashboard (tùy chọn)
echo "Truy cập: http://10.11.35.20:3000"
Lưu ý khi thử phát hiện thật: parser crowdsecurity/whitelists mặc định bỏ qua log từ IP riêng (xem mục "Whitelist"), nên brute-force SSH thử từ máy trong lab sẽ không tạo alert; dùng cscli decisions add như bước 6 để thử đường LAPI → bouncer.
Troubleshooting
Whitelist IP nội bộ (quan trọng — tránh ban nhầm)
| Vấn đề | Nguyên nhân | Giải pháp |
|---|---|---|
| Agent không kết nối được LAPI | UFW trên VM271 hoặc FortiGate chặn cổng 8080; IP VM chưa có trong danh sách UFW ở mục 1.4 | ufw status numbered trên VM271, thêm ufw allow from <IP VM> to any port 8080 proto tcp; kiểm chính sách FortiGate; từ VM agent: curl -s http://10.11.35.20:8080/health |
Container crowdsec thoát rồi khởi động lại liên tục, log "No volume mounted for /var/lib/crowdsec/data" | Thiếu volume cho thư mục dữ liệu (bắt buộc từ 1.7.0); entrypoint thoát với mã 0, còn restart: unless-stopped vẫn khởi động lại | Khai báo bind mount /var/lib/crowdsec/data:/var/lib/crowdsec/data trong compose rồi docker compose up -d |
Container unhealthy | Còn cập nhật Hub hoặc đăng ký CAPI trong 120 giây đầu; hoặc cscli lapi status lỗi | Chờ hết start_period; docker compose logs crowdsec; cscli lapi status |
cscli machines add báo "credentials file ... already exists" | Thiếu -f: cscli đòi ghi vào /etc/crowdsec/local_api_credentials.yaml của agent nội bộ | Luôn thêm -f <tệp> (hoặc -f /dev/null) như mục 2.5 |
machine not validated | Machine tự đăng ký bằng cscli lapi register chưa được approve ở LAPI (machine tạo bằng cscli machines add ở mục 2.5 được validated sẵn) | cscli machines validate <name> trên VM271 |
| Bouncer không block IP | Bouncer chưa chạy, thiếu bảng nftables hoặc api_url/api_key sai | systemctl status crowdsec-firewall-bouncer, nft list tables, tail /var/log/crowdsec-firewall-bouncer.log |
invalid api key ở bouncer | Key trong crowdsec-firewall-bouncer.yaml.local sai | Trên VM271: cscli bouncers delete <name> rồi cscli bouncers add <name> --key <key>; cập nhật key trên VM |
| Nhiều false positives | Scenario quá nhạy | cscli decisions delete --all + allowlist/whitelist IP nội bộ |
| Metabase không thấy data | Bind mount crowdsec.db sai hoặc không đọc được | Kiểm tra volume trong compose, ls -la /var/lib/crowdsec/data/ (nhóm sở hữu file là GID ở mục 2.2) |
| Agent không parse nginx log | Acquisition type sai | Type phải là nginx không phải syslog (kể cả nguồn source: docker ở mục 3.3) |
| Community blocklist không sync | Container chưa đăng ký CAPI hoặc VM271 không ra được Internet | cscli capi status; thiếu credentials thì cscli capi register rồi docker compose restart crowdsec; enroll Console chỉ để xem trên Console và đăng ký blocklist bổ sung |
Notification file báo permission denied | Thư mục log không thuộc uid 65534 (plugin chạy bằng nobody) | chown 65534:65534 /var/log/crowdsec-wazuh, docker compose restart crowdsec |
Webhook Mattermost lỗi x509: certificate signed by unknown authority | Container chưa tin root CA step-CA | Mục 4.4: update-ca-certificates trên host rồi docker compose up -d --force-recreate crowdsec |
| Cổng 8080 mở cho mọi máy dù có luật UFW | Dùng ports: (bridge) thay vì network_mode: host: cổng publish của Docker đi vòng UFW | Dùng mạng host như mục 2.2 |
Whitelist IP nội bộ (quan trọng — tránh ban nhầm)
Có hai lớp, dùng cả hai:
- Mặc định: parser
crowdsecurity/whitelists(cài sẵn trong image và gói) đã bỏ qua log từ::1,127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16(nội dung file trên Hub, kiểm 2026-10-16). Lớp này chỉ tác động khi agent parse log; nó không ngăn một IP trong danh sách cộng đồng (CAPI) hoặc quyết định thủ công trúng IP quản trị của bạn. - Allowlist tập trung trên LAPI (CrowdSec 1.6.8 trở lên, tài liệu v1.8: https://docs.crowdsec.net/docs/local_api/centralized_allowlists/): LAPI bỏ alert có IP trong danh sách, loại IP đó khỏi blocklist trước khi lưu và
cscli decisions addbị chặn nếu không có cờ đặc biệt. Cần kiểm lại trên máy thật rằng alert do agent từ xa gửi tới cũng bị LAPI bỏ.
# Trên VM271 (wrapper cscli). -d (mô tả) là bắt buộc khi tạo allowlist
cscli allowlists create hoatranlabs-internal -d "Mang noi bo hoatranlabs.local va site phu"
cscli allowlists add hoatranlabs-internal 127.0.0.1 10.11.0.0/16 10.100.100.0/24 172.16.0.0/12 -d "lab hoatranlabs"
# Thêm IP WAN công cộng của site và IP quản trị khi cần: cscli allowlists add hoatranlabs-internal <WAN_IP>
cscli allowlists inspect hoatranlabs-internal
Thêm whitelist ở tầng parser trên từng agent (tùy chọn, hữu ích để bỏ log từ nguồn cụ thể ngay khi parse, trước khi sinh alert):
# name phải duy nhất (crowdsecurity/whitelists là parser mặc định của CrowdSec); ip: chỉ nhận IP đơn, dải mạng đặt ở cidr:
cat > /etc/crowdsec/parsers/s02-enrich/whitelist.yaml << 'EOF'
name: hoatranlabs/whitelist
description: "Whitelist internal network"
whitelist:
reason: "Internal network - hoatranlabs.local"
ip:
- "127.0.0.1"
cidr:
- "10.11.0.0/16"
- "172.16.0.0/12"
EOF
systemctl restart crowdsec # trên VM agent; trên VM271: cd /opt/crowdsec && docker compose restart crowdsec
Checklist triển khai
- VM271 tạo thành công, IP 10.11.35.20, VLAN 35
- Docker Engine + Compose plugin cài từ repo noble; UFW trên VM271 chỉ mở 8080 cho 10 VM agent và 6060 cho Prometheus
- Container
crowdsec(imagecrowdsecurity/crowdsec:v1.8.1) healthy,/healthtrả về{"status":"up"} - Collections installed: linux, sshd, nginx (kèm http-probing trong base-http-scenarios)
- Đăng ký CrowdSec Console, community blocklist active (
cscli decisions list --origin CAPI) - Metabase dashboard chạy tại
http://10.11.35.20:3000(tùy chọn) - DNS record crowdsec.hoatranlabs.local
- Agent (gói
crowdsec1.8.1) + bouncer nftables (gói apt) cài trên: VM234, VM235, VM239, VM240, VM242, VM246, VM247, VM269, VM270, VM272 - Tất cả machines validated tại LAPI (
cscli machines list), đã xóa/etc/crowdsec/agentstrên VM271 - Allowlist
hoatranlabs-internal(10.11.0.0/16) trên LAPI - Test ban IP qua
cscli decisions add→ kiểm tra nftables trên agent VM - Prometheus scrape LAPI metrics thành công; dashboard Grafana 19013
- Mattermost webhook cho #security channel
- Wazuh notification khi CrowdSec ban IP
- PBS backup config, data và /opt/crowdsec
Phụ lục: Phương án thay thế — cài apt toàn phần (không Docker)
Dùng khi không muốn Docker daemon trên VM271 (hoặc khi chuyển LAPI sang LXC theo bảng "Phương án triển khai"). Đường dẫn dữ liệu vẫn là /etc/crowdsec và /var/lib/crowdsec/data, nên backup PBS (mục 4.6), mục 2.3 đến 2.5 và mục 3 dùng nguyên.
# Chạy trên VM271 bằng root. Thêm repo CrowdSec như đầu mục 3.1 (nguồn deb822, suite noble), rồi:
export DEBIAN_FRONTEND=noninteractive NEEDRESTART_MODE=a
apt install -y crowdsec=1.8.1
cat > /etc/crowdsec/config.yaml.local << 'EOF'
api:
server:
listen_uri: 0.0.0.0:8080 # gói chỉ nghe 127.0.0.1:8080 theo mặc định
prometheus:
listen_addr: 0.0.0.0 # gói chỉ nghe 127.0.0.1:6060 theo mặc định
EOF
systemctl restart crowdsec
cscli lapi status
ss -tlnp | grep -E ':8080|:6060'
Khác với cách Docker:
-
csclilà lệnh của gói (bỏ wrapper ở mục 2.2);docker compose restart crowdsecthànhsystemctl restart crowdsec; xem log bằngjournalctl -u crowdsec. - Collections cài bằng lệnh
cscli collections install ...(không có biếnCOLLECTIONS); acquisition của VM271 docscli setup unattendedtạo khi cài gói, như agent ở mục 3.1. - Plugin notification chạy bằng
nobody:nogroup: tạo thư mục Wazuh bằnginstall -d -o nobody -g nogroup -m 0755 /var/log/crowdsec-wazuh. - UFW lọc bình thường vì dịch vụ chạy trực tiếp trên host (giống mạng host ở cách Docker); Metabase vẫn chạy bằng container (compose riêng, bỏ
depends_on). - Chuyển từ Docker sang apt: sao lưu (mục 4.6),
docker compose down, cài gói, giữ nguyênlocal_api_credentials.yaml,online_api_credentials.yamlvà/var/lib/crowdsec/datađể các agent và bouncer không phải đăng ký lại.config.yamlkiểu Docker ghi log ra stdout còn gói ghi log ra file, nên cần đối chiếu vớiconfig.yamlmẫu của gói. Chuyển ngược lại: dừng dịch vụ, chạy compose ở mục 2.2 trên cùng hai thư mục dữ liệu. Chưa chạy thử cả hai chiều trên máy thật, cần kiểm lại. - LXC không đặc quyền (template Ubuntu 24.04, tạo theo bài 07 Bước 11, CTID
271): làm theo phụ lục này bên trong CT; Docker không chạy trong LXC nên chỉ có cách apt; chưa chạy thử.
Cập nhật: 2026-10-16 (CrowdSec LAPI chạy Docker; Ubuntu Server 24.04 LTS)