在树莓派上部署 worldmonitor 记录

🖥 环境说明

• 装置：Raspberry Pi 4B 8G
• 系统：Raspberry Pi OS
• 部署方式：本地局域网访问

📦 一、安装 Node.js

推荐使用 nvm 安装 Node.js（避免系统源版本过旧）。

1
2
3
4
5

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

nvm install 20
nvm use 20

确认版本：

1

node -v

📦 二、安装 pnpm

1

npm install -g pnpm

🚀 三、部署 worldmonitor

1
2
3
4
5
6
7
8

git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor

# 安装依赖
pnpm install

# 构建项目
pnpm build

▶ 执行项目

生产模式执行（推荐）：

1

pnpm preview --host

然后在浏览器访问：

1

http://树莓派IP:端口号

即可正常开启。

如果只是测试，也可以使用开发模式：

1

pnpm dev --host

🔄 使用 pm2 后台执行（推荐）

如果直接使用 pnpm preview 或 pnpm dev，一旦关闭终端，项目就会停止执行。
为了让服务在后台长期稳定执行，可以使用 pm2 进行程序管理。

① 安装 pm2

1

npm install -g pm2

② 启动项目（生产模式）

1

pm2 start pnpm --name worldmonitor -- preview --host

引数说明：

• --name worldmonitor：给程序起一个名字，方便管理
• preview --host：使用构建后的生产模式执行

③ 查看执行状态

1

pm2 list

查看日志：

1

pm2 logs worldmonitor

④ 设定开机自启

1

pm2 startup

按照提示复制执行生成的命令，然后：

1

pm2 save

这样树莓派重启后，服务会自动恢复执行 🚀

⑤ 常用管理命令

1
2
3

pm2 stop worldmonitor      # 停止
pm2 restart worldmonitor   # 重启
pm2 delete worldmonitor    # 删除程序

✅ 部署完成

到这里项目就可以在树莓派上正常执行，并通过 Windows 浏览器访问了 🎉

⚠ 一点说明

需要注意的是：

这个项目本质上更像是一个 视觉化展示框架。

新闻数据的获取依赖外部 API，如果没有配置相关 API key，可能：

• 数据无法载入
• 或只显示示例数据