使用 AppleScript 和 spcli 實現自動化

從指令碼啟動儲存的連線和標記的組，同時在應用程式中保留連線配置。

使用內建參考文件

開啟自動化。它提供 AppleScript 和 命令列 (spcli) 選項卡以及可編輯示例和複製控制元件。首先列出連線名稱而不是猜測它們。

經過 7 天的共用試用期後，自動化成為 Pro 功能。 macOS 可能會向呼叫應用程式（例如終端）請求控制 Secure Pipes 的權限。僅允許您信任的呼叫者這樣做。

使用 AppleScript 列出連線

osascript -e 'tell application "Secure Pipes" to list connections'

在後續命令中使用返回的名稱。如果名稱重複，請使用全名及其連線型別，如應用程式所示。

tell application "Secure Pipes"
    connect connection "Database Tunnel (Local Forward)"
    connection status "Database Tunnel (Local Forward)"
end tell

啟動連線是非同步的。檢查狀態而不是假設命令的返回意味著隧道已準備就緒。身分驗證、主機信任和錯誤可能需要使用者注意。

控制連線組

組是分配給連線配置的標籤。組命令作用於匹配的連線配置：

tell application "Secure Pipes"
    list connection groups
    connect group "engineering"
    disconnect group "engineering"
end tell

在開始小組之前檢查每個成員。一個組操作可以啟動多個真實的監聽器。使用 disconnect connection 停止一個連線配置而不是整個組。

安裝和使用 spcli

在通用 → 命令列工具中，如果未安裝，請選擇安裝 spcli。開啟終端並執行：

spcli --help

使用已安裝版本的幫助和命令列 (spcli) 選項卡獲取確切的命令和選項。將私鑰和密碼保留在命令引數、shell 歷史記錄和指令碼之外。 spcli 在應用程式儲存的設定上執行；它不能替代伺服器端授權。

常用 spcli命令

從只讀發現開始：

spcli list connections
spcli list groups
spcli list connections --json

將下面的演示連線名稱替換為您安裝的應用程式返回的確切名稱。當您需要該操作時執行每個命令；該塊不是一次性執行的指令碼。

spcli connect "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)" --json
spcli disconnect "Database Tunnel (Local Forward)"

與 AppleScript 一樣，成功的連線命令並不證明目標已準備就緒。在開始相關工作之前，檢查狀態並處理應用程式中的身分驗證或主機信任提示。

對於名為 engineering 的標籤，請使用 spcli connect-group "engineering" 或 spcli disconnect-group "engineering"。首先檢查組成員：這些命令會影響整個匹配組。

命令	效果
spcli start	啟動 Secure Pipes 而不顯示其視窗
spcli show	顯示並啟用應用程式視窗
spcli hide	隱藏應用程式視窗而不退出
spcli shutdown	退出應用程式；活動連線已停止

對於指令碼，檢查退出程式碼：0 表示命令成功，1 表示應用程式報告的錯誤，2 無效使用，3 表示應用程式啟動或自動化權限問題，4 表示 Apple 事件傳送、超時或回覆失敗。 --json 可用於列表和狀態命令。保留返回的狀態文字，而不是假設它是未翻譯的常量。

指令碼與連線完成操作

每個連線設定可以在連線後執行本機指令碼或支援的完成操作。遠端轉發還公開了遠端指令碼選項。它們與控制應用程式的 AppleScript 是分開的。

僅啟用您理解和信任的指令碼。不要將機密放入匯出的指令碼示例中。當後續任務依賴於連線準備就緒時，請使用內建示例的有界狀態等待模式，並處理失敗狀態而不是永遠等待。