連上你的建置主機

請在本機執行。使用獨立檔名方便撤銷授權，也不會覆寫既有的預設金鑰。請在互動提示中設定密語；自動化環境應透過受控的金鑰管理機制授權存取，不要將私鑰存入儲存庫。

ssh-keygen -t ed25519 -f ~/.ssh/xcr_build -C "xcr-build"
ssh-add ~/.ssh/xcr_build
ls -l ~/.ssh/xcr_build.pub

副檔名為 .pub 的是公開金鑰，可安裝到節點。沒有副檔名的是私鑰，只能留在本機或受控的 CI 金鑰儲存空間。

如果本機已安裝 ssh-copy-id ，請使用交付的使用者名稱與連接埠安裝公開金鑰。首次連線時會顯示主機指紋，請先與交付資訊核對；如果沒有可信的指紋，請透過控制台支援單確認，不要直接略過驗證。

ssh-copy-id -i ~/.ssh/xcr_build.pub -p 22 macbuild@192.0.2.10
ssh -i ~/.ssh/xcr_build -p 22 macbuild@192.0.2.10

macOS 本機環境不一定預先安裝 ssh-copy-id。若交付設定允許使用密碼登入，可以改用下方的標準 SSH 指令；若只允許金鑰驗證，請依照交付流程授權公開金鑰，不要反覆嘗試密碼。

cat ~/.ssh/xcr_build.pub | ssh -p 22 macbuild@192.0.2.10 \
'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'

重新安裝節點後若出現主機金鑰變更警告，請先確認重裝紀錄與新指紋，再更新本機紀錄。不要使用停用主機驗證的參數來掩蓋異常。

將下方設定加入本機的 ~/.ssh/config。設定別名後就不用記住節點位址；位址變更時只需修改這裡，指令碼仍可使用 xcr-build。

Host xcr-build
    HostName 192.0.2.10
    User macbuild
    Port 22
    IdentityFile ~/.ssh/xcr_build
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

執行一次唯讀驗收，確認實際系統版本、目前選用的 Xcode 與磁碟空間。先確認環境，再安裝相依套件或註冊 runner，避免將錯誤版本帶進 CI 流程。

ssh xcr-build
sw_vers
xcode-select -p
xcodebuild -version
df -h "$HOME"