首次安裝先選對處理器架構,再處理 Gatekeeper 阻擋;成功開啟主視窗後,先用本機代理測試節點,再設定系統代理,最後視需要啟用 TUN。本文分別說明允許啟動應用程式、修改系統代理與授權網路擴充功能的方式,適合遇到安裝阻擋、瀏覽器未走代理或 TUN 啟動失敗的 Mac 使用者。
選擇安裝包:Apple 晶片選 arm64,Intel 選 x64
v2rayN 是管理節點、訂閱和路由設定的桌面用戶端,實際處理連線的是它啟動的代理核心。安裝包架構不只影響主視窗能否開啟,也會影響隨附核心能否執行。因此,「介面出現了」不代表整個執行環境都正常。
依「關於這台 Mac」的處理器資訊選擇安裝包
Apple 晶片 Mac
- 開啟蘋果選單 →「關於這台 Mac」,查看「晶片」欄位。
- Apple M 系列優先選擇 macOS arm64 安裝包。
- 不要只因系統支援 Rosetta 就優先使用 x64 安裝包;核心與輔助元件也必須符合架構需求。
Intel Mac
- 「關於這台 Mac」通常會顯示 Intel 處理器資訊。
- 選擇 macOS x64 安裝包;x86_64 也是同一類架構標記。
- arm64 安裝包不能用來取代 Intel 電腦適用的安裝包。
架構與最低系統版本是兩項不同條件;選對安裝包後,仍須確認目前版本要求的 macOS 版本。
前往下載中心的 macOS 下載頁面。若下載的是磁碟映像檔,請將應用程式拖曳至「應用程式」資料夾;若下載的是壓縮檔,請先完整解壓縮,再依發行說明放置應用程式。不要直接在壓縮檔預覽視窗中執行,也不要只複製主程式而漏掉同一資料夾中的相依檔案。更新前請先結束舊版程序,並備份訂閱、路由和必要設定。
無法驗證開發者:僅允許執行來源可信的應用程式
「無法驗證開發者」或「Apple 無法檢查其是否包含惡意軟體」通常是 Gatekeeper 的啟動檢查,並非節點故障。不要反覆匯入訂閱來處理這類問題,也不必關閉整台 Mac 的安全檢查。請先確認下載來源、檔案是否已完整解壓縮,以及系統提示中顯示的應用程式名稱。
-
確認應用程式位置
在 Finder 中開啟「應用程式」資料夾,確認要開啟的是剛安裝的 v2rayN,而非下載資料夾中的舊副本,或仍掛載於磁碟映像檔中的副本。
-
觸發啟動檢查
連按兩下應用程式,閱讀並關閉阻擋提示。記下提示的完整文字,以便分辨開發者驗證失敗、架構不相容與檔案損毀。
-
前往安全性設定
開啟蘋果選單 →「系統設定」→「隱私權與安全性」,向下找到「安全性」區域,查看是否出現剛被阻擋的應用程式及「仍要打開」按鈕。
-
確認允許這次啟動
確認應用程式名稱後,點選「仍要打開」,依系統要求完成管理者認證,並在後續確認視窗中選擇打開。完成後返回應用程式,檢查主視窗與記錄。
macOS 15 及後續版本對未簽署或未公證軟體的開啟流程限制更嚴格,不能假設在 Finder 中按住右鍵選「打開」就能允許執行。請以「隱私權與安全性」中的審核入口為準;較舊版本的介面名稱可能不同。受組織管理的 Mac 也可能停用這項操作,此時請聯絡裝置管理者,不要嘗試繞過管理政策。
先測試本機連接埠,再讓瀏覽器使用系統代理
成功開啟 v2rayN 後,先匯入可信任的訂閱、更新伺服器清單並選擇節點,再查看記錄是否顯示核心已啟動。在主視窗「設定」→「參數設定」中確認本機監聽設定;欄位名稱以目前版本為準。確認監聽位址和連接埠後,才能明確排查系統代理問題。
這兩個數字僅供排查示範,不代表所有發行版本的預設值。執行命令前,請將連接埠換成參數設定中實際啟用的 HTTP 或混合監聽連接埠;若只有 SOCKS 監聽,就不能直接使用下方的 HTTP 代理寫法。在本機使用時,監聽位址建議維持 127.0.0.1,不要為了解決權限問題而任意開放給所有網路介面。
# 查看範例連接埠是否有 TCP 監聽
lsof -nP -iTCP:10808 -sTCP:LISTEN
# 明確指定 HTTP 代理,不依賴 macOS 系統代理設定
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com
example.com 只是連線測試目標,不能據此判斷所有網站或路由規則都正常。連線遭拒時,通常應先檢查本機監聽;若出現代理交握錯誤,請確認連接埠類型;若已連上本機代理卻逾時,則繼續檢查核心記錄、節點參數和實際出站情況。不要只因瀏覽器一直轉圈,就認定是缺少系統權限。
- 明確指定代理的命令成功、瀏覽器卻失敗:優先確認系統代理是否已寫入目前的網路服務,以及瀏覽器是否使用獨立的代理設定。
- 明確指定代理的命令也失敗:先檢查核心、節點與路由,不要繼續加上 TUN。
- 連接埠已被其他程序占用:先找出該程序,再決定要結束衝突程式或更換監聽連接埠;變更後也要同步更新系統代理。
系統代理與 TUN:依應用程式需求選擇流量接管方式
系統代理不是虛擬網卡,只會影響遵循這項設定的應用程式。TUN 則透過虛擬網路介面和路由接管流量,通常需要較高權限,也較容易與其他網路工具衝突。首次設定時,建議先建立較容易觀察的系統代理連線,再評估是否需要 TUN。
從系統代理開始
建議在 v2rayN 主視窗的「系統代理」選單中選擇設定系統代理;部分版本也能從選單列圖示進入。首次修改網路設定時,系統可能要求管理者認證;認證完成後,仍應檢查系統中的實際代理位址和連接埠。
適用情境:瀏覽器上網、初次安裝測試,以及希望縮小排查範圍的桌面使用情境。
視需要啟用 TUN
確認節點正常後,再使用用戶端提供的 TUN 開關,並依目前版本說明完成權限提升或輔助服務設定。TUN 接管流量後仍會套用路由規則,不代表每條連線都會經由代理出站。
適用情境:應用程式不遵循系統代理,或需要透過虛擬網卡接管更多流量。
查看系統代理的路徑:「系統設定」→「網路」→目前使用的 Wi-Fi 或乙太網路→「詳細資訊」→「代理」。確認網頁代理、安全網頁代理與 SOCKS 代理是否啟用,以及位址和連接埠是否與用戶端一致。手動修改前先記下原值,尤其不要誤刪公司或學校網路所需的自動代理設定。
# 查看目前的系統代理狀態
scutil --proxy
# 列出網路服務名稱,後續查詢請使用實際名稱
networksetup -listallnetworkservices
# 以下以名稱為 Wi-Fi 的服務為例
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"
這些查詢不會修改設定。切換 Wi-Fi、連接擴充基座的網路孔或變更網路位置後,目前使用的網路服務可能不同,請重新確認代理狀態。終端機中的命令列工具不一定會自動讀取 macOS 系統代理,因此上文使用明確指定代理的命令進行測試,避免將工具的行為誤判為用戶端故障。
網路權限:網路擴充功能授權與 TUN 權限提升是兩回事
「允許連線」並不是能一次解決所有問題的總開關。修改系統代理、建立 TUN 介面、存取區域網路、接受輸入連線,以及載入網路擴充功能,分別由不同機制管理。v2rayN 的實際作法會因發行版本和核心組合而異,不能只看到 TUN 就認定一定要安裝網路擴充功能。
| 提示或狀況 | 檢查位置 | 判斷重點 |
|---|---|---|
| 修改代理時要求認證 | 用戶端操作後出現的系統認證視窗 | 確認請求來自目前使用的應用程式;完成認證後檢查代理設定是否確實寫入。 |
| 建立 TUN 失敗或權限不足 | v2rayN 記錄及目前版本的輔助服務設定 | 查看是否有 permission denied、operation not permitted 等訊息;依發行說明設定權限。 |
| 確實出現網路擴充功能請求 | macOS 15 的「系統設定」→「一般」→「登入項目與擴充功能」→「網路擴充功能」 | 只核准與剛安裝元件相符的項目;其他系統版本可能會在「隱私權與安全性」中顯示核准入口。 |
| 無法存取區域網路裝置 | 在提供此選項的系統中,前往「隱私權與安全性」→「本機網路」 | 這項權限只控制區域網路存取,不等同於網際網路代理授權,也不能取代 TUN 權限提升。 |
| 詢問是否允許輸入連線 | 「系統設定」→「網路」→「防火牆」→「選項」 | 允許輸入連線與一般代理輸出不同;僅在本機使用時,不應因此擴大監聽範圍。 |
啟用 TUN 前,請先暫時結束其他會修改預設路由、DNS 或虛擬網卡的網路工具,每次只保留一條流量接管路徑。若通過系統認證後仍無法使用,請保存首次啟動時的完整錯誤內容,不要不斷重複輸入密碼。若裝置受組織政策限制,管理者授權與應用程式內設定都不能取代管理政策核准。
結束與升級:檢查代理殘留並遷移設定
結束應用程式後無法上網,常見原因是系統代理仍指向已停止的本機連接埠。正常結束前,請先在用戶端清除系統代理、關閉 TUN,再結束應用程式。若應用程式異常結束,請透過系統設定檢查目前網路服務的代理項目,並還原為啟用前記錄的狀態;使用自動代理的網路也要確認自動代理設定是否遭到變更。
- 主視窗無法開啟:記下系統阻擋提示的完整文字,重新確認架構、最低系統版本與 Gatekeeper 放行狀態。
- 主視窗正常、核心卻結束:檢查核心架構、執行權限、設定錯誤及連接埠衝突;先保留記錄,再決定是否重新解壓縮安裝包。
- 代理命令成功、應用程式卻失敗:確認應用程式是否遵循系統代理、是否設有自己的代理設定,再決定是否改用 TUN。
- 啟用 TUN 後無法解析網域:搭配 DNS 與路由記錄檢查解析路徑;不要將所有解析失敗都歸因於權限不足。
- 升級後行為改變:比較升級前後的監聽連接埠、所選核心與路由設定;未經檢查前,不要直接用舊檔案覆蓋整套新設定。
排查記錄至少應包含 macOS 版本、處理器架構、v2rayN 版本、所選核心、目前代理模式和錯誤發生時間。提交記錄前,請刪除訂閱網址、節點密碼、使用者識別資訊及其他敏感參數。這有助於分別處理安裝阻擋、核心啟動失敗與路由問題,避免一次修改多項設定後失去比較依據。