HƯỚNG DẪN CÀI ĐẶT PI NODE TRÊN WINDOWS
Tóm tắt
Pi Desktop (Pi Node) là phần mềm giúp người dùng tham gia vận hành hạ tầng mạng Pi Network. Để cài đặt và hoạt động ổn định, máy tính cần đáp ứng các yêu cầu về ảo hóa (Virtualization), WSL 2, Docker Desktop và cấu hình mạng (Port Forwarding). Bài viết dưới đây hướng dẫn các bước cài đặt theo đúng trình tự, phù hợp cho người mới bắt đầu.
Điều kiện trước khi cài đặt
Trước khi bắt đầu, hãy chuẩn bị:
- Máy tính chạy Windows 10/11 64-bit (khuyến nghị cập nhật phiên bản mới nhất).
- Đã kích hoạt bản quyền Windows (khuyến nghị).
- Kết nối Internet ổn định.
- Quyền quản trị (Administrator) trên máy tính.
- Gỡ bỏ các phần mềm ảo hóa cũ nếu đã cài trước đó (Docker Toolbox, VirtualBox cũ, phiên bản Docker Desktop lỗi thời...) và khởi động lại máy.
Lưu ý: Thực hiện đúng trình tự các bước dưới đây để hạn chế lỗi trong quá trình cài đặt.
Bước 1. Kiểm tra Virtualization trong BIOS
Docker và WSL 2 yêu cầu CPU hỗ trợ công nghệ ảo hóa.
Kiểm tra nhanh
- Nhấn Ctrl + Shift + Esc để mở Task Manager.
- Chọn tab Performance (Hiệu năng).
- Chọn CPU.
- Kiểm tra mục Virtualization.
- ✅ Enabled: Có thể tiếp tục.
- ❌ Disabled: Cần vào BIOS để bật Virtualization (Intel VT-x hoặc AMD-V tùy dòng CPU).
Bước 2. Thiết lập mạng Windows
Khuyến nghị:
- Chuyển mạng sang chế độ Private Network.
- Bật Windows Defender Firewall.
Điều này giúp Docker và Pi Desktop hoạt động ổn định hơn trong mạng nội bộ.
Bước 3. Cài đặt WSL 2
Mở Windows PowerShell với quyền Run as Administrator và chạy lần lượt:
Bật Windows Subsystem for Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Bật Virtual Machine Platform
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Sau khi hoàn thành:
- Khởi động lại máy tính.
- Cập nhật Linux Kernel (nếu Windows yêu cầu).
- Thiết lập WSL 2 là phiên bản mặc định:
wsl --set-default-version 2
Lưu ý: Không cần cài đặt thêm bản phân phối Linux nếu chỉ sử dụng Pi Node.
Bước 4. Cài đặt Pi Desktop
- Tải Pi Desktop từ trang chính thức của Pi Network.
- Đăng nhập bằng tài khoản Pi.
- Mở mục Node trong ứng dụng Pi trên điện thoại và nhập mã xác thực hiển thị trên Pi Desktop để liên kết tài khoản.
- Hoàn thành khảo sát (nếu xuất hiện).
- Khi được yêu cầu, cài đặt Docker Desktop theo hướng dẫn.
Bước 5. Cấu hình Port Forwarding
Để Pi Desktop có thể giao tiếp với các nút khác trong mạng, cần mở các cổng:
31400 – 31409
Thực hiện trên modem/router:
- Đăng nhập trang quản trị modem.
- Thiết lập Port Forwarding đến địa chỉ IP của máy tính chạy Pi Node.
Nếu chưa biết cách thực hiện, hãy tra cứu theo từ khóa:
Port Forwarding + tên modem
Bước 6. Thiết lập IP tĩnh
Máy tính chạy Pi Node nên sử dụng IP tĩnh trong mạng LAN.
Việc này giúp các quy tắc Port Forwarding luôn trỏ đúng đến máy tính.
Bước 7. Mở cổng trên Windows Firewall
Trong Windows Defender Firewall with Advanced Security, tạo các quy tắc Inbound Rules cho các cổng:
- 31400
- 31401
- ...
- 31409
Bước 8. Kiểm tra Port
Trong Pi Node, chọn:
Check Ports
Nếu tất cả cổng hiển thị Open, cấu hình đã thành công.
Nếu hiển thị Closed, hãy kiểm tra lại:
- Port Forwarding
- Firewall
- IP tĩnh
- Mạng Internet
Có thể sử dụng thêm các công cụ kiểm tra Port trực tuyến để xác minh.
Bước 9. Khởi động Pi Desktop
Sau khi các cổng đã mở:
- Bật công tắc Node.
- Để Pi Node chạy liên tục.
Bước 10. Thiết lập nguồn điện
Khuyến nghị:
- Tắt chế độ Sleep của Windows.
- Không để máy tự động tắt khi không sử dụng.
Điều này giúp Pi Node hoạt động liên tục.
Một số lưu ý khi vận hành
Nếu mất điện
Khởi động lại theo thứ tự:
- Docker Desktop
- Pi Desktop
- Kiểm tra Port
- Bật Node
Khi Node được chọn chạy Blockchain
Thông thường chỉ cần mở:
- 31401
- 31402
- 31403
Theo dõi các chỉ số:
- Outgoing: Kết nối từ Node của bạn đến các Node khác.
- Incoming: Kết nối từ các Node khác đến Node của bạn.
Nếu Incoming luôn bằng 0, hãy kiểm tra lại Port Forwarding.
Theo dõi Docker
Khi cần kiểm tra trạng thái Blockchain, có thể xem log của các dịch vụ:
- PostgreSQL
- Stellar Core
- Horizon
Nếu một dịch vụ dừng hoạt động, có thể kiểm tra bằng:
supervisorctl status
Khởi động lại dịch vụ (nếu cần):
supervisorctl start horizon
Một số lỗi thường gặp
Check Port hiển thị Not Open
Đây có thể là lỗi hiển thị của Pi Node.
Hãy kiểm tra lại bằng công cụ kiểm tra Port độc lập trước khi kết luận cấu hình chưa đúng.
Chỉ số ngày không cập nhật
Đây là hiện tượng đã từng xảy ra với nhiều Pi Node và thường không ảnh hưởng đến quá trình ghi nhận hoạt động của Node.
Hiển thị N/A
Một số phiên bản Pi Node có thể hiển thị trạng thái N/A sau khi khởi động lại. Nếu Docker vẫn hoạt động bình thường và Node vẫn đồng bộ, thường không cần can thiệp.
Kết luận
Việc cài đặt Pi Node không chỉ dừng ở việc cài phần mềm mà còn bao gồm cấu hình WSL 2, Docker Desktop, Port Forwarding, Firewall và mạng nội bộ. Thực hiện đúng trình tự sẽ giúp giảm đáng kể các lỗi thường gặp và tăng khả năng Pi Node hoạt động ổn định trong thời gian dài.
Khuyến nghị: Luôn sử dụng phiên bản Pi Node và Docker Desktop mới nhất, đồng thời ưu tiên tham khảo tài liệu chính thức của Pi Network vì các yêu cầu kỹ thuật có thể thay đổi theo từng phiên bản.
