建立你的第一個 SSH 連線
本指南帶你在 TermAI 加入第一臺 SSH 伺服器，約 3 分鐘。需要：伺服器的 IP 或主機名、使用者名稱、密碼或私鑰。
⏱ 連線設定指南 · 2026 年 10 月 9 日更新
開始之前
- TermAI 帳號（不想同步可跳過）
- 伺服器憑證：主機名/IP、連接埠（通常 22）、使用者名稱、密碼或金鑰
步驟 1 —— 開啟連線編輯器
開啟 SSH 分頁，點選 + 或 新增連線。表單包含名稱、主機、連接埠、使用者名稱、驗證方式、群組和標籤。
步驟 2 —— 填寫基本欄位
- 標籤 —— 一個友好名稱，例如 "prod-web-01"
- 主機 —— IP 位址或主機名（192.168.1.100、myserver.example.com）
- 連接埠 —— 預設 22
- 使用者名稱 —— SSH 使用者名稱（常見有 root、ubuntu，或你的帳號）
步驟 3 —— 選擇認證方式
輸入伺服器帳號的密碼。使用者名稱是 SSH 登入使用者，不是 TermAI 帳號信箱。若伺服器停用了密碼登入，請改用私鑰。
選擇 私鑰，貼上完整的 OpenSSH 私鑰，保留頭尾和換行；加密私鑰需輸入通關密語。也可在 TermAI 內產生金鑰。僅將對應公鑰附加到伺服器目標使用者的 ~/.ssh/authorized_keys。
新增金鑰時保留原本可用的伺服器登入。完整公鑰應以一行附加，不要把私鑰放入 authorized_keys，也不要覆蓋其他使用者的金鑰。
私鑰生成 →步驟 4 —— 首次連線
使用儲存的連線進入終端機。TermAI 首次連線會記錄主機金鑰（TOFU），金鑰變更時會警告。首次信任不代表已獨立確認伺服器身分；傳送敏感資訊前，透過管理員或服務商控制台核對指紋。釐清變更原因前不要接受新金鑰。
ℹ️ 什麼是主機金鑰指紋？ 它是伺服器的唯一識別。首次驗證可防止中間人攻擊。TermAI 會記住指紋，金鑰變更時會警告你。
疑難排解
| 錯誤 | 可能原因 | 修復 |
|---|---|---|
| Connection refused | SSH 未執行，連接埠錯誤 | 確認伺服器在線，核對連接埠 |
| Permission denied (publickey) | 金鑰錯誤，或伺服器沒有你的公鑰 | 重新把公鑰複製到 authorized_keys |
| Host key verification failed | 伺服器主機金鑰已變更 | 排查（合法變更或 MITM），更新 Known Hosts |
下一步
回報文件問題 → 2026 年 10 月 9 日更新