本文目錄
Mac 上設定代理會遇到不同的系統授權提示，但不是每個問題都能靠重新授權解決。用戶端能執行、設定能載入，應用程式的請求才有條件轉送。準備啟用更廣的接管方式時，保留瀏覽器已驗證可用的系統代理，再檢查對應的網路權限和切換網路後的結果。
選單欄用戶端正在執行，但核心正常嗎？
macOS 用戶端常駐選單欄，關閉主視窗後通常仍在執行。設定或日誌中的核心狀態，表示負責處理連線的處理程序是否正常；持續出現 core failed 或 permission denied 時，先處理本機啟動與權限問題。
同時退出舊 ClashX、其他 Mihomo 用戶端和 VPN，避免多套程式一起修改系統代理。
在 Profiles（訂閱）中匯入、更新並選取設定
本節的頁面與截圖以 Clash Verge Rev 為例，Profiles 在繁中側欄叫「訂閱」。其他 macOS 用戶端依自己的設定入口操作，不必找同名頁面；後續權限也只處理目前用戶端實際要求的項目。
在 macOS 匯入遠端設定
進入 Profiles（訂閱）
貼上服務方提供的 Clash 或 Mihomo 相容 HTTPS 連結。
手動更新
等待新的更新時間，留意 401、403、timeout 或 parse error。
選中 Profile
確保目前標記不是舊設定或示例檔案。
開啟 Proxies
確認策略群組和節點不是空白。
macOS 網路權限不能修復訂閱錯誤。更新返回 401/403 時處理 token 或帳號；返回 YAML 解析錯誤時核對核心和格式。只有 Profile 已載入，系統代理與 TUN 才能使用其中的節點和規則。
System Proxy：在瀏覽器中驗證連線
選單欄圖示亮著只說明用戶端在執行，不說明瀏覽器已經交給它。到 Proxies 的主要選擇組裡固定一條節點，模式保留 Rule。開啟 System Proxy 後，macOS 可能要求允許應用更改網路代理；確認提示來自目前用戶端，再輸入系統認證資訊或使用 Touch ID。
用 Safari 或 Chrome 開啟熟悉的網站，到 Connections 查看網域、規則和出口。頁面成功且記錄符合預期，說明這次系統代理請求正常；確認節點可用，還要看它確實經過所選節點。瀏覽器正常而終端機沒有記錄時，後者可能不讀取系統代理。
系統代理正常運作的證據
- macOS 網路設定出現目前用戶端的本機代理連接埠
- 瀏覽器請求進入 Connections
- Rule 與最終出口符合預期
- 關閉 System Proxy 後同一請求不再經過 Clash
TUN 的網路擴展、VPN 與輔助服務權限
TUN 會建立虛擬網路介面，把更多 TCP、UDP 連線交給 Mihomo。終端工具、遊戲啟動器或不讀取系統代理的軟體完全沒有 Connections 記錄時，可以用 TUN 做對照；已經進入 Clash 卻命中錯誤規則的請求，不需要擴大接管範圍。
開啟 TUN 時，macOS 可能要求安裝或允許網路擴展、輔助服務或 VPN 設定。系統設定會顯示對應項目，允許的開發者和應用應與目前用戶端一致。
若開關立即彈回，或記錄顯示 permission denied，依記錄核對目前用戶端所需的網路擴充功能、VPN 或輔助服務權限，在系統設定或用戶端內建服務入口處理。回到用戶端重新開啟，並等待虛擬介面就緒。
權限提示與作用
| macOS 提示 | 它解決什麼 |
|---|---|
| 修改系統代理 | 讓遵循系統代理的應用連線本機連接埠 |
| 網路擴展 / VPN 設定 | 建立或執行 TUN 接管路徑 |
| 管理員權限 / 輔助服務 | 執行需要系統權限的網路操作 |
| 區域網路存取 | 發現或連線區域網路裝置，是否需要取決於情境 |
在 TUN 下重新測試原來沒有記錄的程式
TUN 前後只比較一個動作
關閉 TUN 重現
確認該程式在系統代理下沒有連線記錄。
開啟 TUN
保持相同 Profile、Rule 模式和固定節點。
重複完全相同的動作
例如執行同一條終端命令或開啟同一啟動器頁面。
查看新連線
記錄處理程序、網域、命中規則和出口。
開啟後出現紀錄並成功，說明 TUN 已接管這條請求。紀錄顯示 DIRECT，檢查規則；走節點後 timeout，比較節點和網路；仍無紀錄，查看網路擴充功能狀態、防火牆和其他 VPN，不要繼續改訂閱。
睡眠喚醒或切網後的斷連
Mac 從睡眠恢復或從 Wi-Fi 切到手機熱點後，實際出口網路介面卡可能已變化，TUN 介面卻仍保留舊狀態。等幾秒後重複原請求，觀察 Connections，再按下面的現象處理。
系統代理模式下也要檢查舊代理值是否殘留。若核心已停止監聽，而 macOS 網路設定仍指向 127.0.0.1 的連接埠，仍經過該代理的網頁請求會失敗；清除殘留或重新啟動目前用戶端。只關閉主視窗不等於核心已停止。
喚醒後 Connections 為空
重載核心，讓用戶端重新識別 Wi-Fi 與預設出口。
換網路後只有 TUN 失敗
重建 TUN 介面，並查看其他 VPN 是否搶佔路由。
用戶端退出後瀏覽器全斷
檢查 macOS 的 HTTP、HTTPS、SOCKS 代理是否仍指向舊連接埠。
NAS、印表機與公司內部網域的直連
印表機、NAS、路由器管理介面或公司內部網域在開啟 TUN 後失聯，往往不是節點問題，而是私有位址被帶進了代理路徑。關閉 TUN 後區域網路裝置立即恢復存取，可以把範圍縮到區域網路規則、內部 DNS 或路由。
查看該 IP 在 Connections 中是否命中 DIRECT。家庭網路常見私有網段通常已有規則，公司自訂網段和 split DNS 則要按實際補充。不要複製一份包含陌生網段的「全域繞過清單」，只處理自己能確認的位址。
- IP 能開，內部網域不能開
- 更像內部 DNS 沒有沿原網路解析。
- IP 和網域都進入代理群組
- 把準確的區域網路網段或網域規則放到更寬規則之前。
- 關閉所有代理仍存取不了
- 問題已經離開 Clash，檢查目前 Wi-Fi 和裝置本身。
重啟、睡眠喚醒後檢查設定與權限
完成訂閱、System Proxy 和 TUN 權限設定後，重啟一次用戶端，再讓 Mac 睡眠並喚醒。Profile 仍是目前設定，瀏覽器請求進入 Connections，原來需要 TUN 的程式也能繼續出現連線記錄，說明權限和背景服務沒有只在本次會話臨時生效。
系統代理能用，但 TUN 在重新啟動後再次遭拒絕時，依記錄檢查目前用戶端的網路擴充功能、VPN 或輔助服務權限；睡眠後所有請求都沒有記錄時，重新載入核心並檢查選單列程序。