在樹莓派上部署 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，可能：

• 資料無法載入
• 或只顯示示例資料