AI 工作實務
Raspberry Pi OS 設定指南:SSH、Wi-Fi、更新與基本安全一次完成
樹莓派裝好系統後,如何管理 SSH、網路、Python 虛擬環境與安全更新?提供 Raspberry Pi OS 新手設定順序、常用指令和企業驗收清單。

本文目錄
先確認你的 Raspberry Pi OS 版本1.先完成帳號與主機名稱設定2.把網路連線當成服務的一部分3.建立可靠的 SSH 遠端登入4.更新系統前先理解風險5.Python 環境不要直接和系統套件混用6.基本資訊安全與可恢復性7.PoC 交付時,至少保留這份設定記錄參考資料圖片與素材說明裝好 Raspberry Pi OS 只是開始。你如果想把 Raspberry Pi 當成常態運作的感測器伺服器、資料收集站或企業 PoC 節點,接下來更關鍵的是:換人維護時能不能登入、更新會不會破壞應用、斷網後能不能恢復。
這篇不是羅列所有 raspi-config 選項,而是用「一台可以持續維護的設備」為目標,安排首次設定順序。先確定身分與網路,再確認更新、程式環境與備份,可以避免安裝完成後才發現遠端管理不可行。
先確認你的 Raspberry Pi OS 版本
Raspberry Pi OS 是基於 Debian 的系統。官方在 2026 年文件中列出目前版本以 Debian Trixie 為基礎,Bookworm 為前代。不同版本的 Wi-Fi、桌面工具與 Python 套件行為不完全相同,因此先開啟 Terminal 執行:
cat /etc/os-release
uname -a
hostnamectl
請把結果記在設備台帳。不要只寫「安裝最新版」,因為日後追查問題時,這個說法沒有足夠的版本資訊。
1.先完成帳號與主機名稱設定
確認系統已有專屬管理者帳號,且沒有使用弱密碼。裝置名稱建議和實際資產編號關聯,例如 lab-pi5-01。修改主機名稱可透過桌面介面或:
sudo raspi-config
raspi-config 提供主機名稱、地區、介面、開機與其他設定。功能選單會隨系統版本調整,請依畫面顯示選擇,不要完全依賴幾年前的截圖。
2.把網路連線當成服務的一部分
第一次安裝時,最簡單的方式是在 Raspberry Pi Imager 預設 Wi-Fi/地區資訊;如有企業網路政策,應由網管提供允許的連線方式。先確認 IP 及路由:
ip addr
ip route
需要讓設備長期被其他系統找到時,可考慮由路由器做 DHCP 位址保留,避免直接在多台設備上手工寫死相同的 IP。Wi-Fi 會在訊號干擾、憑證過期或 AP 維護時中斷,PoC 不能把「永遠在線」當作既定條件。
3.建立可靠的 SSH 遠端登入
官方文件說明 SSH 服務預設不是開啟狀態,可在 Imager 安裝設定時、桌面控制中心或 raspi-config 啟用。遠端登入時使用:
ssh <使用者>@<IP位址>
企業環境建議使用金鑰驗證。啟用公鑰登入並確認另一個終端機確實可以登入後,才評估停用密碼驗證;否則很容易把自己鎖在裝置外。不要直接把 TCP 22 連接埠暴露到公開網際網路,應優先透過組織認可的 VPN、跳板或受控網路存取。
SSH 驗收至少包含: 遠端 IP 正確、使用者權限符合最小需要、登入有可辨識裝置身份、斷線後可再次連接。
4.更新系統前先理解風險
官方推薦透過 apt 安裝目前版本內的安全更新與軟體修正:
sudo apt update
sudo apt full-upgrade
sudo reboot
這不是無條件升級至下一個 Debian 主要版本。若跨越 Bookworm 與 Trixie 等主要版本,應另外備份、檢查相容性及執行遷移計畫。持續運作的企業裝置更應保留測試機、變更紀錄及回復方案,避免一次更新導致全部設備停止服務。
5.Python 環境不要直接和系統套件混用
Raspberry Pi OS Bookworm 及後續版本採用外部管理的 Python 系統環境;對自行安裝的 Python 套件,建議使用虛擬環境:
sudo apt install python3-venv
python3 -m venv ~/venvs/lab-project
source ~/venvs/lab-project/bin/activate
python -m pip --version
完成後可以在虛擬環境中安裝專案所需套件,並把依賴記錄在版本控制中。GPIO 等涉及作業系統驅動的套件需按官方支援方式安裝,不能一概假設所有功能都只靠 pip install 即可。
6.基本資訊安全與可恢復性
建立最小可用安全基線:使用者權限(每個人用自己的帳號)、網路(不公開不必要的服務)、更新(有維護時間與測試程序)、資料(知道保存在何處)、備份(可以重建)、日誌(出事後可追查)。
若要啟用 UFW 防火牆,必須先確認 SSH 等必要連接埠已允許再開啟,避免斷線。也不要在教學截圖顯示 Wi-Fi 密碼、私鑰、公開 IP 或公司內部系統憑證。
7.PoC 交付時,至少保留這份設定記錄
| 檢核項目 | 需保存的證據 |
|---|---|
| 裝置與 OS | 硬體型號、OS 版本、套件更新日期 |
| 網路與登入 | 主機名稱、網路方式、成功 SSH 截圖(去識別) |
| 安全 | 專用帳號、SSH 驗證方式、端口曝露盤點 |
| 應用 | 安裝依賴、程式版本、啟動及故障日誌 |
| 服務 | 重開機後應用是否自動恢復 |
| 回復 | 備份位置、重新燒錄流程、負責人 |
最後請實際拔除網路或重開機,觀察服務如何恢復。沒有恢復流程的展示機,尚不足以視為能交付企業現場的設備。
本文驗證狀態: 指令與原則已依 Raspberry Pi 官方文件查核,尚未在實體 Raspberry Pi OS Trixie 環境逐條執行。不同套件版本可能影響操作方式與結果。
需要先安裝系統,可看 Pi 5 安裝教學;要學 Python 控制 LED,可看 GPIO 實作指南;完整入門架構見 Raspberry Pi 指南。
參考資料
- Raspberry Pi 官方〈Configuration〉:https://www.raspberrypi.com/documentation/computers/configuration.html
- Raspberry Pi 官方〈Raspberry Pi OS〉:https://www.raspberrypi.com/documentation/computers/os.html
- Raspberry Pi 官方〈Remote access〉:https://www.raspberrypi.com/documentation/computers/remote-access.html
- Raspberry Pi 官方〈Getting started〉:https://www.raspberrypi.com/documentation/computers/getting-started.html
資料查核日期:2026 年 10 月 21 日。
圖片與素材說明
封面:天地人原創 AI 概念插畫。硬體外觀與配線為示意,請以官方文件及本文步驟為準。
本文由 TARAISG(TIANDIREN AI SOLUTION GROUP)使用 AI 模型產生正文、整理來源並設計實務工具。方法依據與限制列於文末;案例為明確標示的教學假設。未有具名紀錄時,不宣稱經人工或專家審核。
查看內容製作與更正說明