嵌入式開發常需透過 TFTP 將核心、檔案系統下載至開發板。Ubuntu 上架設 TFTP 伺服器其實只要幾條指令,但網路教學參差不齊、步驟冗長。本文記錄最精簡、經驗證可行的流程,備忘並分享。
sudo 權限sudo apt update
sudo apt install tftpd-hpa tftp-hpa
tftpd-hpa:伺服器端 (daemon)。tftp-hpa:用戶端測試工具 (可選)。sudo mkdir -p /srv/tftp
sudo chown -R tftp:tftp /srv/tftp
sudo chmod 777 /srv/tftp # 允許寫入 (視安全需求調整,如 755 唯讀)
sudo vim /etc/default/tftpd-hpa
將內容替換為:
TFTP_USERNAME="tftp"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_DIRECTORY="/srv/tftp"
TFTP_OPTIONS="--secure --create --listen --verbose"
參數說明:
--secure:限制存取 TFTP_DIRECTORY 以下 (chroot),安全必要。--create:允許建立新檔案 (上傳),唯讀環境可移除。--listen:獨立監聽模式 (不透過 inetd),效能較好。--verbose:記錄詳細日誌,方便除錯。sudo systemctl restart tftpd-hpa
sudo systemctl status tftpd-hpa
# 應顯示 active (running)
sudo netstat -ulnp | grep :69
# 應看到 udp 0.0.0.0:69 tftpd-hpa
cd /tmp
echo "test content" > test.txt
tftp localhost
tftp> put test.txt
tftp> get test.txt test_downloaded.txt
tftp> quit
diff test.txt test_downloaded.txt # 無輸出即成功
sudo ufw allow 69/udp
sudo ufw reload
| 現象 | 可能原因 | 解決 |
|---|---|---|
| 傳輸逾時 | 防火牆阻擋 UDP 69 | 開放埠口、檢查雲端安全群組 |
| 權限拒絕 | 目錄擁有者/權限錯誤、--secure 限制 | 確認 TFTP_DIRECTORY 權限、檔案擁有者為 tftp |
| 檔案不存在 | 路徑相對/絕對混淆 | 客戶端路徑相對伺服器 TFTP_DIRECTORY |
| 重啟後服務失效 | 未設定開機自啟 | sudo systemctl enable tftpd-hpa |
TFTP_ADDRESS="[::]:69" # 僅 IPv6
TFTP_ADDRESS="0.0.0.0:69,[::]:69" # 雙棧
完成以上步驟,你的 Ubuntu TFTP 伺服器即可穩定服務嵌入式開發板下載需求。