這篇 macOS 用戶端安裝與訂閱匯入教學，會從下載前檢查開始，依序處理應用程式安裝、系統權限、訂閱更新、節點選擇、分流驗證與故障排除。首次設定最容易卡住的地方通常不是線路本身，而是應用程式架構不相容、網路延伸功能尚未獲准、設定沒有真正啟用，或瀏覽器仍使用獨立的 DNS 與代理伺服器設定。
Mac 上的網路用戶端並不是簡單地「開啟就能使用」。為了接管需要代理伺服器的連線，用戶端可能會建立系統代理伺服器、虛擬網路介面或網路延伸功能。macOS 會將這些操作視為敏感的網路設定變更，因此首次啟動時出現系統確認視窗屬於正常流程。正確做法是核對應用程式來源與要求內容，再由目前使用者明確授權，而不是連續忽略提示後反覆匯入訂閱。
用戶端安裝前的檢查
先確認 Mac 使用的處理器架構與目前的 macOS 版本，再查看用戶端發布頁提供的安裝套件。Apple 晶片與 Intel 晶片使用不同架構，部分專案會分別提供建置版本，也有專案提供通用安裝套件。架構選錯時，常見情況包括應用程式無法開啟、啟動後立即結束，或系統要求透過相容層執行。
安裝套件應來自用戶端專案的正式發布管道、服務商控制面板中的下載入口，或系統應用程式商店。下載後先核對檔案名稱、應用程式名稱與發布者資訊是否與說明一致。若系統提示應用程式來自網際網路，確認來源後即可繼續；若提示檔案損毀、無法驗證開發者身分或簽章異常，應先重新下載並查看官方說明，不要將關閉系統保護當作一般安裝步驟。
- ✅ 確認處理器架構與安裝套件相容。
- ✅ 從正式發布管道或服務面板取得用戶端。
- ✅ 安裝前先退出同類代理伺服器用戶端，避免系統代理設定互相覆寫。
- ✅ 保留訂閱連結的原始文字，不要透過截圖或手動抄寫轉移。
- ❌ 不要將來源不明的設定描述檔加入系統設定。
- ❌ 不要因一次啟動失敗就長期關閉 macOS 的安全檢查。
常見的安裝方式是開啟磁碟映像檔，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。直接在下載資料夾或磁碟映像檔中長期執行，可能導致自動更新、輔助元件路徑或權限記錄異常。若用戶端以壓縮檔提供，也應先完整解壓縮，再將應用程式移至「應用程式」資料夾。
系統權限與網路延伸功能
用戶端首次開啟系統代理伺服器、增強模式或虛擬網路介面時，macOS 可能要求加入 VPN 設定、網路延伸功能或輔助元件。不同用戶端採用的接管方式不同，介面中的名稱也可能有所差異。系統代理伺服器通常只影響遵循系統代理設定的應用程式；虛擬網路介面可以處理更多類型的流量，但需要更高層級的系統授權。
授權時應閱讀系統視窗顯示的應用程式名稱，確認與剛才安裝的用戶端一致。接著使用 Mac 目前帳戶的系統驗證完成確認。若提示視窗已關閉，可進入系統設定中的隱私權與安全性、網路或 VPN 相關頁面，查看是否有等待核准的項目。核准後通常需要返回用戶端重新開啟對應模式，部分情況下還需要退出用戶端後再次啟動。
| 介面現象 | 可能原因 | 處理方向 |
|---|---|---|
| 系統代理伺服器已開啟，但部分應用程式仍直接連線 | 該應用程式不遵循系統代理設定，或自行實作網路堆疊 | 檢查用戶端是否支援虛擬網路介面，並核對分流規則 |
| 增強模式開啟後立即關閉 | 網路延伸功能尚未獲准，或輔助元件尚未完成安裝 | 前往系統設定檢查待核准項目，再重新啟動用戶端 |
| 選單列顯示已連線，但網頁無法開啟 | 節點無法連線、DNS 解析失敗或規則設定衝突 | 切換節點、恢復預設規則，並分別測試網域名稱與網路位址 |
| 退出用戶端後仍有網路異常 | 系統代理設定殘留，或其他網路工具仍在接管連線 | 關閉系統代理設定，退出同類工具，再重新連線至本地網路 |
如果系統設定中有舊用戶端留下的 VPN 設定或網路延伸功能，不要在未確認用途的情況下全部刪除。先退出舊用戶端，確認不再使用相關設定後，再逐項移除。企業裝置可能由管理政策控制網路延伸功能，此類裝置應遵循組織的管理要求，個人帳戶不一定具備核准權限。
訂閱匯入與設定更新
用戶端可以正常啟動，不代表已經擁有可用設定。登入服務面板後，找到適用於通用用戶端或目前平台的訂閱入口。複製時應使用頁面提供的複製按鈕，避免瀏覽器截斷連結結尾的字元。訂閱連結本質上具備存取設定的能力，不應發布到公開頁面、分享截圖，或貼到不可信的線上轉換工具。
不同用戶端的入口可能標示為「訂閱」、「設定」、「遠端設定」或「設定檔」。選擇從剪貼簿或 URL 匯入，貼上完整連結後儲存，再執行更新。更新成功後通常會出現節點清單、策略群組或設定名稱。如果儲存後清單仍為空白，先查看更新錯誤，不要連續建立多個同名訂閱；重複設定會讓後續切換與排錯更加困難。
- 開啟服務面板，複製適用於目前用戶端的訂閱連結。
- 進入用戶端的訂閱或設定管理頁面，選擇透過 URL 新增。
- 為設定填寫容易辨識的名稱，貼上連結並儲存。
- 執行一次手動更新，確認節點或策略群組已經出現。
- 選擇目標節點，再啟用系統代理伺服器或虛擬網路介面。
- 完成網頁、DNS 與應用程式連線測試，確認規則依預期生效。
訂閱中可能包含 Shadowsocks、VMess、Trojan、VLESS、Hysteria2 或 TUIC 等協定。協定名稱描述的是用戶端與節點之間的連線方式，不等同於線路品質。用戶端必須支援訂閱實際使用的協定及其參數；舊版本即使能辨識節點名稱，也可能無法解析新欄位。遇到「未知協定」、「設定無效」或匯入節點後無法選取時，應先更新用戶端，再核對訂閱格式是否相容。
匯入訂閱與匯入單一節點並不是同一件事。單一節點連結只包含一個連線設定，服務端調整後通常需要重新取得；訂閱連結則可由用戶端主動更新，方便同步節點變更。日常使用應保留一個清楚標示的主要訂閱，並在用戶端支援的情況下開啟合理的自動更新。更新失敗時，舊設定可能仍顯示在清單中，因此「看得到節點」不能證明訂閱剛剛更新成功。
匯入後檢查路徑
設定名稱 → 更新結果 → 節點清單 → 策略選擇 → 接管模式 → 存取驗證
排錯時一次只修改一項
先恢復預設規則
再切換節點
接著檢查 DNS
最後檢查應用程式本身的代理設定節點、線路與接管模式如何選擇
節點名稱通常會呈現國家或地區、城市、線路類型與用途標記。對首次使用者來說，不必一開始就追求複雜的策略組合。選擇地理位置合適、用戶端測試可連線的節點，再使用預設規則完成驗證，比同時調整協定、DNS、規則集與介面參數更容易定位問題。
直連線路是裝置直接連線至目標節點，路徑簡單，但跨境鏈路容易受到本地電信業者路由變化影響。中轉線路會先抵達中轉入口，再進入跨境路徑，重點在於改善入口品質與路由安排。IEPL 專線通常用於對穩定性要求較高的跨境傳輸情境，其線路安排方式與一般公網直連不同。線路名稱只能說明服務方的分類，實際選擇仍應結合所在地網路、目標應用程式與連線表現。
系統代理伺服器適合瀏覽器與遵循系統設定的桌面應用程式，設定簡單，也方便隨時關閉。虛擬網路介面常被用戶端稱為增強模式或 TUN 模式，可以涵蓋更多應用程式與非傳統代理流量，但也更容易與防火牆、其他 VPN、虛擬機器網路及企業管理工具發生衝突。首次安裝建議先使用系統代理伺服器驗證訂閱與節點，再依應用程式需求決定是否啟用虛擬網路介面。
全域模式會讓大部分可接管流量經過目前的代理策略，適合短暫排查「規則是否漏掉目標連線」。規則模式則根據網域名稱、網路位址或應用程式規則決定直連或代理，更適合日常使用。全域模式不代表所有資料都必然經過同一路徑，區域網路存取、系統服務與用戶端排除項目仍可能依自身規則處理。
DNS、分流與連線驗證
連線按鈕變為啟用狀態後，需要分別驗證出口路徑、DNS 解析與分流結果。先開啟網路檢測頁面，觀察目前出口是否符合所選節點，再造訪需要代理及應直接連線的網站，確認兩類流量都能正常運作。若只有輸入網路位址可以存取，而網域名稱無法存取，問題通常更接近 DNS；若瀏覽器正常但桌面應用程式失敗，則應檢查該應用程式是否繞過系統代理設定。
DNS 洩漏是指網域名稱查詢沒有依預期交給用戶端設定的解析路徑，而是繼續送往本地網路提供的解析伺服器。它不一定會導致網頁無法開啟，但可能讓分流判斷失準，也會使網域名稱查詢路徑與出口路徑不一致。若用戶端提供 DNS 接管、加密 DNS 或遠端解析選項，應優先使用專案推薦的預設設定，不要同時在瀏覽器、系統與用戶端設定多套彼此衝突的解析方案。
部分瀏覽器內建獨立的安全 DNS 設定，可能繞過用戶端的系統解析設定。排查時可以暫時恢復瀏覽器預設值，確認用戶端的 DNS 路徑正常後，再決定是否使用瀏覽器自己的解析功能。若公司網路、校園網路或飯店網路要求先透過入口網站驗證，應先在未接管狀態下完成本地網路登入，再啟動用戶端。
- ✅ 節點狀態顯示已連線，且沒有持續重新連線。
- ✅ 網路檢測結果與目前選擇的出口地區一致。
- ✅ 需要代理的網域名稱可以正常解析與存取。
- ✅ 本地網站與區域網路資源仍依分流規則存取。
- ✅ 關閉用戶端後，系統網路可以恢復正常。
- ❌ 不要只用單一網頁的開啟結果判斷所有應用程式的狀態。
驗證分流時，最有效的方法是一次只觀察一個目標。先使用預設規則，確認基礎連線成立；再查看用戶端連線記錄，判斷目標網域名稱命中了代理、直連或拒絕規則。若某個應用程式使用固定網路位址、QUIC 或內建代理，其表現可能與瀏覽器不同。此時應針對應用程式實際的連線方式調整規則，而不是將所有流量永久切換至全域模式。
常見權限錯誤與恢復順序
「無法新增設定」通常與系統授權未完成、舊設定衝突或目前帳戶權限不足有關。先退出其他同類用戶端，再到系統設定檢查現有 VPN 與網路延伸功能。確認舊設定確實不再使用後才移除，並重新啟動目前用戶端以觸發授權。反覆點選連線而不處理系統設定中的待核准項目，通常不會改變結果。
「輔助元件安裝失敗」可能發生在應用程式未放入「應用程式」資料夾、應用程式路徑變更、簽章驗證失敗或舊元件仍在執行時。應退出用戶端，將應用程式移至正確資料夾，從正式來源重新安裝，然後再次啟動。若用戶端提供內建的解除安裝輔助元件功能，應優先使用該功能，而不是手動刪除不確定的系統檔案。
「訂閱更新失敗」需要區分網路無法連線、連結失效、格式不相容與系統時間異常。可以先在服務面板重新複製連結，查看用戶端錯誤資訊，再確認 Mac 的日期與時間採用正常同步設定。不要將訂閱連結直接貼到一般搜尋框測試，因為連結可能包含存取憑證。若服務面板提供重設訂閱入口，可在確認舊連結需要失效後再操作。
「已連線但沒有網路」適合按照固定順序處理：先關閉虛擬網路介面並退回系統代理伺服器，恢復預設分流規則，切換至另一個可用節點，接著檢查 DNS。如果退出用戶端後仍無法存取，則檢查系統代理設定是否殘留，並重新連線目前的 Wi-Fi 或有線網路。只有排除這些基礎項目後，才需要考慮重新安裝。
排錯原則是保留可重現的路徑：記錄錯誤發生在安裝、授權、更新、連線還是解析階段，一次只變更一個變數。若同時替換用戶端、節點、模式、DNS 與規則，問題可能暫時消失，卻無法確認真正原因。
需要徹底重新安裝時
徹底重新安裝前，先匯出自行編寫的規則，記錄目前訂閱名稱與必要設定，但不要將包含憑證的訂閱連結放進公開筆記。接著在用戶端中關閉系統代理伺服器與虛擬網路介面，使用專案提供的解除安裝入口移除輔助元件，再退出應用程式。刪除應用程式後重新啟動 Mac，可以減少舊程序或網路延伸功能仍被占用的情況。
重新安裝時不要立即恢復所有自訂設定。先匯入主要訂閱，使用預設規則與系統代理伺服器完成基礎驗證，再逐項恢復 DNS、規則與增強模式。如此可以判斷問題來自安裝環境，還是來自舊設定。若預設設定可以正常連線，而恢復某項設定後問題再次出現，該設定就是下一步應檢查的範圍。
日常使用與設定維護
完成首次安裝後，應保留簡單且可恢復的設定結構。主要訂閱使用清楚的名稱，自訂規則與服務端下發的規則分開管理；更新用戶端前先查看發布說明，尤其留意協定支援、網路延伸功能與設定格式的變更。訂閱更新後若節點清單有所變化，應以更新結果為準，不要長期依賴已從訂閱中移除的本地副本。
離開不可信任的公共網路前後，可以重新檢查系統代理伺服器與虛擬網路介面的狀態。休眠喚醒或網路切換後，長連線可能沿用舊的網路狀態，遇到連線停滯時先中斷再重新連線，不必立刻清空設定。若從 Wi-Fi 切換到有線網路或個人熱點，用戶端需要重新建立路徑，短暫重新連線屬於正常現象。
最後，訂閱連結應像帳戶憑證一樣妥善保管。無需電子郵件地址即可使用使用者名稱與密碼開通本服務，但本機仍應使用獨立且妥善保存的憑證。用戶端記錄可以協助定位連線階段，卻可能包含節點位址、網域名稱或設定片段；提交給支援人員前，應先檢查內容並移除與排錯無關的敏感資訊。