v2rayN macOS 安裝教學：解除「無法驗證開發者」阻擋與設定網路權限

選擇安裝檔與 App 安裝位置

先點選畫面左上角的蘋果選單 →「關於這台 Mac」。若看到「晶片」及 Apple 晶片型號，請選 macOS ARM64；若看到「處理器」及 Intel 型號，請選 macOS x64。不要用安裝檔大小判斷架構，也不要嘗試在 macOS 上開啟 Windows 安裝檔。

安裝前可在「關於這台 Mac」記下系統版本，再確認所選版本的最低系統需求。系統版本不符與 Gatekeeper 阻擋是兩種不同問題；出現「此 App 無法在這部 Mac 上使用」不代表只要解除安全性阻擋即可。先確認晶片架構和系統需求，再仔細查看完整提示內容。

1. 確認晶片架構

   點選蘋果選單 →「關於這台 Mac」，依晶片資訊選擇 ARM64 或 x64；請從本站下載頁取得安裝檔。

2. 掛載映像檔

   按兩下下載的 DMG 檔，在開啟的磁碟映像視窗中找到 v2rayN App。若映像檔無法掛載，請先重新下載，不要直接變更系統安全性設定。

3. 移至應用程式

   將 v2rayN 拖曳至 Finder 的「應用程式」資料夾。等待複製完成後退出磁碟映像，再從「應用程式」啟動。

4. 記錄版本資訊

   記下 App「關於」頁面上的版本、系統版本和安裝檔架構。之後若發生錯誤，提供這些資訊會比只描述「打不開」更容易找出問題。

不要長期從磁碟映像或下載資料夾執行 App。固定安裝位置有助於後續更新、權限辨識及登入項目管理。更新前請先結束舊版程序；若舊版已啟用 TUN，請先關閉 TUN 並清除系統代理，再替換 App。

解除「無法驗證開發者」阻擋

Gatekeeper 會在 App 啟動時進行檢查。若提示「無法驗證開發者」或「無法確認是否包含惡意軟體」，核心通常尚未開始監聽連接埠，此時修改節點、訂閱或 DNS 無法解決啟動遭阻擋的問題。

1. 嘗試啟動 App

   在「應用程式」中按兩下 v2rayN，閱讀並關閉阻擋提示。只有在確認 App 來源可信後，才繼續操作。

2. 前往安全性設定

   點選蘋果選單 →「系統設定」→「隱私權與安全性」，向下查看「安全性」區域中最近遭阻擋的 App 記錄。

3. 允許這次開啟

   確認記錄中的 App 名稱，按一下「仍要打開」，依系統提示完成管理員驗證，再於後續確認視窗中選擇「打開」。

4. 再次確認

   返回「應用程式」再次啟動。若找不到相關記錄，請重新觸發一次阻擋後再查看；由組織管理的裝置應交由管理員處理。

不同 macOS 版本對 Finder 中按右鍵後選擇「打開」的處理方式不完全相同，不能假設這一定有效。請優先查看「隱私權與安全性」中的明確允許記錄。若裝置由公司或機構管理，「仍要打開」可能受管理政策限制；重複輸入管理員密碼也無法覆蓋這些政策。

系統代理與 TUN：先選擇流量接管方式

v2rayN 能正常開啟，不代表所有 App 的流量都已透過代理。系統代理會設定目前網路服務使用的代理伺服器，但各 App 是否遵循這些設定，取決於 App 本身的設計。TUN 則透過虛擬網路介面接管流量，還涉及路由、DNS 和權限；首次排查時，應分別測試這兩種方式。

若用戶端要求修改網路設定，只有在剛執行相關操作，且驗證視窗明確標示該 App 或其已知元件時，才授予權限。一般的系統代理設定不等於安裝網路擴充功能，也不需要為了連網授予「完全磁碟存取」或「輔助使用」權限。

• 查看系統代理：前往「系統設定」→「網路」→目前連線的 Wi-Fi 或乙太網路→「詳細資訊」→「代理伺服器」。記下 HTTP、HTTPS 或 SOCKS 對應的位址與連接埠。
• 確認本機位址：本機代理通常使用 127.0.0.1。連接埠必須與 v2rayN 實際監聽的連接埠一致，不要只因教學上寫了某個數字就直接照填。
• 結束前還原設定：在 v2rayN 中選擇「清除系統代理」，再結束用戶端。若 App 異常結束，請返回上述系統頁面，清除殘留的本機代理設定。

辨識網路擴充功能與網路權限

「網路擴充功能」、「VPN 設定」、「區域網路」和管理員驗證並非同一種權限。請先確認系統提示所指的權限類型，再前往相應設定。不同版本的 v2rayN 與執行方式可能採用不同的流量接管機制；若只啟用系統代理，沒有網路擴充功能提示也可能是正常情況。

若系統提示「加入 VPN 設定」，請先確認 App 名稱，再決定是否允許；之後可在系統設定中搜尋「VPN」查看相關項目。排查一般代理連線時，不要降低啟動安全性設定。啟動 TUN 後若網路中斷，請先關閉 TUN、清除系統代理，確認原本的網路已恢復，再查看用戶端記錄中的權限、路由和 DNS 錯誤。

• 沒有出現授權視窗：先確認是否真的啟用了需要額外權限的功能，而不只是開啟 App 視窗。
• 授權後仍無法使用：結束並重新啟動 App，檢查核心記錄。「權限不足」和「位址已被使用」需要採取不同的處理方式。
• 系統要求重新啟動：請先儲存工作，再依提示重新啟動。只重新開啟用戶端未必能完成系統元件的核准程序。

首次啟動後檢查連線

完成權限設定後，先匯入一份已知可用的設定。在 v2rayN 中開啟「訂閱群組」→「訂閱群組設定」，新增名稱與訂閱網址並儲存，再到「訂閱群組」選單執行更新。選單名稱可能依版本略有差異；重點是先儲存群組，再取得訂閱內容。只儲存網址不代表節點已成功匯入。

VMess、VLESS 是設定使用的協定名稱，並非 macOS 權限類型。訂閱網址用來取得設定清單，單一分享連結則代表一份設定，兩者應使用相應的匯入方式。訂閱帶入的 TLS、SNI、傳輸方式和路徑應維持原值，不要為了排除安裝問題而任意修改。

1. 先查看清單：更新後應該會看到設定項目。若清單為空，請檢查訂閱回應、群組篩選條件和更新記錄，不要先去核准網路擴充功能。
2. 再檢查核心：選取設定並設為作用中伺服器，查看記錄中是否有核心啟動失敗、缺少檔案或連接埠被占用的訊息。介面顯示運作中，不能取代對記錄的檢查。
3. 確認監聽連接埠：在「設定」→「參數設定」中查看本機監聽連接埠相關項目，再與系統網路代理頁面比對。以下命令中的 10808 僅為檢查範例，執行前請換成實際值。
4. 測試連線：先透過系統代理瀏覽平常可正常使用的 HTTPS 網站，再確認是否產生相應的連線記錄。延遲測試成功不代表所有 App 都已使用代理。

lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy

第一個命令用來查看該 TCP 連接埠是否正在監聽；輸出中的程序名稱與 PID 可用來辨識占用者。若沒有輸出，請先確認連接埠數值，再檢查核心是否正在執行。第二個命令會讀取系統目前的代理設定，可查看實際出現的 HTTPEnable、HTTPSProxy、HTTPSPort 等欄位。不要只看某個開關是否為 1，也要確認位址和連接埠是否正確配對。

安裝與權限常見問題