Pi Node Installation Guide Hướng dẫn Cài đặt Pi Node

Run Pi Node to earn mining rewards and support the Pi Network ecosystem. Chạy Pi Node để nhận thưởng đào và hỗ trợ hệ sinh thái Pi Network

Why Run a Pi Node? Tại sao nên chạy Pi Node?

Earn Node Mining Bonus Nhận thưởng đào từ Node

  • Increase your mining rate easily Tăng tốc độ đào dễ dàng
  • Bonus based on uptime and CPU contribution Thưởng dựa trên thời gian hoạt động và CPU
  • Long-term participation yields higher rewards Tham gia lâu dài nhận thưởng cao hơn

Support Network Security Hỗ trợ bảo mật mạng

  • Help validate transactions Giúp xác thực giao dịch
  • Contribute to decentralization Góp phần phi tập trung hóa
  • Strengthen Pi ecosystem security Tăng cường bảo mật hệ sinh thái Pi

Network Participation Tham gia mạng lưới

  • Become an active validator Trở thành trình xác thực
  • Participate in consensus mechanisms Tham gia cơ chế đồng thuận
  • Help maintain blockchain integrity Duy trì tính toàn vẹn blockchain

Future Opportunities Cơ hội tương lai

  • Access node-exclusive features Truy cập tính năng riêng cho Node
  • Participate in network governance Tham gia quản trị mạng
  • Early access to new Pi developments Tiếp cận sớm các phát triển mới

Requirements Overview (Windows) Yêu cầu hệ thống (Windows)

Hardware Phần cứng

  • Windows 10/11 (64-bit) Windows 10/11 (64-bit)
  • 4GB RAM minimum Tối thiểu 4GB RAM
  • Stable internet connection Kết nối internet ổn định
  • SSD recommended for better performance SSD được khuyến nghị

Network Mạng

  • Open ports 31400-31409 Mở cổng 31400-31409
  • Static IP recommended IP tĩnh được khuyến nghị
  • Port forwarding access Truy cập chuyển tiếp cổng
  • Unlimited data plan preferred Gói dữ liệu không giới hạn

Software Phần mềm

  • Pi Desktop app Ứng dụng Pi Desktop
  • Docker Desktop (optional) Docker Desktop (tùy chọn)
  • Admin privileges Quyền quản trị
  • WSL 2 for Docker method WSL 2 cho phương pháp Docker

Ready to start? Follow our step-by-step installation guides below to set up your Pi Node. Sẵn sàng bắt đầu? Làm theo hướng dẫn cài đặt từng bước dưới đây.

Get Started Now Bắt đầu ngay

Installation Guides Hướng dẫn cài đặt

Docker Desktop is required for running Pi Node using Docker. Please complete this installation before proceeding with the Pi Node setup.

Docker Desktop là bắt buộc để chạy Pi Node bằng Docker. Vui lòng hoàn thành cài đặt này trước khi tiến hành cài đặt Pi Node.

Prerequisites Yêu cầu trước

  • Windows 10/11 (64-bit) Windows 10/11 (64-bit)
  • Administrator privileges on your PC Quyền quản trị trên máy tính
  • At least 4GB RAM (8GB recommended) Tối thiểu 4GB RAM (khuyến nghị 8GB)
  • WSL 2 capability (Windows Subsystem for Linux) Hỗ trợ WSL 2 (Windows Subsystem for Linux)

Installation Steps Các bước cài đặt

1

Download Docker Desktop Tải Docker Desktop

Visit Docker Desktop's official website and download the Windows installer.

Truy cập trang web chính thức của Docker Desktop và tải trình cài đặt Windows.

Click the "Download for Windows" button

Nhấp vào nút "Download for Windows"

Save the installer file to your computer

Lưu file cài đặt vào máy tính

2

Run the Installer Chạy trình cài đặt

Install Docker Desktop with default settings.

Cài đặt Docker Desktop với cài đặt mặc định.

Double-click the downloaded installer file

Nhấp đúp vào file cài đặt đã tải

Accept the license agreement

Chấp nhận thỏa thuận cấp phép

Keep all default options selected

Giữ nguyên tất cả tùy chọn mặc định

Click "Install" and wait for completion

Nhấp "Install" và chờ hoàn tất

3

Enable WSL 2 Features Bật tính năng WSL 2

Allow Docker to enable necessary Windows features.

Cho phép Docker bật các tính năng Windows cần thiết.

When prompted, allow Docker Desktop to enable WSL 2 features

Khi được nhắc, cho phép Docker Desktop bật tính năng WSL 2

Follow any additional prompts to install WSL 2 components

Làm theo hướng dẫn để cài đặt thành phần WSL 2

Restart your computer if requested

Khởi động lại máy tính nếu được yêu cầu

4

Start Docker Desktop Khởi động Docker Desktop

Launch Docker and verify the installation.

Khởi động Docker và kiểm tra cài đặt.

Launch Docker Desktop from the Start menu

Khởi động Docker Desktop từ menu Start

Wait for the Docker engine to start (whale icon in system tray turns solid)

Chờ động cơ Docker khởi động (biểu tượng cá voi hiện màu)

Accept the Docker Desktop Service Agreement if prompted

Chấp nhận thỏa thuận dịch vụ nếu được nhắc

5

Verify Installation Kiểm tra cài đặt

Confirm Docker is properly installed.

Xác nhận Docker đã được cài đặt đúng.

Open Command Prompt or PowerShell

Mở Command Prompt hoặc PowerShell

Run docker --version to verify Docker is installed

Chạy docker --version để kiểm tra

If you encounter any issues with WSL 2, you can run wsl --update in an elevated Command Prompt to ensure you have the latest version.

Nếu gặp vấn đề với WSL 2, chạy wsl --update trong Command Prompt với quyền admin để cập nhật phiên bản mới nhất.

Troubleshooting Khắc phục sự cố

WSL 2 Installation Failed Cài đặt WSL 2 thất bại

Run wsl --install in an elevated Command Prompt

Chạy wsl --install trong Command Prompt với quyền admin

Docker Desktop Won't Start Docker Desktop không khởi động

Ensure Hyper-V and Windows Hypervisor Platform are enabled in Windows Features

Đảm bảo Hyper-V và Windows Hypervisor Platform được bật trong Tính năng Windows

Performance Issues Vấn đề hiệu năng

In Docker Desktop settings, adjust the resources allocated to WSL 2

Trong cài đặt Docker Desktop, điều chỉnh tài nguyên phân bổ cho WSL 2

Most users should use the desktop installer. Only switch to Docker if the desktop installation fails or the port checker remains stuck.

Hầu hết người dùng nên sử dụng trình cài đặt desktop. Chỉ chuyển sang Docker nếu cài đặt desktop thất bại hoặc trình kiểm tra cổng bị treo.

Prerequisites Yêu cầu trước

  • Windows 10/11 (64-bit) Windows 10/11 (64-bit)
  • Internet connection with the ability to open ports 31400–31409 Kết nối internet có thể mở cổng 31400–31409
  • Administrator privileges on your PC Quyền quản trị trên máy tính

Installation Steps Các bước cài đặt

1

Install the Pi Node Desktop App Cài đặt ứng dụng Pi Node Desktop

Download and install the official Pi Node desktop app.

Tải và cài đặt ứng dụng Pi Node desktop chính thức.

Download from node.minepi.com

Tải từ node.minepi.com

Run the installer, following on-screen prompts

Chạy trình cài đặt, làm theo hướng dẫn trên màn hình

Log in with your Pi credentials

Đăng nhập bằng thông tin Pi của bạn

Enable WSL integration if prompted

Bật tích hợp WSL nếu được nhắc

2

Open Ports 31400–31409 Mở cổng 31400–31409

Configure your router and firewall to allow Pi Node connections.

Cấu hình router và tường lửa để cho phép kết nối Pi Node.

Router Port Forwarding Chuyển tiếp cổng trên router

Access your router's admin panel (often at 192.168.1.1 or 192.168.0.1)

Truy cập bảng quản trị router (thường tại 192.168.1.1 hoặc 192.168.0.1)

Locate Port Forwarding or NAT settings

Tìm cài đặt Chuyển tiếp cổng hoặc NAT

Forward TCP ports 31400–31409 to your local machine's IP

Chuyển tiếp cổng TCP 31400–31409 đến IP máy cục bộ

Save and apply changes

Lưu và áp dụng thay đổi

Windows Firewall Tường lửa Windows

Open Windows Security → Firewall & network protection → Advanced settings

Mở Bảo mật Windows → Tường lửa & bảo vệ mạng → Cài đặt nâng cao

Create Inbound Rules for TCP ports 31400–31409

Tạo quy tắc đến cho cổng TCP 31400–31409

Allow connections on Private (and if needed, Public) networks

Cho phép kết nối trên mạng Riêng (và Công cộng nếu cần)

If you're behind CGNAT or on a mobile connection, you may not have a true public IP. Your incoming connections might remain at 0 in that scenario.

Nếu bạn đang sử dụng CGNAT hoặc kết nối di động, có thể bạn không có IP công cộng thực sự. Kết nối đến có thể vẫn là 0 trong trường hợp này.

3

Run and Verify Pi Node Chạy và kiểm tra Pi Node

Launch the Pi Node app and verify it's working correctly.

Khởi động ứng dụng Pi Node và kiểm tra hoạt động.

Launch the Pi Node desktop app

Khởi động ứng dụng Pi Node desktop

In the Port Checker, verify that some or all of the ports show as open

Trong trình kiểm tra cổng, xác nhận một số hoặc tất cả cổng hiển thị là mở

Click "Turn Node On" in the Pi Desktop app

Nhấp "Bật Node" trong ứng dụng Pi Desktop

You should see: "Your computer is running the blockchain"

Bạn sẽ thấy: "Máy tính của bạn đang chạy blockchain"

If the port checker shows "Failed" even with correct port forwarding setup, this is normal if you're using CGNAT. You can still run the node.

Nếu trình kiểm tra cổng hiển thị "Thất bại" dù đã cấu hình đúng, điều này là bình thường nếu bạn dùng CGNAT. Bạn vẫn có thể chạy node.

4

Status Checks Kiểm tra trạng thái

Verify your node is properly synced with the network.

Kiểm tra node đã đồng bộ đúng với mạng lưới.

State: Should become "Synced!"

Trạng thái: Nên hiển thị "Đã đồng bộ!"

Latest Block: Typically less than a minute old

Khối mới nhất: Thường cách dưới 1 phút

Outgoing Connections: Should be greater than 0 once the node finds peers

Kết nối đi: Nên lớn hơn 0 khi node tìm thấy peer

Incoming Connections: May be 0 if you lack a public IP

Kết nối đến: Có thể là 0 nếu không có IP công cộng

Optional: Docker Method If Desktop App Fails Tùy chọn: Phương pháp Docker nếu ứng dụng Desktop thất bại

Pull the Pi Node Docker Image Tải image Docker Pi Node

Docker Login: If needed, run docker login and verify your Docker Hub account/email

Đăng nhập Docker: Nếu cần, chạy docker login và xác minh tài khoản/email Docker Hub

Pull the image: docker pull pinetwork/pi-node-docker

Tải image: docker pull pinetwork/pi-node-docker

Follow the Docker-specific instructions provided by the Pi Network team for complete setup.

Làm theo hướng dẫn cụ thể Docker từ đội ngũ Pi Network để hoàn tất cài đặt.

Frequently Asked Questions Câu hỏi thường gặp

How is my Node Bonus calculated? Phần thưởng Node được tính như thế nào?

Your node bonus (N) is calculated using the formula:

Phần thưởng node (N) được tính bằng công thức:

N(I) = node_factor • tuning_factor • I

The three main factors that affect your bonus are:

Ba yếu tố chính ảnh hưởng đến phần thưởng:

Uptime Thời gian hoạt động
  • The percentage of time your node is online
  • Tỷ lệ thời gian node hoạt động
  • Measured over different periods (90d, 360d, 2y, 10y)
  • Đo lường qua các khoảng thời gian (90d, 360d, 2y, 10y)
  • Longer periods have higher weightage
  • Khoảng thời gian dài hơn có trọng số cao hơn
Port Accessibility Khả năng truy cập cổng
  • The percentage of time your ports are open
  • Tỷ lệ thời gian cổng mở
  • Affects network connectivity
  • Ảnh hưởng kết nối mạng
  • Higher accessibility leads to better bonus
  • Khả năng truy cập cao hơn dẫn đến phần thưởng tốt hơn
CPU Contribution Đóng góp CPU
  • The average CPU resources provided
  • Tài nguyên CPU trung bình được cung cấp
  • Measured as average CPU count over time
  • Đo lường bằng số CPU trung bình theo thời gian
  • Higher CPU contribution increases bonus
  • Đóng góp CPU cao hơn tăng phần thưởng

The final bonus value is normalized using a tuning factor to ensure it falls between 0 and 10.

Giá trị phần thưởng cuối cùng được chuẩn hóa bằng hệ số điều chỉnh để đảm bảo trong khoảng 0 đến 10.

How long does it take to get the Node Bonus? Mất bao lâu để nhận phần thưởng Node?

The Node Bonus typically appears after your current mining session ends. However, it may take a few days for the bonus to be fully calculated and applied.

Phần thưởng Node thường xuất hiện sau khi phiên đào hiện tại kết thúc. Tuy nhiên, có thể mất vài ngày để phần thưởng được tính toán và áp dụng đầy đủ.

If all status checks are showing correctly (Synced state, recent latest block, outgoing connections), your node is properly configured and the bonus should appear soon.

Nếu tất cả kiểm tra trạng thái hiển thị đúng (Trạng thái đồng bộ, khối mới nhất gần đây, kết nối đi), node của bạn được cấu hình đúng và phần thưởng sẽ sớm xuất hiện.

How can I maximize my Node Bonus? Làm sao để tối đa hóa phần thưởng Node?

Important:

Quan trọng:

To maximize your Node Bonus, focus on maintaining high uptime, keeping ports accessible, and ensuring your node has adequate CPU resources. The longer your node maintains good performance, the better your bonus will be.

Để tối đa hóa phần thưởng Node, hãy tập trung duy trì thời gian hoạt động cao, giữ cổng có thể truy cập và đảm bảo node có đủ tài nguyên CPU. Node hoạt động tốt càng lâu, phần thưởng sẽ càng cao.