知識與實務

商業實務・AI 應用・人才發展

AI 工作實務

Raspberry Pi OS 設定指南:SSH、Wi-Fi、更新與基本安全一次完成

樹莓派裝好系統後,如何管理 SSH、網路、Python 虛擬環境與安全更新?提供 Raspberry Pi OS 新手設定順序、常用指令和企業驗收清單。

Raspberry Pi OS 的 SSH、Wi-Fi 與更新設定概念圖
硬體示意,非接線教學依據。
本文目錄先確認你的 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 指南。

參考資料

  1. Raspberry Pi 官方〈Configuration〉:https://www.raspberrypi.com/documentation/computers/configuration.html
  2. Raspberry Pi 官方〈Raspberry Pi OS〉:https://www.raspberrypi.com/documentation/computers/os.html
  3. Raspberry Pi 官方〈Remote access〉:https://www.raspberrypi.com/documentation/computers/remote-access.html
  4. Raspberry Pi 官方〈Getting started〉:https://www.raspberrypi.com/documentation/computers/getting-started.html

資料查核日期:2026 年 10 月 21 日。

圖片與素材說明

封面:天地人原創 AI 概念插畫。硬體外觀與配線為示意,請以官方文件及本文步驟為準。

AI 生成內容

本文由 TARAISG(TIANDIREN AI SOLUTION GROUP)使用 AI 模型產生正文、整理來源並設計實務工具。方法依據與限制列於文末;案例為明確標示的教學假設。未有具名紀錄時,不宣稱經人工或專家審核。

查看內容製作與更正說明

立即領!558元學習投資折抵金

能力投資季。立即領取 558 元學習金!全站線上課立即折抵。只需填寫 Email,即可輕鬆獲得,先領起來,不要錯過!

立即領!559元學習投資折抵金

能力投資季。立即領取 559 元學習金!全站線上課立即折抵。只需填寫 Email,即可輕鬆獲得,先領起來,不要錯過!

立即領!579 元學習金

學習,看見新可能。 10/14 前領取 579 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!599 元學習金

學習,帶來新可能。 09/09 前領取 558 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!558 元學習金

學習,發現新大陸。 8/29 前領取 558 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!559 元學習金

學習,連結新亮點。 8/14 前領取 559 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!555 元學習金

學習,發現更多視角。 6/14 前領取 555 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!556 元學習金

學習,累積無限可能。 5/29 前領取 556 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!557 元學習金

學習,讓我們發現未曾想像的可能!5/14 前領取 557 元折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

立即領!579 元折抵金

知識就是力量,專業成就未來!3/18 前領取 579 元課程折抵金,解鎖數百堂高品質線上課程,提升職場競爭力與專業技能。只需填寫Email,即可輕鬆獲得,投資自己從現在開始!

年終學習金

年終之餘用學習投資自己!填入 Email ,立即領取 588 元年終學習金!數百堂線上課程立即折抵,先領取收藏起來!