第一步：准备先修课程

服务器最低规格：
启动时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的先决条件

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

新节点：初始化指令

# 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秘密。不要分享。

官方原文：Linux 节点安装说明 |Pi网络