在 Mac 上使用 VPN，重點不只是開啟連線，還要確認用戶端、訂閱格式與 macOS 網路權限彼此相容。本指南依實際操作順序介紹 macOS 安裝與訂閱匯入：先確認軟體來源，再匯入設定，最後分別檢查網路出口、分流與 DNS，避免把「已連線」誤認為所有 App 都已生效。
準備工作：確認 Mac 晶片架構與用戶端來源
開啟蘋果選單中的「關於這台 Mac」，查看裝置使用 Apple 晶片還是 Intel 處理器。下載時選擇相符的架構；若有通用版本，請依照發行說明使用。能下載安裝檔不代表適用於目前系統，也請確認用戶端所需的 macOS 版本，避免將相容性問題誤判為線路故障。
VPNJY 使用者請從面板取得用戶端，不要因搜尋結果中出現同名軟體就自行更換。若面板要求登入，請使用既有的使用者名稱和密碼；新使用者無需電子郵件地址。安裝前也請確認面板中有可用方案和設定，別把「軟體安裝完成」當成服務已啟用。
協定名稱和用戶端名稱並不相同。Shadowsocks、VMess、Trojan、VLESS、Hysteria2、TUIC 是否支援，取決於用戶端核心及其版本；介紹中出現某個名稱，也不代表該用戶端支援此協定的所有參數。請以面板目前提供的設定及用戶端相容性說明為準，不能只因訂閱連結可以貼上，就認定兩者相容。
安裝與權限：先確認來源，再允許執行
- 完成安裝。磁碟映像通常需要將 App 拖曳到「應用程式」資料夾；安裝程式則依照畫面指示完成。安裝後請從「應用程式」啟動，避免長期直接從已掛載的磁碟映像執行，以免更新或輔助元件定位異常。
- 判斷首次開啟提示。從網路下載的 App 可能會出現確認提示。請先核對下載來源與發行說明，再決定是否繼續。若系統提示無法驗證開發者，確認來源可信後，可前往「系統設定 → 隱私權與安全性」，查看是否有允許開啟該 App 的選項。
- 依功能授予網路權限。用戶端可能會要求新增 VPN 設定、啟用網路延伸功能或安裝輔助工具。這些權限各自對應不同的網路接管方式，並非每款軟體都會全部要求；系統路徑及提示文字也可能因版本而異。
- 返回用戶端確認狀態。完成系統確認後，部分用戶端需要重新啟用連線。若系統明確要求重新啟動，請先儲存工作再操作；不必把重新啟動當成所有問題的預設解法。
不要為了處理提示而關閉系統防護。「App 已損毀」可能與檔案不完整、簽章或相容性問題有關；若出現「會損害你的電腦」等惡意軟體警告，請停止執行並確認來源。不要照抄來路不明的終端機指令，大量移除隔離標記；一般網路功能也不需要隨意授予完整磁碟存取權限。
一般代理連線通常不需要輔助使用或螢幕錄製權限。若用戶端額外要求這類權限，請先閱讀功能說明。由組織管理的 Mac 可能限制安裝網路延伸功能，遇到這種情況請聯絡裝置管理員，不要嘗試繞過管理政策。
匯入訂閱：分清連結、設定與節點
訂閱連結是用戶端取得設定的入口，內容可能包含節點、策略群組和規則，也可能只有節點清單。它不是一般的行銷網頁網址，更不是登入密碼。不同用戶端可能採用不同訂閱格式，建議優先使用面板提供、適用於目標用戶端的一鍵匯入功能，或複製相應格式的訂閱網址。
- 在面板複製相應的訂閱。先確認選擇的用戶端是目前使用的 macOS App。不要複製瀏覽器網址列中的面板頁面網址，也不要刪掉連結末尾的參數。
- 在用戶端新增遠端設定。功能入口可能標示為「訂閱」、「設定」或「Profiles」。貼上完整網址並儲存；若使用一鍵匯入，請確認系統開啟的是預期的 App。
- 手動更新並啟用。看到更新成功後，確認是否出現節點或策略群組，再選取這份設定。清單中有設定但尚未啟用，執行時仍可能使用舊設定。
- 選擇線路並連線。先保留預設規則，選擇面板列出的可用線路，啟用系統代理或用戶端建議的連線模式，再開啟目標網站進行測試。
匯入失敗時，先確認錯誤發生在哪個階段。下載失敗，請檢查基本網路、連結是否完整及訂閱是否仍有效；解析失敗，通常與格式或核心相容性有關；若已顯示節點但無法連線，則請繼續檢查線路、方案狀態及網路接管模式。重新安裝用戶端通常無法解決訂閱格式不相容的問題。
請將訂閱連結視為敏感憑證。持有連結的人可能藉此取得連線設定，請勿將連結放在公開截圖、程式碼儲存庫或線上轉換網站。若需要轉換格式，請優先依照面板說明操作；若懷疑連結已外洩，請使用面板提供的重設功能，再更新各裝置上的設定。
如何選擇系統代理、隧道模式與分流
系統代理通常會讓遵循 macOS 代理設定的 App 透過用戶端連線，但終端機工具、部分遊戲或採用自有網路堆疊的 App 可能不會遵循這項設定。TUN 或類似的隧道模式會透過虛擬網路介面處理流量，接管範圍通常較廣，也更仰賴網路延伸功能、路由與 DNS 設定。實際行為依用戶端的實作方式而定。
| 方式 | 適用情況 | 注意事項 |
|---|---|---|
| 系統代理 | 先測試瀏覽器與一般桌面 App | 目標 App 是否遵循系統代理設定 |
| TUN／隧道模式 | 需要處理不遵循系統代理的 App | 延伸功能權限、路由、DNS 與軟體相容性 |
| App 內代理 | 只為特定工具設定連線路徑 | 代理類型、監聽位址及用戶端實際使用的連接埠 |
| 系統內建 VPN | 使用系統支援的協定及相符設定 | 無法直接匯入任意代理用戶端的訂閱 |
分流規則會決定哪些連線直連、哪些透過代理。日常使用可先採用服務提供的預設規則；「全域」通常表示由用戶端接管的流量使用指定代理策略，不代表系統代理模式下的所有 App 都已被接管。請勿同時修改模式、規則和 DNS，否則發生問題時不易找出原因。
線路類型也不能取代用戶端設定。直連通常表示從本地直接連至境外節點；中轉則會經過額外的轉發入口；IEPL 專線描述的是特定承載鏈路。這些都不等於流量接管模式，也不能光憑名稱推測實際速度；請參考面板說明及目標 App 的實際使用狀況來選擇。
驗證連線是否生效：分別檢查出口、App 與 DNS
先確認用戶端沒有連線錯誤，再前往我的 IP，比較連線前後的出口資訊。查詢本身也會受到分流規則影響：若該網站設定為直連，顯示本地出口不一定代表代理失效；出口有所變化，也只能證明這次請求的路徑不同，不能據此認定每個 App 都走相同路徑。
- ✅ 瀏覽器能開啟目標網站，並完成登入或載入實際內容，而不只是顯示首頁。
- ✅ 在用戶端的連線清單中，確認目標 App 的請求及規則匹配結果；不要只看連線開關。
- ✅ 個別測試終端機工具；若瀏覽器正常但命令列失敗，請檢查工具支援的代理設定及環境變數。
- ✅ 檢查 DNS 請求是否經過預期路徑，並留意瀏覽器的安全 DNS 設定是否覆蓋用戶端設定。
- ✅ 中斷連線後，原本可用的網站仍能正常存取，確認系統代理及網路設定已還原。
DNS 洩漏是指網域名稱解析請求經過非預期路徑，不是「測試頁顯示陌生服務商名稱」就能直接下結論。用戶端可能使用遠端解析、加密解析或虛擬位址映射，瀏覽器也可能另外設定解析器。請綜合用戶端文件、連線記錄及測試結果判斷，不要為了讓測試頁面看起來正常就隨意更換 DNS。
macOS 與其他平台的權限設定入口及背景執行機制不同，照搬行動裝置的截圖容易找錯設定。即使都稱為「規則模式」，不同用戶端的 DNS、路由及 App 接管能力也可能不同，因此請在目前使用的 Mac 上完成驗證。
常見問題：依症狀逐步排查
連線正常，但部分 App 無法存取
先確認是不是只有該 App 無法使用，再檢查它是否遵循系統代理設定。終端機工具可能會讀取代理環境變數，也可能需要個別參數；變數名稱及支援方式依工具而異，不建議套用通用指令。若確實需要啟用隧道模式，請依文件操作，並留意它與企業 VPN、過濾軟體或其他網路延伸功能是否衝突。
連線後整個網路都無法使用
先中斷用戶端連線，確認基本網路恢復後，再檢查是否有其他代理軟體同時接管流量。若退出用戶端後仍無法連線，可前往「系統設定 → 網路」查看目前網路服務的代理設定，確認是否還指向已停止的用戶端本機代理。只移除這次新增的設定，不要刪除組織要求的網路設定。
訂閱更新成功，節點卻無法使用
訂閱更新成功只代表設定已取得。請接著確認面板中的方案狀態及剩餘流量，再試用面板列出的其他線路。VPNJY 月訂閱流量會在開通日重設；流量包用完為止，永久不會過期。請勿把流量用盡和用戶端權限故障混為一談，也不必為了排查問題一再重設訂閱連結。
回報問題前，請先準備這些資訊
記錄 macOS 版本、晶片架構、用戶端及核心版本、連線模式、完整錯誤訊息，以及問題是否只在特定網路出現。截圖前請遮住訂閱網址、權杖及帳號資訊；記錄檔也可能包含目標網域。可透過面板工單提交與故障相關的必要資訊，避免公開整份設定。