使用Linux系统安装PiNetwork节点官方说明文档

在Linux上安装Pi Node的逐步说明。

第一步：准备先修课程

服务器最低规格：

启动时150GB磁盘空间（理想为300GB）4个vCPUs，4GB内存

基于Debian的近期Linux发行版（建议：Ubuntu 24.04（LTS）x64）

Docker 前置条件

一个可运行的 Docker 安装：参见 https://docs.docker.com/engine/install/
一个正在运行的 Docker Compose v2 插件：参见 https://docs.docker.com/compose/install/linux/#install-using-the-repository

APT prerequisites

# Install APT prerequisites
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# Add Pi Node’s official GPG key (https://apt.minepi.com/repository.gpg.key)
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://apt.minepi.com/repository.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/pinetwork-archive-keyring.gpg
sudo chmod a+r /etc/apt/keyrings/pinetwork-archive-keyring.gpg

# Add Pi Node’s APT source (https://apt.minepi.com)
echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/pinetwork-archive-keyring.gpg] https://apt.minepi.com stable main' | sudo tee /etc/apt/sources.list.d/pinetwork.list > /dev/null

# Update APT package index
sudo apt-get update

步骤2：安装Pi Node包

sudo apt-get install pi-node

# Verify installation
pi-node --version

步骤3：节点初始化

# Access built-in help
pi-node --help

See below for instructions to start your node. For new node installations continue here. If you are upgrading your existing node, continue here.

New Nodes: Initialization Instructions  //新节点：初始化说明

# Initialize pi-node
pi-node initialize

我应该使用自动更新吗？
自动更新会在发布新版本时，自动将你的主网节点更新到最新版本，并执行所有必要的迁移。有些迁移可能需要几个小时才能完成。如果你想对更新过程有更多控制，你不应该启用自动更新，而是使用

pi-node update-protocol

命令来执行更新。

已有节点：升级说明

如果你在升级，可以按照下面的步骤通过 CLI 使用你之前的节点配置。

步骤1：收集你现有的配置设置

node_seed (from mainnet.env or stellar-core.cfg)
grep -E '^(NODE_SEED|NODE_PRIVATE_KEY)=' ./mainnet.env
docker exec mainnet grep -E 'NODE_SEED' ./stellar-core.cfg

postgres password (from mainnet.env)
grep -E '^POSTGRES_PASSWORD=' ./mainnet.env

docker volumes path (from your old docker-compose.yml)
grep -nE 'volumes:|docker_volumes|/opt/stellar|/var/log/supervisor' ./docker-compose.yml

第2步：停止你现有的节点

docker compose down

可选：使用 cp 备份卷并保留属性和权限。此步骤可能需要很长时间，并且可能会耗尽你的磁盘空间。这是可选的。备份的示例命令：

cp -a <docker_volumes> <docker_volumes.backup>

步骤 3：使用 CLI 初始化你的节点（重用已有的配置）

在运行初始化之前，确保 DOCKER_VOLUMES_PATH 与你之前的设置相匹配：

互动的

pi-node initialize

非交互式（一次性提供所有值的替代方案；对自动化很有用）：

pi-node initialize --pi-folder "$HOME/pi-node" --docker-volumes "./docker_volumes/mainnet" --node-private-key "<seed>" --postgres-password "<password>" --start-node

Pi节点的使用

# Access built-in help
pi-node --help

常见的实用命令如下：

pi-node logs -f         # Follow container logs
pi-node stop            # Stop node containers
pi-node start           # Start node containers
pi-node restart         # Restart node containers
pi-node status          # Check node status
pi-node update-protocol # Update this node to the latest protocol version by updating its Docker container.

# Upgrade Linux CLI package
sudo apt-get update
sudo apt-get install --only-upgrade pi-node

注意：一定要保密你的 NODE_SEED。不要分享它。