Cài Đặt OV-Node
Hướng dẫn chi tiết cách cài đặt và kết nối Node vào OpenVPN Panel
Giới thiệu về OV-Node
OV-Node là dịch vụ backend chạy trên các máy chủ OpenVPN, cho phép Panel quản lý từ xa thông qua REST API. Mỗi Node là một máy chủ OpenVPN độc lập được điều khiển bởi Master Panel.
Kiến Trúc Hệ Thống
Mô hình Master-Node trong hệ thống OpenVPN Panel
┌─────────────────────┐
│ OpenVPN Panel │ (Master - Quản lý tập trung)
│ (Master Node) │
└──────────┬──────────┘
│
│ REST API (Port 9090)
│
┌─────┴─────┬──────────┬──────────┐
│ │ │ │
┌────▼────┐ ┌───▼────┐ ┌───▼────┐ ┌───▼────┐
│ OV-Node │ │OV-Node │ │OV-Node │ │OV-Node │
│ Server1 │ │Server2 │ │Server3 │ │Server4 │
└─────────┘ └────────┘ └────────┘ └────────┘Yêu Cầu Hệ Thống
Hệ Điều Hành
- Ubuntu 20.04/22.04 LTS
- Debian 10/11
- CentOS 7/8
Phần Cứng Tối Thiểu
- CPU: 1 vCPU (2 vCPU khuyến nghị)
- RAM: 1GB (2GB khuyến nghị)
- Disk: 10GB dung lượng trống
- Network: Public IP address
Yêu Cầu Mạng
- Port 1194/UDP: OpenVPN service
- Port 9090/TCP: OV-Node API (có thể tùy chỉnh)
- Firewall phải cho phép kết nối từ Master Panel
Cài Đặt Tự Động (Khuyến Nghị)
Script tự động sẽ cài đặt OpenVPN và OV-Node trong vài phút
Chuẩn bị hệ thống
Cập nhật và cài đặt các gói cần thiết
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv wget curl gitTạo API Key ngẫu nhiên (lưu lại để sử dụng sau):
python3 -c "import uuid; print(uuid.uuid4())"
# Output ví dụ: 7f8c9d4e-1a2b-3c4d-5e6f-7a8b9c0d1e2fDownload và chạy script
Script sẽ tự động cài đặt tất cả
cd /tmp
wget https://node-vpn.nginxwaf.me/install.sh
chmod +x install.sh
sudo bash install.shLưu ý
Script sẽ hiển thị menu, chọn option 1. Install OV-Node
Cấu hình OpenVPN
Trả lời các câu hỏi về cấu hình OpenVPN
Cấu hình OV-Node
Nhập thông tin cho OV-Node service
⚠️ Quan trọng
Lưu lại API Key! Bạn sẽ cần nó khi kết nối Node vào Panel
Xác minh cài đặt
Kiểm tra service đã chạy thành công
# Kiểm tra service status
sudo systemctl status ov-node
# Kiểm tra OpenVPN
sudo systemctl status openvpn-server@server
# Test API
curl -X POST http://localhost:9090/sync/get-status \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"set_new_setting": false}'✅ Kết quả mong đợi:
{
"success": true,
"msg": "Node status retrieved successfully",
"data": {
"status": "running",
"cpu_usage": 15.2,
"memory_usage": 45.8
}
}Cấu Hình Firewall
Mở các port cần thiết để Panel có thể kết nối
Ubuntu/Debian (UFW)
# Mở port OV-Node API
sudo ufw allow 9090/tcp
# Mở port OpenVPN
sudo ufw allow 1194/udp
# Bật firewall
sudo ufw enable
# Kiểm tra
sudo ufw statusCentOS/RHEL (firewalld)
# Mở port OV-Node API
sudo firewall-cmd --permanent --add-port=9090/tcp
# Mở port OpenVPN
sudo firewall-cmd --permanent --add-port=1194/udp
# Reload firewall
sudo firewall-cmd --reload
# Kiểm tra
sudo firewall-cmd --list-allCloud Provider
Nếu Node chạy trên cloud (AWS, GCP, Azure), bạn cũng cần mở port trên Security Group:
- • TCP Port 9090 từ IP của Panel
- • UDP Port 1194 từ 0.0.0.0/0 (cho VPN clients)
Kết Nối Node Vào Panel
Sau khi cài đặt thành công, thêm Node vào Panel để quản lý
Lấy thông tin Node
Thu thập thông tin cần thiết từ Node
# Public IP
curl ifconfig.me
# API Key
sudo cat /opt/ov-node/.env | grep API_KEY
# Service Port
sudo cat /opt/ov-node/.env | grep SERVICE_PORTTruy cập Panel
Đăng nhập vào OpenVPN Panel
Truy cập Panel tại: http://your-panel-domain/
Vào menu Node Management
Thêm Node mới
Điền thông tin Node và test kết nối
Click nút Add Node và điền thông tin:
Click Test Connection trước khi lưu để đảm bảo kết nối thành công
Xác minh hoạt động
Kiểm tra Node đã kết nối thành công
Sau khi lưu, kiểm tra:
- Node hiển thị status "Online"
- CPU và RAM được cập nhật
- Thử tạo một user test
Tiếp Theo
Tìm hiểu thêm về quản lý và vận hành Node