macOS 新手指南：安裝用戶端、授予系統權限、匯入訂閱完整教學

安裝前準備：用戶端、處理器架構與訂閱資訊

先登入服務面板，在下載區取得適用於 macOS 的用戶端，並在訂閱區複製自己的訂閱連結。用戶端安裝包與訂閱連結負責不同工作：安裝包提供連線能力，訂閱連結提供節點、協定與更新入口。只安裝用戶端而未匯入訂閱，通常不會出現可連線的線路。

確認處理器架構

Mac 可能使用 Apple 晶片，也可能搭載 Intel 處理器。若下載頁分別提供安裝包，應選擇與本機架構一致的版本；若提供通用安裝包，則可直接使用。架構不相容時，常見情況包括應用程式無法開啟、啟動後立即關閉，或系統要求額外的相容執行環境。

可在系統的「關於這台 Mac」頁面查看晶片或處理器資訊。這裡不需要修改任何系統參數，只要讓安裝包類型與裝置相符即可。若用戶端同時提供圖形介面版與命令列版，新手應優先選擇圖形介面版，方便查看訂閱更新時間、目前線路與代理模式。

辨識用戶端支援的協定

訂閱中的線路可能使用 Shadowsocks、VMess、Trojan、VLESS、Hysteria2 或 TUIC。用戶端必須支援相應協定，才能解析並建立連線。匯入後線路列表為空，不一定代表訂閱失效，也可能是用戶端版本過舊，或目前用戶端不認識訂閱中的協定欄位。

• ✅ 安裝包來自服務面板或用戶端官方發布管道。
• ✅ 已確認本機處理器架構與安裝包相符。
• ✅ 已複製完整訂閱連結，並保存在非公開位置。
• ✅ 系統日期、時間與時區均為自動同步。
• ❌ 不要從不明轉載頁面下載經過重新封裝的安裝包。

安裝用戶端並授予系統權限

開啟下載的安裝包後，依照提示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。若長時間直接在磁碟映像檔或下載資料夾中執行，可能導致自動更新、輔助程序或權限保存異常。首次開啟時，macOS 會檢查開發者簽章，也可能提示應用程式需要加入 VPN 設定或網路擴充功能。

為什麼需要網路擴充功能權限

系統代理模式主要修改 macOS 的代理設定，讓遵循系統代理的應用程式將流量交給本機用戶端。通道模式則透過 Apple 提供的網路擴充功能介面接管更廣泛的網路連線。無論採用哪種方式，用戶端都不應繞過系統安全機制來取得權限；正確做法是回應 macOS 顯示的授權視窗。

當系統詢問是否允許加入 VPN 設定、網路擴充功能或過濾網路內容時，先核對視窗中的應用程式名稱，再依照系統提示確認。部分操作會要求輸入目前 Mac 使用者的登入密碼或使用本機身分驗證，這是 macOS 授權系統設定變更的正常流程，並非訂閱服務在蒐集憑證。

1. 將用戶端移至「應用程式」資料夾並啟動。
2. 閱讀系統彈出視窗，確認申請權限的應用程式名稱正確。
3. 允許加入 VPN 設定或啟用網路擴充功能。
4. 返回用戶端，確認狀態列沒有「尚未授予權限」的提示。
5. 暫時不要啟用全域模式，先完成訂閱匯入與基本驗證。

權限視窗沒有出現怎麼辦

先退出用戶端，再從「應用程式」資料夾重新開啟。接著進入系統設定中的隱私權與安全性區域，查看頁面底部是否有遭阻擋的系統軟體或擴充功能提示；也可以在網路相關設定中查看是否已建立對應的 VPN 設定。已授權過的用戶端不會每次重複顯示視窗，因此「沒有彈出視窗」不等於缺少權限。

如果系統顯示擴充功能遭封鎖，只應允許與目前用戶端開發者名稱一致的項目。允許後依照系統提示重新啟動用戶端或裝置。若用戶端曾被手動移動、重新命名或覆蓋安裝，先徹底退出舊程序，再在不變更應用程式名稱的情況下重新安裝，避免授權記錄指向舊路徑。

匯入訂閱連結並讀取線路

開啟用戶端的訂閱、設定或遠端設定頁面，選擇「從剪貼簿匯入」或「新增訂閱連結」。名稱可自行填寫方便辨識的服務名稱，網址欄則貼上從面板複製的完整連結。匯入後執行一次更新，讓用戶端從伺服器讀取目前線路與分組。

訂閱連結不是單一節點網址。它通常會回傳一組經過編碼或結構化的設定，其中包含線路名稱、伺服器位址、連接埠、協定參數與分組資訊。用戶端完成解析後，才會將這些內容顯示為可選擇的節點。之後線路調整時，使用「更新訂閱」即可同步，不需要逐一手動修改。

匯入成功但沒有線路

先查看用戶端顯示的錯誤類型。如果是網路請求失敗，檢查目前網路能否存取訂閱網址；如果是解析失敗，更新用戶端；如果是驗證或連結無效，回到使用者面板重新複製訂閱。複製連結時不要帶上說明文字、引號、換行或結尾空格，也不要把網頁網址誤當成訂閱網址。

部分用戶端允許直接匯入單一 Shadowsocks、VMess、Trojan 或 VLESS 分享連結，這與匯入訂閱不同。單一匯入只能取得目前設定，服務端更新線路後不會自動同步。長期使用應保留訂閱入口，並由訂閱更新維護節點列表。

選擇協定與線路類型

協定決定用戶端與伺服器如何封裝及傳輸資料，線路類型則描述流量經過的網路路徑。直連線路從目前網路直接連至遠端節點，路徑簡單，但品質更依賴本地電信業者與國際出口。中轉線路先連線至入口，再由中轉網路送往出口，通常更容易控制跨網路徑。IEPL 專線強調相對獨立的跨境承載路徑，與一般公網直連並非同一概念。

Hysteria2 與 TUIC 以 QUIC 概念處理傳輸，在丟包環境下可能呈現不同於傳統 TCP 方案的恢復特性；Trojan、VLESS、VMess 與 Shadowsocks 的可用表現也取決於用戶端實作、伺服器設定與實際網路。不能只根據協定名稱判斷速度，應在相同網路與相近時段比較建立連線、網頁回應及長連線穩定性。

選擇代理模式並驗證連線

匯入訂閱後，先選擇一條線路，再啟用規則模式或系統代理模式。規則模式會根據網域、位址範圍與應用程式請求，決定使用代理或直連，適合日常使用；全域模式會將更多流量送入遠端線路，方便短時間診斷，但可能讓本地網站、區域網路裝置或軟體更新繞行。直連模式通常表示用戶端維持執行，但請求不經過遠端節點。

系統代理與通道模式的差異

系統代理依賴應用程式遵循 macOS 的代理設定。瀏覽器與多數一般網路程式通常可以使用，但自行實作網路堆疊的應用程式可能忽略它。通道模式在系統網路層處理連線，涵蓋範圍更廣，也更適合需要 UDP 或完整接管裝置流量的情境，但會申請更高層級的網路擴充功能權限。

第一次驗證時，不要同時開啟兩個不同的用戶端，也不要讓瀏覽器擴充功能、其他代理工具與系統通道疊加運作。多個本機代理同時修改系統設定，可能造成連接埠占用、代理循環，或關閉用戶端後代理設定仍殘留等問題。

• ✅ 用戶端狀態顯示已連線，且目前線路名稱清楚。
• ✅ 一般網頁與目標國際網站都能正常開啟。
• ✅ 關閉連線後，系統網路能恢復原本狀態。
• ✅ 在規則模式下，本地服務與區域網路資源仍可存取。
• ❌ 不要同時執行多個會接管系統代理的用戶端。
• ❌ 不要使用公開檢測頁面提交完整訂閱網址。

檢查 DNS 與分流是否一致

DNS 負責將網域解析為網路位址。若網域請求由本地網路解析，而後續連線卻透過遠端線路傳送，可能出現解析結果與出口地區不一致，也可能形成 DNS 洩漏。排查時應查看用戶端的 DNS 模式、分流規則，以及系統目前使用的解析服務是否彼此相符。

啟用通道模式後，可使用可信任的 DNS 檢測頁面，觀察解析請求是否仍指向不期望的本地網路。檢測結果需要結合用戶端設定判讀：出現本地解析服務不一定代表連線失敗，規則模式本來就可能讓直連網域使用本地 DNS；真正需要修正的是原本應經過遠端線路的網域，卻持續由錯誤路徑解析。

如果網頁能開啟但某個應用程式無法連線，先判斷該應用程式是否忽略系統代理。可以暫時切換到通道模式確認涵蓋範圍，也可以在用戶端規則中檢查該應用程式存取的網域或位址是否被誤判為直連。不要把所有異常都歸因於節點速度，分流規則命中錯誤往往更常見。

常見故障的排查順序

故障排查應從影響範圍最小的操作開始。先重新整理訂閱並切換線路，再檢查模式與權限，最後才考慮重新安裝。直接刪除用戶端可能同時清除日誌、訂閱及有助於定位問題的狀態，反而不利於判斷故障發生在哪一層。

擴充功能遭封鎖或連線按鈕沒有反應

開啟系統設定的隱私權與安全性區域，確認是否有待批准項目；再查看網路設定中的 VPN 設定是否啟用。若設定存在但用戶端仍提示未授權，退出用戶端並重新啟動。仍沒有反應時，移除對應的舊網路設定，再由用戶端重新發起新增請求，過程中只處理與該用戶端相符的項目。

訂閱更新失敗

先確認基本網路可用，再重新複製訂閱網址。若瀏覽器能存取服務面板，但用戶端無法更新，請檢查系統時間、用戶端版本，以及是否有其他代理工具攔截請求。若訂閱網址已洩露或被重設，應在面板產生新的入口，並從所有用戶端刪除舊設定。

連線後無法開啟網頁

依序嘗試更新訂閱、切換線路、改用規則模式、檢查 DNS 設定。若只有瀏覽器異常，可關閉瀏覽器中的獨立代理擴充功能後重試；若所有應用程式都異常，請重點檢查通道權限、殘留的系統代理，以及目前網路是否限制所選傳輸方式。切換協定用於診斷時，應選擇訂閱中已有的設定，不要自行猜測伺服器參數。

關閉用戶端後仍然無法連網

這通常與系統代理未恢復有關。重新開啟用戶端，先執行中斷連線或關閉系統代理，再正常退出。如果用戶端已無法啟動，可進入 macOS 網路設定，檢查目前網路服務的代理項目是否仍啟用。清除殘留設定後重新連線網路，不必修改路由器或刪除其他網路服務。

1. 確認本地網路本身可以存取一般網站。
2. 更新訂閱並查看具體錯誤提示。
3. 切換同一分組中的其他線路。
4. 檢查規則模式、系統代理與通道模式是否衝突。
5. 檢查網路擴充功能、VPN 設定與 DNS 設定。
6. 退出其他代理工具後再次測試。
7. 保留錯誤資訊，再決定是否重新安裝用戶端。

日常更新與設定維護

用戶端正常運作後，日常維護主要包括更新訂閱、更新用戶端與檢查規則。訂閱更新負責同步線路，用戶端更新負責支援新的協定欄位與系統介面，兩者無法互相取代。macOS 更新後若連線行為改變，應先確認用戶端是否相容於目前系統，再重新檢查網路擴充功能狀態。

不要頻繁建立重複訂閱。同一入口多次匯入後，線路列表會出現重複名稱，排查時難以確認實際使用的是哪一組設定。保留一個有效訂閱，為它設定清楚的名稱，並使用用戶端內建的更新功能維護即可。

更換 Mac 時，應從使用者面板重新取得用戶端與訂閱，而不是複製整個應用程式資料夾。系統網路擴充功能的授權記錄與本機環境相關，直接搬移舊檔案不能取代新裝置上的系統授權。完成移轉後，刪除舊裝置中的訂閱設定，減少連結長期留存在不再使用的裝置上。

最後記住完整流程：用戶端負責執行，系統權限允許接管網路，訂閱負責下發線路，協定負責傳輸，分流規則決定路徑，DNS 負責網域解析。任何一步異常都可能表現為「連不上」，但依層次檢查，就能快速縮小範圍。