Tổng quan

Hướng dẫn này sẽ giúp bạn nhanh chóng thiết lập và chạy G-BlackHole Forwarder trong vài phút. Chúng ta sẽ:

1. Xác thực với Registry (nếu sử dụng)
2. Chạy Forwarder ở foreground để test
3. Cài đặt Forwarder như service

Bước 1: Xác thực với Registry (tùy chọn)

Nếu bạn sử dụng Registry server, hãy xác thực trước:

Windows

# Xác thực với Registry
.\blackhole-fwd.exe auth --key "your-api-key-here"

Linux

# Xác thực với Registry
./blackhole-fwd auth --key "your-api-key-here"

Bước 2: Chạy Forwarder ở Foreground

Test Forwarder bằng cách chạy ở foreground để xem logs trực tiếp:

Windows

# Chạy Forwarder ở foreground với verbose logging
.\blackhole-fwd.exe start --config config.yml --verbose

# Hoặc với log level debug
.\blackhole-fwd.exe start --config config.yml --log-level debug

Linux

# Chạy Forwarder ở foreground với verbose logging
./blackhole-fwd start --config config.yml --verbose

# Hoặc với log level debug
./blackhole-fwd start --config config.yml --log-level debug

Kiểm tra hoạt động:

• Xem logs trên console để đảm bảo Forwarder đang chạy các service
• Kiểm tra MQTT broker đang listen trên port 1883
• Kiểm tra Rsyslog server đang listen trên port 514
• Kiểm tra HTTP proxy đang listen trên port 8080
• Xác nhận dữ liệu được gửi đến sink (Registry nếu đã cấu hình)

Dừng Forwarder:

• Nhấn Ctrl+C để dừng Forwarder

Bước 3: Cài đặt Forwarder như Service

Sau khi test thành công, cài đặt Forwarder như service để chạy tự động:

Windows

# Cài đặt Windows Service
.\blackhole-fwd.exe service install --config config.yml

# Khởi động service
.\blackhole-fwd.exe service start

# Kiểm tra trạng thái service
Get-Service -Name "blackhole-fwd"

Linux

# Cài đặt systemd service
sudo ./blackhole-fwd service install --config config.yml

# Khởi động service
sudo ./blackhole-fwd service start

# Kiểm tra trạng thái service
sudo systemctl status blackhole-fwd

Xác minh cài đặt

Kiểm tra Service Status

Windows:

# Xem trạng thái service
Get-Service -Name "blackhole-fwd"

# Xem logs của service
Get-EventLog -LogName Application -Source "blackhole-fwd" -Newest 10

Linux:

# Xem trạng thái service
sudo systemctl status blackhole-fwd

# Xem logs của service
sudo journalctl -u blackhole-fwd -f

Kiểm tra Ports Listening

# Kiểm tra các port đang listen
netstat -tlnp | grep -E ":(1883|514|8080)"

# Hoặc sử dụng ss command
ss -tlnp | grep -E ":(1883|514|8080)"

Test các Service

Test MQTT Broker

# Test publish message
mosquitto_pub -h localhost -p 1883 -t "test/topic" -m "Hello Forwarder"

# Test subscribe
mosquitto_sub -h localhost -p 1883 -t "test/topic" -v

Test Rsyslog Server

# Test UDP syslog
echo "test syslog message" | nc -u localhost 514

# Test TCP syslog
echo "test syslog message" | nc localhost 514

Test HTTP CONNECT Proxy

# Test proxy connection
curl --proxy http://localhost:8080 https://httpbin.org/ip

# Test với authentication (nếu đã cấu hình)
curl --proxy http://username:password@localhost:8080 https://httpbin.org/ip

Kiểm tra Logs

Windows:

# Xem log files
Get-Content ".\logs\default.log" -Tail 20
Get-Content ".\logs\default-error.log" -Tail 10

Linux:

# Xem log files
tail -f /var/log/blackhole-forwarder/default.log
tail -f /var/log/blackhole-forwarder/default-error.log

Tóm tắt lệnh

Windows

# Quick Start Commands
.\blackhole-fwd.exe auth --key "your-api-key-here"  # Nếu dùng Registry
.\blackhole-fwd.exe start --config config.yml --verbose  # Test
.\blackhole-fwd.exe service install --config config.yml
.\blackhole-fwd.exe service start

Linux

# Quick Start Commands
./blackhole-fwd auth --key "your-api-key-here"  # Nếu dùng Registry
./blackhole-fwd start --config config.yml --verbose  # Test
sudo ./blackhole-fwd service install --config config.yml
sudo ./blackhole-fwd service start