2026-09-15 · 桌面平台 · 約 12 分鐘

v2rayN macOS 安裝與權限設定：解決「無法驗證開發者」及網路權限問題

整理 v2rayN 在 macOS 的安裝流程，說明如何在「隱私權與安全性」中允許開啟未經驗證的開發者 App，並設定網路擴充功能與系統代理權限。

本文重點

適合第一次在 Mac 安裝 v2rayN，或已開啟用戶端、卻卡在代理授權與網路連線檢查的使用者。先確認處理器架構和安裝位置，再處理 Gatekeeper 提示，最後分別確認核心、系統代理與 TUN。允許 App 啟動、修改網路設定的權限，以及核准網路擴充功能，是不同步驟，不能只允許一次就略過其他檢查。

一、macOS 安裝檔與處理器架構

v2rayN 的 macOS 版本採用跨平台桌面介面；WPF 版是 Windows 專用，無法用於 Mac。下載前先開啟蘋果選單中的「關於這台 Mac」，查看顯示的是「晶片」還是「處理器」。Apple 晶片機型優先選擇 macOS arm64 版本，Intel 處理器則選擇 macOS x64 版本。不要只看檔名中是否有 v2rayN，就判斷能不能執行。

  1. 確認 Mac 機型

    前往蘋果選單 →「關於這台 Mac」，記下晶片類型與 macOS 版本，再對照下載頁標示的系統需求。架構相符不代表舊版系統一定符合執行需求。

  2. 選擇安裝檔

    從本站用戶端頁面前往 macOS 下載選項，依 arm64 或 x64 選擇對應檔案。優先使用符合處理器架構的版本，避免初次安裝時還要排查轉譯環境問題。

  3. 解壓縮安裝檔

    請先完整解壓縮壓縮檔；若提供的是磁碟映像檔，請先掛載映像檔。找到 App 後將它移至「應用程式」，不要只單獨取出 App 內的某個執行檔。

  4. 首次啟動

    在「Finder」→「應用程式」中開啟 v2rayN。若出現安全性提示，先看清楚完整內容，再依照下一節處理；不要反覆下載同一個檔案來取代權限確認。

更新前先結束正在執行的舊版本，再替換 App。請保留現有設定的備份，首次升級時不要同時變更訂閱、路由和核心設定。如此一來若發生異常，就能分辨問題是來自 App 更新還是設定變更。

二、如何允許開啟「無法驗證開發者」的 App

Gatekeeper 會在 App 啟動前檢查來源與簽署狀態。「無法驗證開發者」或「無法檢查是否包含惡意軟體」是啟動檢查提示，不代表節點連線失敗，也不是系統代理權限不足。確認檔案來源可信，且安裝檔符合所選平台後，再考慮只為這個 App 個別允許開啟。

  1. 先在「應用程式」中嘗試開啟一次 v2rayN，讓系統記錄這次遭封鎖的事件。
  2. 前往蘋果選單 →「系統設定」→「隱私權與安全性」，向下找到「安全性」區段。
  3. 如果該區段顯示 v2rayN 最近遭到封鎖，請確認 App 名稱，再按「仍要打開」。按鈕可能只會在遭封鎖後的一段時間內出現。
  4. 依系統要求輸入帳號密碼或使用 Touch ID 確認；接著若出現第二個提示，再選擇「打開」。
  5. 返回 App，確認主畫面是否出現。成功開啟後再匯入設定；不要把安全性設定頁面當成網路設定頁面。

不同 macOS 版本的提示文字可能不同。部分較舊版本可在「Finder」中按住 Control 鍵並點按 App，再選擇「打開」進入確認流程；較新的系統仍可能要求前往「隱私權與安全性」核准。請依目前系統提供的操作方式為準。

三、先匯入訂閱，再確認本機監聽

開啟主畫面只代表 App 通過啟動檢查。實際轉送流量的是核心，訂閱則提供伺服器設定。先在「訂閱群組」→「訂閱群組設定」新增群組與訂閱網址並儲存，再回到「訂閱群組」執行更新；選單中含有「更新全部訂閱」的項目可用來取得各群組內容。不同版本可能會區分是否透過代理更新；初次尚未連線時，先選擇不透過代理的更新方式。

清單出現設定後，選取其中一筆並設為作用中的伺服器，再檢查記錄是否顯示核心啟動成功。VMess、VLESS 是通訊協定類型，不是系統權限名稱；訂閱中原有的傳輸方式、TLS、伺服器名稱等參數都應維持原樣。只為了讓 App 通過 macOS 授權，不需要把 VLESS 改成 VMess，也不要任意關閉 TLS。

2 種
常見架構選項：arm64 與 x64
10808
本文示範的本機代理連接埠，並非固定值

下方指令以本機位址 127.0.0.1、連接埠 10808 為例。實際值請到「設定」→「參數設定」查看本機監聽連接埠，並與啟動記錄核對。若目前版本提供混合連接埠，同一個監聽端點可接收 HTTP 與 SOCKS；若介面分別列出兩種連接埠，則必須依各自用途填寫，不能直接照抄同一個數字。

四、核准系統代理權限與檢查網路設定

日常瀏覽可先使用系統代理模式。在 v2rayN 主畫面找到「系統代理」，選擇「自動設定系統代理」。如果 macOS 跳出修改網路設定或安裝輔助工具的確認視窗，請先核對發起 App、操作說明與來源，再視需要核准。只為了開啟主畫面，不應長期以管理員身分執行整個用戶端。

用戶端檢查項目

系統代理
自動設定系統代理
作用中的設定
已設為作用中伺服器的項目
本機位址
127.0.0.1
範例連接埠
10808，請以實際監聽值為準

先確認核心已啟動，再設定系統代理；兩項狀態要分別檢查。

macOS 檢查項目

設定路徑
系統設定 → 網路
目前使用的服務
目前用來連線的 Wi-Fi 或乙太網路
詳細設定頁面
詳細資訊 → 代理伺服器
核對項目
已啟用代理的位址與連接埠

切換網路服務後請重新檢查，不要只看另一個未使用介面的代理值。

在 macOS 的「代理伺服器」頁面檢查實際寫入的設定。網頁代理伺服器對應 HTTP；安全網頁代理伺服器則是 HTTPS 要使用的代理入口；後者名稱中的「安全」不代表本機代理監聽本身一定使用 TLS。只核對由用戶端管理的項目，不要為了把所有選項都勾起來，而同時啟用自動代理探索、自動代理設定和多個手動代理。

系統代理是提供給 App 讀取的系統設定，不代表所有流量都會由它接管。部分命令列程式、內建獨立代理設定的瀏覽器，以及自行建立連線的 App，可能不會讀取這項設定。若瀏覽器能開啟網頁，但某個終端機指令仍失敗，請先確認該程式的代理使用方式，不要立刻認定是授權失效。

五、TUN、網路擴充功能與一般代理的差異

TUN 會透過虛擬網路介面處理流量，牽涉介面、路由與 DNS，通常比一般本機代理需要更多權限。首次安裝不必一定啟用 TUN。先用系統代理確認設定可用，再依 App 覆蓋需求決定是否啟用，可避免多個變數同時改變而造成誤判。

選擇方式：先確認一般代理可用，再評估 TUN

系統代理模式
  • 適合會讀取系統代理設定的瀏覽器與桌面 App。
  • 確認本機監聽、作用中的伺服器，以及網路服務中的代理值。
  • 啟用一般代理後，不一定會出現核准網路擴充功能的提示。
TUN 模式
  • 適用於需要透過虛擬介面接管流量，且目前版本支援的情境。
  • 依用戶端提示安裝或核准所需的輔助元件。
  • 啟用後，另外檢查介面、路由、DNS，以及是否與其他隧道軟體衝突。

TUN 的實作方式取決於用戶端版本與元件；虛擬介面、輔助服務和網路擴充功能並非同一回事。

只有元件確實要求網路擴充功能權限時，才需要尋找相應的核准項目。以 macOS 15 的設定分類為例，可檢查「系統設定」→「一般」→「登入項目與擴充功能」→「網路擴充功能」；其他系統版本可能會在「隱私權與安全性」顯示允許提示。清單中沒有相關項目，不代表一般系統代理安裝失敗，也不應因此要求安裝不存在的擴充功能。

六、利用系統狀態與明確指定代理來排查問題

排查時，請分開確認「代理設定已寫入」和「要求已成功轉送」。先查看系統記錄，再檢查連接埠，最後明確指定本機代理執行指令。以下指令請在「終端機」執行；範例只會讀取狀態或發出一般網頁請求，不會修改系統安全政策。

# 查看系統目前的代理狀態
scutil --proxy

# 查看範例連接埠是否有 TCP 監聽
lsof -nP -iTCP:10808 -sTCP:LISTEN

# 明確指定 HTTP 代理；僅適用於該連接埠支援 HTTP 的情況
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com

# 明確指定 SOCKS，並由代理端解析目標網域
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 -I https://example.com

scutil --proxy 中的 HTTPEnable、HTTPProxy、HTTPPort 等欄位可用來確認實際系統狀態；若使用 SOCKS，則查看對應的 SOCKS 欄位。若 lsof 沒有輸出，請先確認連接埠是否填錯、核心是否已結束，而不是繼續重複核准權限。

觀察結果優先檢查下一步
本機連線遭拒監聽連接埠、核心程序確認連接埠與啟動記錄，先恢復監聽。
明確指定代理後成功，瀏覽器卻失敗系統代理、瀏覽器獨立設定確認目前網路服務的代理設定，檢查瀏覽器是否自行覆寫。
本機監聽正常，但要求逾時節點、DNS、路由與上游連線搭配用戶端記錄，測試另一筆已知可用的設定。
只有 TUN 模式失敗輔助服務、介面、DNS 與路由衝突關閉 TUN，切回系統代理，確認基本連線仍可使用。

收到目標網站的 HTTP 回應，只能證明這次要求有收到回應，不能據此認定所有網域都經過代理；路由規則仍可能讓部分要求直接連線。測試時請搭配核心記錄判斷使用的出口，不要混淆「全域系統代理」與「所有目標都使用代理出口」。

七、安裝與權限常見問題

找不到「仍要打開」怎麼辦？

先從「應用程式」再次開啟一次，接著前往「系統設定」→「隱私權與安全性」檢查最新的封鎖記錄。如果提示其實是系統版本不相容、App 已損壞或惡意軟體警告，請依實際原因處理；受管理的裝置則先聯絡管理員，不要嘗試繞過政策。

已允許 App 啟動，為什麼還要輸入密碼？

允許 App 啟動和修改網路設定是兩項不同操作。請確認彈出視窗是否由剛執行的系統代理或輔助服務操作觸發，核對名稱與用途後再核准。若每次操作都反覆出現，先檢查安裝位置、舊程序與輔助元件狀態，不要連續盲目按下確認。

關閉 v2rayN 後，瀏覽器反而無法上網？

重新開啟用戶端，在「系統代理」中執行「清除系統代理」後再結束程式；若 App 無法開啟，請前往「系統設定」→「網路」→目前使用的網路服務→「詳細資訊」→「代理伺服器」，移除殘留的本機代理設定。原有的公司代理或自動設定網址應保留，避免一併誤刪。

每次更新後要重新檢查哪些項目？

先確認替換的 App 架構相同，啟動後檢查作用中的設定、監聽連接埠和系統代理狀態。只有系統再次封鎖啟動或要求權限時，才處理相應提示。更新主程式不代表必須重建訂閱，也不表示要重新開啟所有網路權限。

設定完成後，請依序確認：App 能開啟、訂閱能載入、核心正在監聽、系統代理指向正確連接埠，且目標要求有收到回應。確有需求時再啟用 TUN，並另外驗證新增的權限與網路變更。按照這個順序檢查，安裝、權限與節點問題就能各自對應到明確的檢查步驟。

下載v2rayN