Headless 無介面部署
不接顯示器,SSH遠端搞定一切
誰需要 Headless 部署
所謂 Headless 就是不接顯示器、不接鍵盤滑鼠,全程用 SSH 遠端操作。大多數人的樹莓派最終都是塞在角落裡吃灰式執行的,根本不需要桌面環境。
這篇教你從燒錄系統開始,到 SSH 連接、部署 OpenClaw、設定開機自啟,全程不需要任何外設。省一台顯示器和一根 HDMI 線的錢。
五步搞定
1
烧錄系統
用 Raspberry Pi Imager 把系統烧錄到 SD 卡,選 Raspberry Pi OS Lite (64-bit),不需要桌面環境。
2
啟用 SSH
在 Imager 的進階設定裡直接勾選 "Enable SSH",設好使用者名稱和密碼,省得再手動建檔案。
3
配 WiFi
同樣在 Imager 進階設定裡填好 WiFi 名稱和密碼。有網線的話直接插上更省事。
4
首次連接
把 SD 卡插到樹莓派通電開機,等 1-2 分鐘讓它聯網,然後用 SSH 連上去。
5
部署 OpenClaw
連上 SSH 之後就和普通 Linux 一樣操作了,裝 Docker、跑 compose,搞定。
Raspberry Pi Imager 設定
Imager 工具現在很好用了,燒錄的時候直接把 SSH、WiFi、用戶名全設定好:
Raspberry Pi Imager 進階設定
# 1. 下載安裝 Raspberry Pi Imager
SSH 連線
烧錄完插卡通電,等個一兩分鐘讓樹莓派聯上網,然後從你的電腦上 SSH 連過去:
SSH 密鑰產生和首次登入
# 如果還沒有 SSH 密鑰,先產生一個
開機自啟動
樹莓派斷電重啟之後,你肯定希望 OpenClaw 自動跑起來,不用手動 SSH 上去再啟動一次。用 systemd 來管理:
建立 systemd 服務
# 建立服務檔案
openclaw.service systemd 服務檔案
[Unit]
Description=OpenClaw Docker Compose Service
Requires=docker.service
After=docker.service network-online.target
Wants=network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/home/pi/openclaw
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
ExecReload=/usr/bin/docker compose restart
TimeoutStartSec=120
[Install]
WantedBy=multi-user.target
啟用開機自啟
# 重新載入 systemd 設定
固定 IP 位址防止找不到:樹莓派預設用 DHCP 自動取得 IP,路由器重啟後 IP 可能會變,SSH 就連不上了。建議在路由器裡給樹莓派綁定固定 IP,或者在樹莓派上設定靜態 IP:編輯
/etc/dhcpcd.conf,加上 static ip_address=192.168.1.100/24。
SSH 連上後快速部署
連上 SSH 之後,照著下面的指令一路走就行了:
一鍵部署流程
# 更新系統