1 準備
- micro SD 卡
- 外接顯示器
- Raspberry Pi 4B
- 3.5 英寸硬盤
2 安裝 Raspberry Pi OS（previously called Raspbian）
官方鏈接：https://www.raspberrypi.org/downloads/raspberry-pi-os/
版本
- Version: August 2020
- Release date: 2020-08-20
- Kernel version: 5.4
有三種安裝可選：
- Raspberry Pi OS (32-bit) with desktop and recommended software，包含了完整的桌面系統和推薦的軟件包
- Raspberry Pi OS (32-bit) with desktop，只有桌面系統，沒有常用軟件
- Raspberry Pi OS (32-bit) Lite，最小安裝，沒有桌面也沒有常用軟件，進入後爲 CLI 命令行界面
2.1 格式化 SD 卡
鏈接：https://www.sdcard.org/downloads/formatter/eula_mac/index.html
安裝 SD Card Formatter 將 sd 卡格式化成 fat32 格式，選擇快速格式化即可
2.2 寫入鏡像
鏈接：https://sourceforge.net/projects/etcher.mirror/
將下載的鏡像寫入 SD 卡，完成後放入樹莓派上電啓動，按提示安裝即可
3 開啓 ssh
3.1 臨時開啓
在終端執行 sudo /etc/init.d/ssh start 命令即可，該方式重啓後失效
3.2 永久開啓方式一
將 SD 卡連接到電腦上並打開，直接新建一個名稱爲 SSH 的文件（無後綴）
3.3 永久開啓方式二
CLI 模式或桌面系統進入命令行界面，執行如下命令，進入配置菜單
sudo raspi-config
選擇 Interfacing Options，選擇 SSH，確定開啓，最後點選 Finish 完成，等待重啓即可
3.4 永久開啓方式三
桌面系統中，依次進入：
- 左上角菜單
- 首選項（Preferences）
- Raspberry Pi Configuration
- 進入
Interfaces選項卡 - 選擇
enable SSH服務
4 常用命令
輸出當前目錄
可以通過 pwd 命令打印當前在什麼目錄下。pwd 就是 print working directory（打印當前工作目錄）的首字母縮寫。
重啓系統
在終端執行 sudo reboot 命令即可
立即關機
在終端執行 sudo shutdown -h now 命令即可
退出終端
在終端執行 exit 命令即可
更新所有包庫列表
sudo apt-get update
將系統所有的軟件（包括系統內核）更新到最新版本
sudo apt-get upgrade
搜索無線網絡
iwlist scan
接入可見無線網絡
iwconfig wlan0 ESSID "wifiname" KEY "password" open
接入隱藏 wifi 信號
執行 wpa_passphrase "wifiname" "password" 此時獲取基於賬號和密碼生成的 64 位的 PSK 值，執行 sudo vim /etc/wpa_supplicant/wpa_supplicant.conf（若提示 vim 命令不存在可參考 更換 vim 編輯器），在配置文件添加隱藏網絡信息。修改後的文件內容如下：
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=CN
network={
ssid="wifiname"
scan_ssid=1
psk=58b190a42c2e78a617ad540a6b211fd8b22f0bc151b3e47d96119ad1ee0f9261
key_mgmt=WPA-PSK
}
注意：沒有 scan_ssid=1 將無法發現隱藏信號，也可以增加
priority=1屬性，代表優先級，數字大的優先級高
重啓系統或重啓進程即可自動連接。重啓 wpa_supplicant 可執行如下命令：
sudo killall wpa_supplicant
sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
啓動/停止/重啓服務
例如，在終端執行 sudo service stop/start/restart docker 命令，停止 docker
服務查詢
service --status-all 查看所有服務的狀態
-
+，started，運行中 -
-，stopped，已停止 -
?，unknown，未知
查看已安裝包
dpkg -l
5 其他
消除顯示黑邊
該問題表現爲顯示器並沒有被充滿，而是距離顯示器邊框還有一圈黑邊。當前 Raspberry Pi OS 的 5.4 版本可在安裝完成後的系統設置中配置，也可以進入桌面系統後，依次進入：
- 左上角菜單
- 首選項（Preferences）
- Raspberry Pi Configuration
- 進入
Display選項卡 -
Screen Block選擇Enable即可
以 CLI 模式啓動
執行命令 sudo raspi-config 進入配置界面，選擇 Boot Options，選擇 Desktop / CLI，選擇 Console，最後點選 Finish 完成，重啓即可
更換 vim 編輯器
原有的 vi 輸入編輯器使用不方便，執行如下命令更新
- 刪除原有 vim，
sudo apt-get remove vim-common - 重新安裝 vim，
sudo apt-get install vim
報錯 Wlan0: Not associated
問題描述：安裝 docker 後發現 wlan0 無法連接任何可見和不可見的 wifi 信號，桌面模式中鼠標移動到 wifi 圖標時提示 Wlan0: Not associated，但外接無線網卡可連接，原因暫時不明。
解決方案：執行 sudo apt-get upgrade，更新系統後恢復正常
報錯 you are in emergency mode...the root account is locked.
問題描述：完整報錯如下
you are in emergency mode. after logging in, type "journalctl -xb" to view system logs, "systemctl reboot" to reboot, "systemctl default" or ^d to try again to boot into default mode.
cannot open access to console, the root account is locked.
see sulogin(8) man page for more details.
press enter to continue.
即使按 enter 鍵也無法進入系統，反覆報錯。該問題是修改 /etc/fstab 使硬盤開機自動掛載時，文件系統設置錯誤導致。
解決方案：
- 在其他設備修改 SD 卡的
cmdline.txt文件，在末尾加上init=/bin/sh。修改後的文件內容如下：
console=serial0,115200 console=tty1 root=PARTUUID=63aeea46-02 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait quiet splash plymouth.ignore-serial-consoles init=/bin/sh
- 把 SD 卡重新放入樹莓派，通電開機
- 若命令行界面行首是
#，說明已經獲取了 root 權限 - 用
ls /boot查看分區，若沒有內容，執行mount /dev/mmcblk0p1 /boot進行掛載 - 重新掛載根目錄，執行
mount -o remount,rw /dev/mmcblk0p2 / - 根目錄可寫後，進入
/etc/fstab文件將可能出現問題的內容刪除或註釋 - 執行
exec /sbin/init重新啓動系統 - 恢復正常後，執行
sudo vim /boot/cmdline.txt，將末尾的init=/bin/sh刪除，避免重啓進入 root 環境
手動/開機自動掛載硬盤
- 接入硬盤
- 可通過
sudo fdisk -l查看是否識別硬盤，例如/dev/sda1 - 採用 ext4 文件系統格式化硬盤
sudo mkfs -t ext4 /dev/sda1 - 創建掛載位置
sudo mkdir /mnt/disk，設置權限sudo chmod 777 /mnt/disk - 查詢設備 uuid。執行
sudo blkid，得到如下內容
/dev/mmcblk0p1: LABEL_FATBOOT="boot" LABEL="boot" UUID="6284-658D" TYPE="vfat" PARTUUID="63aeea46-01"
/dev/mmcblk0p2: LABEL="rootfs" UUID="3a324232-335f-4617-84c3-d4889840dc93" TYPE="ext4" PARTUUID="63aeea46-02"
/dev/sda1: UUID="e3b362dc-9863-496d-916a-0ef250441c09" TYPE="ext4" PARTUUID="91676b87-01"
/dev/mmcblk0: PTUUID="63aeea46" PTTYPE="dos"
- 掛載方式一：手動掛載
sudo mount /dev/sda1 /mnt/disk；手動卸載sudo umount /mnt/disk，這種方式只是臨時掛載，重啓以後還要重新掛載 - 掛載方式二：開機自動掛載，進入
/etc/fstab，在末尾添加UUID=e3b362dc-9863-496d-916a-0ef250441c09 /mnt/disk ext4 defaults 0 0，保存重啓
注意：文件系統格式一定要對應，否則啓動會出錯