這份 macOS 新手指南依照實際操作順序，說明如何安裝用戶端、授權系統權限、匯入訂閱，再確認流量是否經過選定線路。Mac 顯示「已連線」只代表用戶端的狀態，不表示所有 App 都已接入。首次設定時，建議先確認瀏覽器能正常連線，再處理分流與其他 App。
安裝前：確認用戶端來源與晶片類型
先開啟 Apple 選單中的「關於這台 Mac」，確認使用的是 Apple 晶片還是 Intel 處理器。若下載頁提供不同架構的安裝檔，請選擇相符版本；通用版本則依頁面說明使用。別只因檔名中有「Mac」就認定相容，也要確認用戶端支援的 macOS 版本。
VPN54 的 macOS 用戶端可從使用者面板的用戶端下載入口取得，登入後請查看最新下載說明。安裝檔、訂閱連結與方案是不同項目：安裝檔用來執行程式，訂閱用來載入線路設定，方案則決定可使用的服務資源。請勿將訂閱連結當成安裝檔下載網址。
- 從使用者面板查看下載說明，確認支援的系統與架構。
- 若下載的是磁碟映像檔，開啟後依指示將 App 拖曳至「應用程式」資料夾；若是安裝程式，則依步驟完成安裝。
- 從「應用程式」資料夾啟動用戶端，避免長期從已掛載的安裝映像檔執行。
- 首次開啟時，先確認 App 名稱與系統提示，再依用戶端說明繼續操作。
系統權限：分清代理、網路延伸功能與輔助服務
不同用戶端的網路接入方式各異，要求的權限也不相同。有些主要修改系統代理設定，有些使用網路延伸功能，另有些會透過特權輔助服務建立虛擬網卡。並非每款用戶端都需要依序取得上述權限；請依實際啟用的功能判斷，不要照抄其他軟體的截圖操作。
| 網路接入方式 | 主要用途 | 注意事項 |
|---|---|---|
| 系統代理 | 讓遵循系統代理設定的 App 透過本機代理轉送要求 | 部分 App 不會讀取系統代理設定，因此不能據此判定整台裝置的流量都已接入 |
| 網路延伸功能 | 透過 macOS 提供的網路延伸機制處理網路流量 | 可能需要允許延伸功能或新增 VPN 設定；授權後仍須確認用戶端狀態 |
| 虛擬網卡模式 | 將符合路由條件的流量交由用戶端處理 | 可能依賴網路延伸功能或輔助服務，但不代表所有目的地都會自動經過代理 |
若系統要求新增 VPN 設定，請先確認提示是由剛安裝的用戶端觸發，再決定是否允許。網路延伸功能的管理位置會因 macOS 版本而異，可在「系統設定」中搜尋「延伸功能」或「VPN」；部分版本也會在「隱私權與安全性」中顯示待處理提示。不要只依舊版教學中的固定路徑尋找按鈕。
若用戶端明確要求安裝輔助服務，系統可能會要求管理者授權。這是本機授權，不是登入服務帳戶。一般代理接入通常不需要螢幕錄製、輔助使用或完整磁碟存取權限；遇到這類要求時，請先閱讀相關功能說明。若裝置由學校或公司管理，設定可能受管理政策限制，請勿嘗試規避。
匯入訂閱：透過連結載入線路設定
訂閱連結通常會指向可更新的用戶端設定，其中可能包含線路、驗證資訊與規則。它不是要在瀏覽器中長期開啟的一般網頁。複製後，請貼到用戶端的「新增訂閱」、「從連結匯入」或類似功能中，而不是手動填入單一節點的伺服器位址欄位。
- 登入 VPN54 使用者面板，依頁面說明找到適用於目前用戶端的訂閱入口。
- 複製完整連結，避免漏掉尾端字元，或混入空格、換行與說明文字。
- 在用戶端新增訂閱，輸入方便辨識的本機名稱，儲存後執行更新。
- 確認線路清單已載入，再選擇可用線路或相應的策略群組。
- 啟用系統代理或用戶端要求的接入模式，再測試連線。
匯入成功不代表目前用戶端能辨識所有設定。Shadowsocks、VMess、Trojan、VLESS、Hysteria2 與 TUIC 是不同協定，各用戶端支援的範圍和設定格式也不相同。本文不表示目前的訂閱一定包含這些協定。若出現不支援協定或欄位的提示，請確認下載說明與訂閱格式，不要為了消除錯誤而任意刪除驗證參數。
首次連線：先使用規則模式，再確認實際路徑
用戶端中的「系統代理」與「規則模式」是不同設定。前者決定 App 要如何將要求送進用戶端，後者則決定進入後要使用代理或直接連線。規則模式通常會依網域、位址或其他條件分流；全域代理模式通常會將進入用戶端的要求交給指定代理，但仍無法保證未進入用戶端的 App 流量也會經過處理。
首次使用時，建議優先採用服務提供的規則設定，讓 DNS 與規則保持相互配合，先不要疊加自訂規則。先開啟常用的中國大陸網站，再連線至需要透過國際線路存取的目標網站。若發生異常，請查看用戶端連線記錄，確認要求是否進入用戶端，以及套用的是直連規則還是代理策略。
- ✅ 在IP 查詢頁面比較接入前後的出口資訊，確認是否符合目前策略。
- ✅ 同時查看用戶端連線記錄，確認目標要求使用的線路；單一查詢網站無法證明所有 App 都使用相同路徑。
- ✅ 分別測試瀏覽器與實際使用的 App。若瀏覽器連線成功、其他 App 失敗，請先確認後者是否遵循系統代理設定。
- ✅ 中斷連線後再測試常用網站，確認用戶端能正確還原系統代理與網路狀態。
若某個 App 不遵循系統代理，可先查看該 App 自己的代理選項；確實需要整台裝置接入時，再依用戶端文件設定虛擬網卡模式。不要同時執行多個會修改系統代理或路由的工具，否則很難判斷目前生效的是哪一組規則。
DNS 與線路：排查連線以外的問題
DNS 會將網域名稱轉換為網路位址。代理已連線，不代表 DNS 查詢也會依預期路徑傳送。用戶端可能採用本機解析、遠端解析或映射式解析；瀏覽器也可能啟用自己的加密 DNS。混用多組設定時，容易造成解析結果與分流目標不一致。
檢查 DNS 時，應搭配用戶端 DNS 記錄、規則設定與可信任的檢測工具一併判斷。檢測頁面顯示的解析服務所在地，不一定等於實際出口位置；單憑結果也無法證明隱私資訊外洩。更重要的是確認：原本應交由指定解析器處理的查詢，是否意外送往本機網路的解析器。排查時先還原用戶端建議設定，再逐一調整瀏覽器或系統中的自訂 DNS。
線路類型與權限問題也應分開處理。IEPL 專線描述的是線路的傳輸架構；中轉通常會透過中間入口轉送，直連則通常由本機網路直接連至目標服務節點。這些標示本身不保證特定網站永遠可用，也不代表端對端的所有路徑都相同。用戶端無法啟動或無法解析訂閱時，更換專線無法修正本機設定錯誤。
連線已建立但目標網站不穩定時，可在目前訂閱中切換線路，觀察同一目標是否恢復，再搭配連線記錄找出原因。節點清單請參閱線路頁面，實際可選項目以用戶端顯示為準。不要根據單次連線結果推論長期速度或串流影音可用性。
常見問題：依症狀縮小排查範圍
找不到允許延伸功能的按鈕
先確認目前用戶端是否確實使用網路延伸功能，以及是否已啟動安裝流程。若沒有觸發相關要求，系統不會出現允許按鈕。請退出後重新開啟用戶端，依說明再次啟用相關模式，再到系統設定中檢查。若裝置受組織管理，請洽管理者確認政策，不要反覆重新安裝。
訂閱更新失敗，線路清單空白
確認基本網路可以連上使用者面板，再檢查連結是否完整、是否選擇與用戶端相符的格式，以及面板中的方案狀態。若記錄顯示憑證或時間相關錯誤，請確認系統日期與時間。不要關閉憑證驗證來規避問題，也不要將完整訂閱連結貼進求助截圖。
用戶端顯示已連線，但瀏覽器無法開啟網頁
依序確認系統代理是否已啟用、是否選取線路、規則是否將目標交由預期策略處理，以及記錄中是否出現解析失敗。若所有網站都異常，先關閉其他網路工具，再重新連線。若只有特定網站有問題，請優先檢查該目標的規則、解析與線路結果，不要直接重設整台 Mac 的網路設定。
退出用戶端後無法正常連線
系統可能仍保留指向本機用戶端的代理設定，但相關程式已經退出。可先重新開啟用戶端，正常停用網路接入功能後再退出。若仍未恢復，請檢查目前網路服務的代理設定是否有殘留項目；若曾手動設定或公司網路另有要求，請先記錄原始值，只處理由本次安裝所造成且能確認的設定。
設定重點：先確認安裝來源與架構，再授予用戶端實際需要的權限，接著匯入格式相符的訂閱。交叉比對出口查詢與連線記錄後，再調整分流、虛擬網卡與 DNS。依此順序處理，可將安裝、權限、設定與線路問題分開，避免在多項設定間反覆嘗試。
若仍無法找出原因，可透過使用者面板支援單提供 macOS 版本、用戶端名稱、錯誤訊息與已嘗試的操作。提交記錄或截圖前，請先移除帳戶憑證、訂閱連結及其他個人資訊。更多一般說明請參閱說明中心。