阿里云轻量应用服务器安装 Pi Agent:从买机器到跑通第一句
手把手 · 每一步都有网址和命令
深信号·教程

阿里云轻量应用服务器安装 Pi Agent:从买机器到跑通第一句

适用:想给 Pi 一台 7×24 在线的"机房"——跑定时任务、挂服务、接机器人。以阿里云轻量应用服务器(Ubuntu)为例,全程约 15 分钟。

目录(点击跳转)

为什么用轻量服务器第 1 步 · 购买轻量应用服务器第 2 步 · 登录服务器第 3 步 · 更新系统 + 装基础工具第 4 步 · 装 Node 20+第 5 步 · 安装 Pi Agent第 6 步 · 配置模型 + 跑通第一句第 7 步 · 让 Pi 干活安全加固清单验收清单常见问题与排错相关网址汇总

为什么用轻量服务器

写在前面

Pi 日常可以跑在个人电脑上,但要它一直在线(定时发稿、接消息、常驻干活),就需要一台服务器。轻量应用服务器是性价比最高的入门选择:2 核 2G 的 Ubuntu 实例,月费几十元,跑 Pi + 挂个网页绰绰有余。

1

第 1 步:购买轻量应用服务器

步骤
  1. 阿里云控制台 → 轻量应用服务器 → 创建实例
  2. 镜像选 Ubuntu(22.04 或 24.04 均可),地域选离你近的
  3. 创建后,在实例详情里 重置密码(root 登录用),或创建密钥对
  4. 记下公网 IP
2

第 2 步:登录服务器

步骤

Windows 打开终端(PowerShell/WSL 都行):

ssh root@你的公网IP

首次会提示确认指纹(输 yes),然后输密码(密码不回显,正常)。

3

第 3 步:更新系统 + 基础工具

步骤
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl ca-certificates
4

第 4 步:装 Node 20+(nvm)

步骤
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22
node -v
5

第 5 步:安装 Pi Agent

步骤
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version
6

第 6 步:配置模型 + 跑通第一句

步骤

和本地一样,编辑 ~/.pi/agent/models.json 配置 LLM 提供方(密钥放环境变量)。然后无人值守地试一句:

cd ~ && pi -p "用一句话介绍你自己"

pi -p "内容" 是非交互模式:给一句话需求,直接返回结果后退出——这正是服务器上给脚本、cron、消息机器人调用的形态。

7

第 7 步:让 Pi 干活(两个典型用法)

步骤

定时任务(每天 9 点让 pi 干活):

crontab -e
# 加入一行:
# 0 9 * * * cd /root/pi-jobs && pi -p "读取 today.txt,生成今日简报写到 out.md" >> /root/pi-jobs/run.log 2>&1

挂一个常驻服务(systemd):把 pi 包进脚本,用 systemd 管理开机自启、崩溃重启,就能做出"7×24 在线 AI 搭档"。

9

安全加固清单(必做)

  1. 安全组只开需要的端口:阿里云控制台 → 防火墙,只放行 22(SSH)、80/443(如有 Web),其余全关
  2. SSH 换端口或改用密钥登录:编辑 /etc/ssh/sshd_config 改 Port,重启 sshd;或把本机公钥放进 ~/.ssh/authorized_keys
  3. 日常用普通用户干活,root 只用于管理:
   adduser piworker && usermod -aG sudo piworker
  1. 密钥不放代码库:LLM 的 API Key 走环境变量,不要写进项目文件
10

验收清单

完成
  1. pi --version 有输出
  2. pi -p "你好" 返回内容
  3. 服务器重启后 pi 仍在(systemd 方式)或能一键拉起

至此你有一台 7×24 在线的 Pi。下一步可以接 QQ 机器人让它"随叫随到"——见本站教程《给 Pi 开通 QQ 机器人》。

11

常见问题与排错

排错
12

相关网址汇总

网址
本文基于 Pi Agent 官方文档与阿里云轻量服务器实操 · 由阿衍编写 · 2026-09-27