Turnout 用原生 App，照 wg-quick 的做法把你的 Mac 連上 WireGuard 伺服器。

Turnout 讀取你原本給 wg-quick 用的 .conf 設定檔，照 wg-quick 在 macOS 上的做法一步步套用，用的也是同樣的系統工具。

PreUp PostUp PreDown PostDown

hook 會執行，%i 換成通道的 utun 介面，%I 換成通道名稱。檔案裡的 hook 要先經過管理者核准才會執行；運作方式。

AllowedIPs

導入通道，越具體的路由越優先。全通道用 0.0.0.0/1 和 128.0.0.0/1（以及對應的 IPv6 兩半），而不是取代你的預設路由；伺服器的位址則留在實體閘道上，不會繞進自己的通道。

Table

auto 和 main 照上面的方式設定路由；off 則把路由表交給你處理。

DNS

通道連線期間，DNS 伺服器與搜尋網域會設定到你的網路服務上；中斷連線後就恢復成你原本的設定。

MTU

照設定檔寫的值，或照 wg-quick 的算法：出口網路介面的 MTU 減 80。

這兩行是 wg-quick 的格式裡沒有的。它們以 #@ 開頭，wg-quick 會當成註解，所以同一個檔案照樣能用 wg-quick up。

[Interface]
PrivateKey = …
Address = 10.8.0.2/32
DNS = 10.8.0.1
#@ BindInterface = en0
#@ Route = 192.168.0.0/16 dev en0

[Peer]
PublicKey = …
AllowedIPs = 0.0.0.0/0, ::/0
Endpoint = vpn.example.com:51820

已連線的通道也能直接在主視窗的路徑上切換出口介面：Turnout 會中斷連線、儲存變更，再重新連線。

閘道、網路介面或連線狀態改變，或是 Mac 從睡眠中喚醒時，Turnout 會把經由實體網路的路由重新指向目前的閘道、重新計算自動 MTU，並重新套用 DNS。

通道綁定的網路介面消失後又回來時，通道會重新綁定並再次交握。介面若一直沒回來，通往伺服器的路由會變成黑洞路由，交握封包就不會溜進通道本身；不走通道的路由則會等介面回來再恢復。

幫通道設定時段、Wi-Fi 網路清單，或兩者都設。

排定的時段一開始，Turnout 就連線，時段結束就中斷。Mac 加入清單上的網路時通道會連線，離開時就中斷。這中間你手動做的操作會維持不變，修改規則本身也不會連線或中斷任何東西。

#@ Schedule = Mon-Fri 09:00-18:00
#@ OnWiFi = Office

規則就是設定檔裡的幾行，從通道的頁面設定。Turnout 開著時才會執行這些規則，所以它提供「在登入時打開」。Wi-Fi 規則需要定位權限，因為 macOS 把 Wi-Fi 網路名稱視為位置資訊；Turnout 只在你設定這類規則時才會詢問，啟動時絕不會問。

用表單或文字編輯通道，隨時都能切換。

修改只會改寫有動到的那幾行，你的註解和順序都留在原處。問題會連同行號列出，全部解決之後才能儲存。新增的通道會附上一組新產生的金鑰。

把 .conf 檔或 .zip 拖到視窗上、選擇「檔案」›「從檔案匯入⋯」，或用「檔案」›「從剪貼板新增通道⋯」貼上複製的設定檔。官方 WireGuard App 匯出的 zip 會以批次方式開啟：逐一檢查每條通道，略過不要的，其餘一次匯入。

「檔案」›「輸出通道⋯」則反過來：每條通道各一個 .conf，放進同一個 zip，結構和官方 App 匯出與匯入的一樣。單一通道的「輸出⋯」只儲存它自己的檔案。

Turnout 待在選單列裡。在那裡連線、中斷通道，需要細節時再打開視窗。

通道在 Turnout 的背景服務中執行，所以關掉 App 也會繼續連著。在視窗開著的情況下量測，App 閒置時約佔 0.5% CPU，繪製即時流量時約 2–4%。只有選單或視窗開著時才會讀取統計資料；如果你要求在伺服器沒有回應時收到通知，則會每分鐘讀取一次。

排程或 Wi-Fi 規則讓通道連線或中斷連線時、通道連線失敗或在沒有要求下停止時，以及試用結束的前一天，Turnout 都會發出通知。每一種通知都有自己的開關，伺服器沒有回應的那一種預設關閉，等你需要時再打開。

它的選單和視窗會跟著你 Mac 的語言，使用 English、繁體中文、日本語、Español 或 한국어。

Turnout 對路由和 DNS 的每一項變更，都會先記錄下來才動手。

如果 Mac 在通道連線時當機或斷電，背景服務下次啟動時會復原留下的變更，完成之前不會連線任何通道。「Turnout」›「修復網路設定⋯」也能隨時手動做同樣的事。

解除安裝只有一條路，不論你從 App、從安裝程式，還是從一個可以先讀過內容的 shell 指令稿開始。它會中斷所有通道、恢復路由與 DNS、把背景服務從登入項目移除，並刪除 App、它的記錄檔和偏好設定。已儲存的通道會保留，除非你選擇一併刪除。從 App 解除安裝時，也會空出這部 Mac 在你授權上的名額。各種方式會移除什麼

• 還沒有 kill switch。Turnout 不會阻擋通道以外的流量。通道中斷時，你的 Mac 會走原本的網路。
• 不是 VPN 服務商。請自備伺服器，或使用服務商、網管給你的設定檔。
• 沒有使用 NetworkExtension。通道在 Turnout 自己的背景服務中執行，hook 能執行、路由由你作主，靠的就是這一點。也因此通道不會出現在「系統設定 › VPN」中。