先釐清啟動遭阻擋、服務授權與鑰匙圈存取
在 macOS 安裝 Clash Verge 後，啟動應用程式、變更系統代理、安裝背景服務及讀取鑰匙圈，都可能觸發不同提示。這些並非同一種授權，不應只靠反覆輸入密碼來處理。先看清楚提示中的應用程式名稱、操作說明和要求存取的項目，再決定下一步。
也要分清原版 Clash Verge 與後續維護的 Clash Verge Rev。不同分支和版本的介面、服務實作不盡相同。本文以 macOS 13、14、15 的系統設定路徑說明處理方式；用戶端中的「服務模式」、「虛擬網卡模式」等名稱，請以實際安裝的版本為準，別依照其他版本的截圖尋找不存在的按鈕。
| 提示或現象 | 對應階段 | 優先檢查項目 |
|---|---|---|
| 無法驗證開發者、無法打開 | 應用程式啟動檢查 | 安裝檔來源、系統安全性提示 |
| 安裝輔助工具時要求管理員密碼 | 特權背景服務 | 是否剛才主動點選安裝服務 |
| 系統擴充功能遭阻擋、要求新增 VPN 設定 | 網路元件授權 | 提示中列出的應用程式與元件名稱 |
| 要求存取鑰匙圈中的機密資料 | 讀取已儲存的憑證 | 要求存取的處理程序、鑰匙圈項目名稱 |
| 關閉用戶端後網頁無法開啟 | 代理或網路狀態殘留 | 系統代理位址、連接埠與處理程序狀態 |
步驟一：處理「無法打開」提示，先讓應用程式正常啟動
確認安裝位置與處理器架構
- 點選螢幕左上角的 Apple 選單 →「關於這台 Mac」。顯示 Apple 晶片的機型通常選擇 arm64 安裝檔；顯示 Intel 處理器的機型通常選擇 x64 安裝檔。若有 Universal 版本，請依照發佈說明選擇。
- 打開下載的磁碟映像檔，將用戶端拖曳至「應用程式」資料夾。等待複製完成後退出磁碟映像檔，不要長期直接從掛載的安裝映像檔執行。
- 在 Finder →「應用程式」中打開用戶端。若系統阻止啟動，先記下完整提示，再前往系統設定檢查，不要急著變更全域安全性設定。
若出現「無法驗證開發者」或 Apple 無法檢查其中是否含有惡意軟體的提示，在 macOS 13、14、15 中可前往「系統設定」→「隱私權與安全性」，向下查看「安全性」區塊。確認來源、開發者資訊都符合預期後，才使用系統提供的「仍要打開」，並依照後續確認視窗操作。此選項通常要先嘗試打開應用程式才會出現。
「應用程式已損毀」、「會損害你的電腦」等提示，和一般未驗證開發者的提示並不相同。遇到這些提示時應停止啟動，改從專案發佈來源重新取得適用於目前系統的安裝檔，並查看發佈說明。不要把關閉 Gatekeeper 或批次移除隔離屬性當成通用安裝步驟，這會略過原本需要確認的安全資訊。
步驟二：先確認系統代理可用，再處理 TUN 權限
第一次設定建議只啟用系統代理，暫時關閉 TUN。先確認訂閱、代理群組和本機監聽都正常，避免把節點無法使用誤判為網路擴充功能尚未授權。系統代理主要影響遵循 macOS 代理設定的應用程式，不保證能接管所有程式或 UDP 流量。
- 在用戶端的「訂閱」或「設定檔」頁面匯入設定檔，並將它設為目前使用的設定檔。看到節點清單後，前往「代理」頁面選擇可用節點或策略群組。
- 將運作模式設為 Rule，再於用戶端啟用「系統代理」。若剛變更監聽連接埠，先確認核心已重新載入。
- 打開「系統設定」→「網路」→目前使用的 Wi-Fi →「詳細資訊」→「代理伺服器」。使用有線網路時，選取對應的網路服務，再進入「詳細資訊」。
- 檢查 HTTP、HTTPS 或 SOCKS 代理項目。已啟用的項目應指向用戶端實際監聽的位址與連接埠；常見的本機位址是
127.0.0.1，不要直接照抄其他教學提供的連接埠。
例如，只有在目前設定檔或執行資訊明確顯示 mixed-port: 7890 時，才使用下方指令測試。7890 只是範例，不代表所有 Clash Verge 分支的預設連接埠；mixed-port 可同時接收 HTTP 與 SOCKS 代理要求。
curl -I --connect-timeout 10 --max-time 20 \
--proxy http://127.0.0.1:7890 https://example.com- 若收到目標網站的 HTTP 回應標頭，表示這次明確指定代理的要求已獲得回應，但不能據此認定所有應用程式都已由代理接管。
- 若出現
Failed to connect，優先確認連接埠、核心執行狀態與監聽位址。 - 即使已連上本機代理仍然逾時，請繼續檢查節點、規則與 DNS；此時反覆核准系統權限通常無法解決問題。
命令列工具不一定會讀取 macOS 系統代理，因此此處明確使用 --proxy。不要只根據在終端機執行一次 curl 的結果，判斷系統代理是否生效。
步驟三：依實際實作授權背景服務或網路擴充功能
服務模式所需的管理員密碼
需要接管更多應用程式流量時，再前往用戶端「設定」，尋找「服務模式」或 TUN 相關設定。部分版本提供「安裝」服務按鈕，部分版本則會在啟用相關功能時引導安裝。若出現系統管理員授權視窗，請確認它緊接著剛才的操作出現，並核對應用程式名稱，再使用這台 Mac 的管理員帳戶核准。
這裡通常需要的是這台 Mac 的管理員帳戶密碼，不是 Apple 帳號密碼、訂閱密碼或節點密碼。安裝背景服務可能需要管理員權限，但正確安裝後，啟動服務不應每次都要求重新安裝。若每次啟動都跳出視窗，先確認用戶端已放在「應用程式」資料夾，且沒有同時執行多個分支，再查看用戶端記錄中的服務連線錯誤。
只有出現擴充功能提示時，才處理相關設定
- macOS 13、14：若系統明確指出某開發者的系統軟體遭到阻擋，請前往「系統設定」→「隱私權與安全性」→「安全性」，查看與該次安裝相對應的允許選項。若沒有相關提示，就不必尋找通用的 Clash 擴充功能開關。
- macOS 15：網路擴充功能的管理位置在「系統設定」→「一般」→「登入項目與擴充功能」→「網路擴充功能」，可透過相應的詳細資訊入口查看。只有已安裝的用戶端確實註冊了元件，才會看到相關項目。
- 新增 VPN 設定：若目前用戶端的實作觸發此提示，請先核對應用程式名稱，再決定是否允許。其他 VPN 應用程式先前獲得授權，不代表這次的用戶端也已獲准。
核准後回到用戶端重新啟用 TUN，確認狀態是否維持開啟，並檢查記錄中有沒有權限不足、服務無法使用或路由設定失敗等訊息。只有系統明確要求重新啟動時才重開機；若沒有相關提示，可先結束並重新打開用戶端，不要無故反覆重開機。
步驟四：看懂鑰匙圈提示，不要把它當成啟用 TUN 的必要條件
鑰匙圈用來儲存憑證並控管存取權限。系統代理或 TUN 需要管理員權限，不代表一定要讀取某個鑰匙圈項目。看到「想要使用你儲存在鑰匙圈中的機密資訊」時，請留意兩個名稱：哪個處理程序正在提出要求，以及它想讀取哪個項目。
- 先確認剛才是否執行了儲存憑證、連線至需要驗證的代理等相關操作。若提示與目前操作無關，先點選「拒絕」，記下名稱後再進一步排查。
- 確認是預期中的應用程式要存取預期項目後，可先選擇單次「允許」。只有在了解持續存取的用途並信任該應用程式時，才考慮選擇「永遠允許」。
- 需要檢查項目時，可在 macOS 13、14 的「應用程式」→「工具程式」中打開「鑰匙圈存取」；macOS 15 也可以透過 Spotlight 搜尋「鑰匙圈存取」。請勿將它與「密碼」App 混淆。
- 選取「登入」鑰匙圈，依照提示中的項目名稱搜尋。打開對應項目，檢查資訊與「存取控制」；不要刪除用途不明的憑證、金鑰或整個鑰匙圈。
鑰匙圈密碼通常與這台 Mac 的登入密碼相同；但如果管理員曾重設帳戶密碼，而舊鑰匙圈仍使用原密碼，兩者就可能不同。此時反覆輸入目前的登入密碼，也無法解鎖舊鑰匙圈。請依照系統提供的鑰匙圈復原流程處理；重設預設鑰匙圈可能導致已儲存的憑證無法使用，因此不應優先採用。
更新或更換用戶端後若反覆出現提示，可能是應用程式簽章或項目的存取控制發生變化，也可能是另一個處理程序正在提出要求。請再次確認要求存取的一方，不要直接開放所有應用程式存取該項目。
步驟五：確認 TUN 運作正常，並排除其他網路工具衝突
完成授權後，保留原本的設定檔與節點，一次只變更 TUN 這個項目。先確認系統代理模式可以連線，再視需要關閉系統代理、保留 TUN，並測試目標應用程式。若同時開啟多個 VPN、透明代理或過濾工具，路由與 DNS 可能接連被改寫，讓結果難以判讀。
- 瀏覽器正常，某個應用程式異常：檢查該應用程式是否使用獨立代理、自訂 DNS 或固定直連規則；在用戶端的「連線」頁面查看相關要求與規則命中狀況。
- 開啟 TUN 後立即無法上網：先關閉 TUN，確認一般網路恢復，再檢查核心記錄中的路由、DNS 與服務錯誤。不要同時更改 DNS 和切換節點。
- 系統顯示已有 VPN：前往「系統設定」→「VPN」查看目前的連線，暫時中斷其他 VPN 後再測試；公司管理的裝置請先遵循組織的網路管理規範。
- 公司電腦無法授權：若擴充功能設定受到管理，或無法使用管理員憑證，請聯絡裝置管理員。重新安裝用戶端無法解除裝置管理政策。
可以在終端機執行 ifconfig 輔助查看 utun 介面，但出現 utun0 或 utun1，本身無法證明 Clash 正在接管流量；macOS 本身和其他應用程式也可能建立這些介面。較可靠的判斷方式是：用戶端的 TUN 狀態正常、記錄沒有相關錯誤、目標要求出現在連線清單中，而且實際連線成功。
關閉用戶端後無法上網與反覆授權的處理順序
關閉用戶端後仍無法上網，請先還原網路設定，不要立刻刪除設定檔或鑰匙圈。殘留的本機代理會讓瀏覽器持續連線到已停止監聽的連接埠，看起來就像整台電腦都斷網。
- 若仍能打開用戶端，先關閉「系統代理」和 TUN，再正常結束程式。
- 前往「系統設定」→「網路」→目前使用的網路→「詳細資訊」→「代理伺服器」，關閉確認是本次用戶端所設定的代理項目。原本屬於公司網路的代理請先記錄，不要一併清除。
- 查看「系統設定」→「VPN」，確認沒有本次測試留下的連線；接著重新連線 Wi-Fi 或有線網路，並測試一般網頁。
- 重新啟動用戶端，只開啟系統代理進行一次測試，再分別檢查服務模式與 TUN，記下問題是在哪個步驟再次出現。
需要重新安裝服務時，優先使用用戶端提供的解除安裝與安裝功能，不要貿然刪除系統背景服務檔案。尋求協助時，提供 macOS 版本、晶片類型、用戶端完整名稱與版本、觸發提示的操作，以及已移除敏感資訊的記錄即可；請勿公開訂閱連結、存取權杖或節點密碼。