說明中心 · macOS 設定與連線排除故障
Clash 常見問題
從具體症狀開始檢查:先確認目前設定與流量接管入口,再檢查規則和遠端連線。以下內容以 Mac 用戶端為主,Windows 專屬問題會另外標示。
基礎知識
先釐清用戶端、核心與設定各自負責的部分,避免混淆連線入口與出站模式。
Clash、mihomo 與 Mac 圖形化用戶端有什麼關係?
Clash 通常指代理核心及其設定生態系;mihomo 是承襲 Clash Meta 發展而來的核心,負責協定連線、規則比對與流量轉送。Mac 圖形化用戶端則在核心之外提供選單列、訂閱管理和系統代理開關。即使兩款用戶端都使用 mihomo,設定入口、輔助服務和核心更新時程仍可能不同。排除問題時,應一併記下用戶端名稱、用戶端版本與核心版本,不要只寫 Clash。舊設定能否沿用也取決於具體欄位;介面相似不代表支援範圍完全相同。
安裝用戶端後,為什麼還需要訂閱或設定檔?
用戶端是執行設定的工具,安裝完成後不會自動取得可用的遠端代理。訂閱通常由服務提供者提供,用來取得節點、策略組和規則;也可以匯入自行維護的本機設定。匯入前,先確認對方提供的格式相容於 Clash 或 mihomo,並了解有效期限與裝置限制。訂閱網址可能含有帳戶憑證,請當成密碼保管,不要貼到公開論壇、放進截圖或提交至線上轉換網站。若暫時沒有設定,先完成安裝即可;反覆開啟系統代理也無法補上缺少的連線資訊。
規則、全域、直連模式該怎麼選?
日常使用通常先選規則模式,由設定中的規則決定流量使用哪個出站策略。全域模式會將連線交給全域策略組,但仍須在策略組中選取可用的出站方式,也不保證用戶端會接管每個程式的流量。直連模式會讓已接管的連線直接連至目標,不等於關閉系統代理或退出用戶端。若只有特定網站異常,可以暫時切換模式比對,再切回規則模式找出命中的規則。是否接管應用程式與如何選擇出站方式是兩回事;前者取決於系統代理、應用程式設定或 TUN 等入口。
使用代理後,HTTPS 內容和瀏覽紀錄由誰掌握?
一般 HTTPS 連線由應用程式與目標網站加密,普通代理轉送不需要安裝根憑證。不過,代理服務仍可能接觸連線時間、目標網址或流量大小等中繼資料,因此應先了解服務提供者如何處理資料。若某項操作要求安裝憑證並啟用 HTTPS 解密,應另外評估其用途與信任範圍。用戶端記錄也可能包含網域、連線錯誤與設定路徑。分享診斷資訊前,請遮蔽訂閱網址、認證欄位和個人資料;開啟代理不代表所有瀏覽活動都無法追蹤。
安裝設定
依序檢查架構選擇、App 啟動、訂閱啟用與輔助服務授權。
Apple 晶片與 Intel Mac 該下載哪個安裝檔?
在 Apple 選單中開啟「關於這台 Mac」:若顯示 Apple M 系列晶片,請選擇 arm64 或 Apple Silicon 安裝檔;若顯示 Intel 處理器,請選擇 x64 或 x86_64 安裝檔。若有提供 Universal 通用版本,可依該用戶端的說明安裝。Apple 晶片執行 Intel 版本可能需要 Rosetta,但優先選擇原生架構較能減少相容性問題。也請確認用戶端要求的最低 macOS 版本;架構相符不代表系統版本也符合條件。安裝方式請參閱安裝檔頁面,別只憑 MacBook 外觀或購買年份判斷。
macOS 顯示無法驗證開發者或 App 已損毀,該怎麼處理?
先確認系統顯示的具體訊息,並核對安裝檔來源、晶片架構和系統需求。將 App 移至「應用程式」資料夾後再嘗試開啟;若系統阻止啟動,請到「系統設定」的「隱私權與安全性」查看是否有「仍要打開」選項,且只對已確認來源的 App 操作。「已損毀」訊息也可能是下載不完整、簽章異常或版本不相容所致,可重新下載並查看發布說明。不要為了啟動未知 App 而全面關閉系統安全防護,也不要直接複製來源不明的終端機指令。若警告指出含有惡意軟體,請停止執行並查證來源。
如何匯入訂閱,並確認目前的設定已生效?
在用戶端的訂閱或設定頁面選擇從 URL 匯入,貼上服務提供者給的完整網址並儲存,等待擷取與解析完成。接著明確選取這份設定作為目前設定,確認代理頁面是否出現對應的策略組,並在需要手動選擇的組別中指定出站方式。清單中出現訂閱紀錄,只代表紀錄已儲存,不表示下載成功或設定已啟用。若匯入失敗,先查看 HTTP 狀態碼與解析錯誤,判斷是網址無法存取還是格式不相容。不要把網站帳戶登入網址當成訂閱網址;本機檔案則應透過檔案匯入功能開啟。
TUN 增強模式為什麼需要授權?授權失敗怎麼辦?
TUN 需要建立虛擬網路介面並調整路由,Mac 用戶端通常透過特權輔助服務執行這些操作,因此可能會要求管理員授權。先依照用戶端設定中的提示安裝或修復輔助服務,再啟用 TUN,並查看核心記錄是否顯示介面建立成功。取消授權、服務未啟動,或服務與用戶端版本不相容,都可能讓開關馬上跳回關閉狀態。可以先關閉其他 VPN 或類似的通道工具再試,但不要任意刪除系統網路設定。若裝置受組織管理且沒有授權權限,請聯絡管理員;系統代理則可暫時用於支援此功能的應用程式。
若需要依序操作,請參閱訂閱匯入與快速入門教學;選擇晶片架構可查看Mac 安裝檔。
使用技巧
從連線頁面確認請求是否進入核心,再追查命中的規則和最終出站方式。
系統代理已開啟,為什麼瀏覽器還是沒有走代理?
先確認核心正在執行、目前設定有效,且系統代理使用的位址與連接埠和用戶端實際監聽值一致。接著前往「系統設定」的網路頁面,檢查目前使用中的 Wi-Fi 或乙太網路服務代理設定;切換網路服務後,原服務的設定不一定適用。瀏覽器擴充功能、應用程式內的代理設定和其他 VPN 也可能改變連線路徑。開啟用戶端的連線頁面,重新整理測試網站,觀察是否出現連線及其出站策略。若沒有連線,先檢查流量接管入口;若有連線但選到直連,應檢查規則與略過清單,而非反覆點選系統代理開關。
終端機中的 curl、Git 為什麼不使用 macOS 系統代理?
許多命令列程式不會讀取 macOS 系統代理,而是使用自身設定或代理環境變數。先查看用戶端實際的 HTTP 或混合監聽連接埠,再依工具文件設定代理;例如 curl 可用單次命令參數指定代理,Git 則可設定自己的代理選項。若要接管更多不讀取系統代理的程式,再評估是否使用 TUN。排查時留意舊的 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 環境變數,它們可能仍指向已退出的用戶端或舊連接埠。修改變數後,也要確認目前終端機工作階段已更新;不要同時修改多種入口,否則很難判斷哪項設定生效。
規則模式下,某個網站用錯策略組該改哪裡?
先在連線頁面找到目標請求,查看實際網域、命中的規則與最終出站方式。規則通常依序比對,前面的寬泛規則可能比後面的精確規則更早生效;策略組也可能引用其他組別,因此要沿著組別關係確認最終選擇。若要調整單一網域的連線路徑,優先使用用戶端支援的覆寫或擴充規則功能,並依照該功能的插入順序說明操作。直接修改訂閱下載的檔案,可能在下次更新時被覆蓋。規則使用的策略組名稱必須確實存在;修改後重新載入設定並建立新連線,舊連線通常不會立即切換。
Windows UWP App 無法連線,什麼是本機迴圈存取限制?
這是 Windows 應用程式容器相關問題,與 macOS 權限設定無關。部分在應用程式容器中執行的 UWP App 預設無法存取本機迴圈位址,而桌面代理通常就在本機監聽,因此瀏覽器能正常連線,不代表這些 App 也能使用代理。可先使用 Windows 用戶端提供的迴圈存取豁免工具,依需求允許指定 App 存取本機代理,並依照管理員授權提示操作。若用戶端支援,也可評估透過 TUN 接管,但仍須檢查 App 本身的行為及其他防火牆限制。不要在 Mac 上尋找同名開關,也不要長期關閉整套防火牆來規避問題。
故障排除
先保留可用設定,再依序檢查訂閱擷取、遠端連線、網域解析與系統復原。
訂閱突然失效,或更新時回傳 401、403、404,該怎麼辦?
先查看服務提供者帳戶中的有效期限、流量狀態,以及訂閱網址是否已重設。401 通常與認證有關,403 可能涉及存取政策或帳戶限制,404 可能表示連結已變更,但仍應以服務提供者的說明為準。若取得的是登入頁面或驗證頁面,用戶端會因內容不是設定檔而無法解析。確認網址完整後再更新,並試試用戶端支援的直連或透過代理擷取方式,避免訂閱擷取路徑依賴已失效的連線。操作前先保留原本可用的設定,不要先清空所有訂閱;向服務提供者求助時,提供狀態碼與時間,切勿公開完整網址。
所有節點都逾時,或只有一個節點逾時,該如何縮小範圍?
先關閉代理,確認基本網路連線正常,再判斷是單一出站異常還是所有出站都異常。若只有一個節點逾時,可切換同一策略組中的其他出站方式,並確認該服務是否正在維護。若全部逾時,應核對訂閱狀態、系統時間、核心是否支援設定中的協定,以及記錄中的解析、交握或認證錯誤。連線測試逾時也可能是測試網址無法使用或逾時門檻太短,不要只憑測試結果就認定節點失效,可搭配實際網頁請求判斷。更換網路後恢復,通常表示目前的網路路徑有所不同;排查期間每次只更動一個條件,並記下結果。
啟用 TUN 後網域無法開啟,但部分 App 仍能連線,如何檢查 DNS?
先查看記錄是否出現網域解析失敗、DNS 請求逾時或路由迴圈,再確認目前設定中的 DNS 服務、TUN DNS 劫持與路由設定彼此相容。瀏覽器的安全 DNS、其他 VPN,以及系統自訂 DNS,可能讓不同 App 使用不同的解析路徑。macOS 的解析工具與 App 不一定走相同路徑,單次指令結果無法代表所有 App。若使用 fake-ip,應確認相關位址能正確被接管,並依照設定說明為不相容的區域網路服務設定例外。先還原一份已知可用的設定進行比對,不要同時更換 DNS、規則與所有節點。
退出用戶端後無法上網,如何還原 Mac 的網路設定?
若用戶端仍可開啟,先關閉系統代理與 TUN,再正常退出,觀察網路是否恢復。若 App 已異常退出,請前往「系統設定」的網路頁面,選取目前使用中的網路服務,並在詳細資訊的代理頁面檢查是否殘留指向本機的代理位址;關閉確認屬於該用戶端的項目,再套用設定。同時檢查其他 VPN、終端機代理環境變數,以及曾手動填入的 DNS。受管理裝置上的代理可能由組織設定,不要直接刪除。若 TUN 路由或輔助服務未正常清理,先儲存工作再重新啟動 Mac,接著用不經代理的請求確認基本網路是否正常。