​
Yêu cầu hệ thống

​
Yêu cầu chung

  • Quyền quản trị: Cần quyền administrator/root để cài đặt service
  • Kết nối mạng: Truy cập internet để tải xuống và xác thực với Registry
  • Dung lượng: Tối thiểu 500MB free space
  • Memory: Tối thiểu 1GB RAM
  • Ports: Các port cần thiết cho MQTT broker, rsyslog server, và HTTP proxy

​
Yêu cầu cụ thể theo nền tảng

​
Windows

  • OS: Windows 10/11 hoặc Windows Server 2016+
  • Architecture: x64
  • PowerShell: Version 5.1+ (cho script cài đặt)

​
Linux

  • Distributions: Ubuntu 18.04+, CentOS 7+, RHEL 7+, Debian 9+, Alpine 3.8+
  • Architecture: x86_64, ARM64
  • Systemd: Để quản lý service (khuyến nghị)

​
Cài đặt trên Windows

​
Phương pháp 1: Cài đặt thủ công

  1. Tạo thư mục cài đặt:
# Tạo thư mục cho Forwarder
New-Item -ItemType Directory -Path "C:\Program Files\BlackHoleForwarder" -Force

# Copy file executable
Copy-Item "blackhole-fwd.exe" -Destination "C:\Program Files\BlackHoleForwarder\blackhole-fwd.exe"
  1. Cài đặt như Windows Service:
# Chuyển đến thư mục cài đặt
cd "C:\Program Files\BlackHoleForwarder"

# Cài đặt service
.\blackhole-fwd.exe service install

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

​
Xác minh cài đặt

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

# Xem logs
Get-EventLog -LogName Application -Source "blackhole-fwd" -Newest 10

​
Cài đặt trên Linux

​
Ubuntu/Debian

  1. Cài đặt dependencies:
# Cập nhật package list
sudo apt update

# Cài đặt dependencies cần thiết
sudo apt install -y systemd curl wget
  1. Cài đặt Forwarder:
# Tạo user cho Forwarder
sudo useradd -r -s /bin/false blackhole-forwarder

# Tạo thư mục cài đặt
sudo mkdir -p /opt/blackhole-forwarder
sudo mkdir -p /etc/blackhole-forwarder
sudo mkdir -p /var/log/blackhole-forwarder

# Copy binary
sudo cp blackhole-fwd-linux-x64 /opt/blackhole-forwarder/blackhole-fwd
sudo chmod +x /opt/blackhole-forwarder/blackhole-fwd

# Cài đặt service
sudo /opt/blackhole-forwarder/blackhole-fwd service install

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

​
CentOS/RHEL

# Cài đặt dependencies
sudo yum install -y systemd curl wget

# Thực hiện các bước tương tự như Ubuntu
# (tạo user, thư mục, copy binary, cài đặt service)

​
Alpine Linux (musl)

# Cài đặt dependencies
sudo apk add --no-cache systemd curl wget

# Tạo user cho Forwarder
sudo adduser -D -s /bin/false blackhole-forwarder

# Tạo thư mục cài đặt
sudo mkdir -p /opt/blackhole-forwarder
sudo mkdir -p /etc/blackhole-forwarder
sudo mkdir -p /var/log/blackhole-forwarder

# Copy binary (sử dụng musl build)
sudo cp blackhole-fwd-linux-musl /opt/blackhole-forwarder/blackhole-fwd
sudo chmod +x /opt/blackhole-forwarder/blackhole-fwd

# Cài đặt service
sudo /opt/blackhole-forwarder/blackhole-fwd service install

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

​
Xác minh cài đặt

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

# Xem logs
sudo journalctl -u blackhole-fwd -f

# Kiểm tra process
ps aux | grep blackhole-fwd

​
Cấu hình ban đầu

​
Xác thực với Registry (tùy chọn)

# Xác thực với Registry server (chỉ cần thiết nếu sử dụng Registry)
.\blackhole-fwd.exe auth --key "your-api-key-here"

​
Cài đặt nâng cao

​
Cài đặt với proxy

# Cài đặt với HTTP proxy
.\blackhole-fwd.exe service install --config "config-with-proxy.yml"

​
Cài đặt với custom paths

# Windows - custom install path
.\blackhole-fwd.exe service install --working-directory "D:\BlackHole"

# Linux - custom paths
sudo mkdir -p /custom/path/blackhole-forwarder
sudo cp blackhole-fwd-linux-x64 /custom/path/blackhole-forwarder/blackhole-fwd

​
Gỡ cài đặt

​
Windows

# Dừng và gỡ service
.\blackhole-fwd.exe service stop
.\blackhole-fwd.exe service uninstall

# Xóa thư mục cài đặt
Remove-Item -Recurse -Force "C:\Program Files\BlackHoleForwarder"

​
Linux

# Dừng và xóa service
sudo /opt/blackhole-forwarder/blackhole-fwd service stop
sudo /opt/blackhole-forwarder/blackhole-fwd service uninstall

# Xóa files và user
sudo rm -rf /opt/blackhole-forwarder
sudo rm -rf /etc/blackhole-forwarder
sudo rm -rf /var/log/blackhole-forwarder
sudo userdel blackhole-forwarder

​
Khắc phục sự cố cài đặt

​
Windows

Vấn đềNguyên nhânGiải pháp
Service không khởi độngThiếu quyền hoặc file không tồn tạiKiểm tra quyền và đường dẫn file
Lỗi “Access Denied”Không có quyền administratorChạy PowerShell as Administrator
Service bị lỗiCấu hình sai hoặc thiếu dependenciesKiểm tra Event Log và config file

​
Linux

Vấn đềNguyên nhânGiải pháp
Service failed to startBinary không có quyền thực thichmod +x /opt/blackhole-forwarder/blackhole-fwd
Permission deniedUser không có quyền truy cậpKiểm tra ownership và permissions