依序完成「確認架構 → 確認應用程式來源 → 處理首次開啟 → 驗證系統代理 → 視需要啟用 TUN → 設定登入項目」。適合已取得訂閱,但卡在 macOS 安裝或權限設定的使用者。先確認一般代理可正常連線,再設定 TUN 與自動啟動,避免同時變更多項設定而難以找出問題。
確認處理器架構與應用程式位置
從蘋果選單開啟「關於這台 Mac」。顯示 Apple 晶片的裝置請選 ARM64 套件;顯示 Intel 處理器的裝置請選 x64 套件。v2rayN 的 macOS 套件不能與 Windows 套件混用;介面能否啟動,也不代表隨附核心的架構一定正確。最低系統版本請以所選發布套件的說明為準。
-
確認架構
開啟蘋果選單 →「關於這台 Mac」,查看「晶片」或「處理器」。也可以在「終端機」執行
uname -m;原生環境通常會分別回傳arm64或x86_64。以轉譯模式執行的終端機可能影響結果,建議優先查看系統資訊。 -
選擇安裝套件
前往本站下載頁,選擇對應架構的 macOS 版 v2rayN。保留原始下載檔案並完整解壓縮;若下載的是磁碟映像檔,請開啟後將應用程式複製到「應用程式」資料夾。
-
固定應用程式位置
首次啟動前,先將應用程式放在固定的資料夾。不要長期從已掛載的磁碟映像檔執行,也不要只將應用程式套件內的單一執行檔拖出來。
-
首次啟動
在 Finder 的「應用程式」資料夾中開啟 v2rayN,並記下警示視窗的完整內容。先判斷是開發者驗證提示、應用程式損壞警告,還是核心執行錯誤,再進行後續處理。
本文使用「系統設定」中的選單名稱;較舊版本的系統可能顯示「系統偏好設定」。v2rayN 各版本的設定分類也可能不同;涉及連接埠與 TUN 參數時,請以目前安裝版本顯示的欄位為準,不要照抄其他平台的桌面版路徑。
處理「無法驗證開發者」與首次開啟遭封鎖
Gatekeeper 檢查的是應用程式的散布信任狀態。出現「無法驗證開發者」不代表節點連線失敗,也無法透過修改訂閱解決。確認下載來源與檔案相符後,才應個別允許該應用程式開啟。
-
查看警示內容
首次開啟遭封鎖時,先關閉警示視窗。確認警示指向剛下載的 v2rayN,而不是同名的舊副本或不明輔助程式。
-
前往安全性設定
開啟蘋果選單 →「系統設定」→「隱私權與安全性」,向下找到「安全性」。剛才遭封鎖的應用程式通常會在此顯示相關說明。
-
個別允許開啟
確認系統允許且應用程式來源可信後,按一下應用程式旁的「仍要打開」,依系統提示完成管理員驗證,再確認開啟。按鈕文字可能因系統版本而略有不同。
-
重新開啟
回到「應用程式」資料夾,啟動同一個副本。若沒有出現允許開啟的選項,請再次嘗試開啟後重新檢查;受管理的裝置也應確認是否受到組織安全政策限制。
不要為了安裝用戶端而關閉整台電腦的 Gatekeeper,也不要批次清除整個「下載項目」資料夾的隔離屬性。多次允許開啟仍然失敗時,請退出應用程式、移除異常副本,再重新下載符合架構的完整發布套件。這比疊加不明終端機指令更容易找出問題。
先驗證系統代理,再決定是否啟用 TUN
v2rayN 介面、代理核心與系統網路設定是三個不同層次。介面能開啟,只代表應用程式可以執行;核心成功監聽本機連接埠後,才有可用的代理入口;系統代理設定正確後,遵循該設定的程式才會使用這個入口。
依應用程式需求選擇連線方式
先使用系統代理
- 適用於瀏覽器及遵循系統代理設定的應用程式。
- 先確認節點、核心與本機監聽都正常。
- 一般瀏覽網頁不必同時啟用 TUN。
視需要使用 TUN
- 適用於不遵循系統代理設定的應用程式流量。
- 需要檢查虛擬介面、路由與 DNS。
- 先處理額外權限,再檢查流量接管結果。
系統代理是應用程式層的入口;TUN 則是在網路層接管流量。兩者都無法取代正確的伺服器設定與路由規則。
匯入訂閱並選擇伺服器後,先保持 TUN 關閉,在 v2rayN 的「系統代理」選單中選擇「自動設定系統代理」。此處的「自動設定」不代表一定使用 PAC,實際結果請以系統中設定的 HTTP、HTTPS 或 SOCKS 代理項目為準。
- 開啟「系統設定」→「網路」→目前使用的 Wi-Fi 或乙太網路→「詳細資訊」→「代理伺服器」。
- 確認已啟用代理項目的伺服器位址與連接埠。使用本機代理時,位址通常是
127.0.0.1,連接埠必須與 v2rayN 目前的監聽值一致。 - 若用戶端要求修改網路設定的權限,請確認要求來源後完成驗證。取消授權、切換網路服務或遭其他代理程式覆寫,都可能導致設定未生效。
- 不要為了解決對外連線問題而任意關閉 macOS 防火牆;控制連入連線與設定本機對外代理是兩回事。
用連接埠與指令判斷權限問題
以下以本機 HTTP 代理連接埠 10808 作為示範值,不代表所有版本的預設連接埠。請先在 v2rayN「設定」→「參數設定」中確認本機監聽連接埠與通訊協定;若目前版本的選單位置不同,請查看對應的本機入站設定。
scutil --proxy
lsof -nP -iTCP:10808 -sTCP:LISTEN
curl -I --connect-timeout 15 --max-time 30 --proxy http://127.0.0.1:10808 https://example.com/
scutil --proxy 可用來查看目前的代理設定;lsof 可用來檢查本機 TCP 監聽狀態。若查不到監聽結果,請先查看核心記錄是否有啟動失敗、架構不相容或位址遭占用等情況,不要繼續反覆調整系統代理權限。有監聽也不代表該連接埠接受 HTTP,還必須確認入站通訊協定。
明確指定代理的要求成功
- 指令結果
- 已收到目標網站的 HTTP 回應標頭
- 瀏覽器連線異常
- 優先檢查系統代理與瀏覽器本身的設定
- 系統設定依據
- 確認 scutil --proxy 顯示的位址與連接埠
收到回應只代表這次要求可連線,不代表所有網域或路由都正常。
明確指定代理的要求失敗
- 連線遭拒
- 檢查連接埠、監聽狀態與入站通訊協定
- 交握逾時
- 檢查伺服器位址、網路與對外連線記錄
- 憑證錯誤
- 檢查時間、伺服器網域名稱與 TLS 設定
明確指定代理的 curl 不依賴系統代理開關,適合用來排除應用程式層的設定問題。
若本機連接埠只提供 SOCKS,測試時請改用 --proxy socks5h://127.0.0.1:10808,並換成實際的 SOCKS 連接埠。此處的 socks5h 代表將目標網域名稱交由代理端解析,不能直接與本機的解析結果混為一談。
視需要授予 TUN 權限與網路存取權限
一般代理測試成功後,再試用用戶端的「啟用 TUN」選項。建立虛擬網路介面、調整路由或啟用相關輔助服務可能需要管理員權限;具體實作會因 v2rayN 版本與使用的 TUN 元件而異,不應預期每次都會出現相同的系統提示。
- 先查看啟動記錄:記下啟用 TUN 時出現的第一則錯誤。權限不足、介面建立失敗與 DNS 逾時應分開處理。
- 確認驗證要求:若系統要求管理員驗證,請核對操作時間與發起程式。不要在系統授權視窗中輸入訂閱密碼或伺服器憑證。
- 依提示尋找設定位置:只有實際出現 VPN 設定或網路延伸功能要求時,才查看「系統設定」→「網路」→「VPN 與過濾器」等對應位置;部分新版系統也會在「一般」→「登入項目與延伸功能」管理延伸功能。
- 分辨區域網路權限:macOS 15 及更新版本的「隱私權與安全性」→「區域網路」用來控制區域網路存取,並非所有網際網路存取的總開關。若清單中沒有該應用程式,也不能據此判定 TUN 權限失敗。
- 排除重複接管:暫時停用其他會修改預設路由、DNS 或系統代理的工具,再單獨測試 v2rayN。測試時不要同時執行多個 TUN 流量接管方案。
設定登入項目並確認退出後的復原情況
開機啟動、背景執行與 TUN 授權是彼此獨立的事項。將 v2rayN 加入登入項目,只代表使用者登入後會嘗試啟動應用程式,不保證自動選擇伺服器、設定系統代理或建立 TUN;這些行為還會受到用戶端啟動選項與系統權限影響。
-
加入登入項目
開啟「系統設定」→「一般」→「登入項目」;部分版本會顯示「登入項目與延伸功能」。在「登入時打開」區段中,加入位於「應用程式」資料夾的 v2rayN。
-
避免重複啟動
若已使用用戶端提供的開機啟動選項,請先確認系統清單中是否已有記錄。只保留一種明確的啟動方式,避免新舊路徑同時存在。
-
檢查背景項目
只有目前版本確實安裝了相關輔助項目時,才核對「允許在背景」清單中的名稱與來源。沒有對應項目不代表應用程式安裝不完整。
-
測試退出後的狀態
從選單中退出應用程式,不要只關閉視窗。確認系統代理是否已還原;若網頁因此無法連線,請前往「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」,清除殘留的本機代理設定。
最後登出並重新登入一次,確認啟動的是位於固定位置的應用程式、核心能正常監聽,且系統代理或 TUN 運作符合預期。若電腦從睡眠喚醒後失效,請依序重新檢查監聽狀態、代理設定與 DNS;不要只把重新開機當成唯一的解決方式。
常見提示與處理方式
沒有出現「仍要打開」按鈕,該怎麼辦?
先從「應用程式」資料夾再次嘗試開啟,再前往「隱私權與安全性」查看相關封鎖記錄。若是公司或機構管理的 Mac,請確認裝置政策是否禁止例外放行;若提示內容是惡意軟體警告,不要依照一般開發者驗證流程繼續操作。
應用程式已開啟,為什麼一直出現核心錯誤?
先確認下載套件的架構與完整性,再查看記錄中的核心名稱、執行路徑與第一則錯誤。允許主介面開啟不一定也會允許獨立的核心執行檔;若系統再次封鎖子程式,請確認它確實來自同一個發布套件,不要盲目允許不明程式開啟。
瀏覽器可以連線,終端機指令卻連不上?
不少命令列工具不會自動使用 macOS 系統代理。請先使用本文提供的 curl 明確指定代理指令進行測試,再依工具文件設定代理環境變數。不要只因終端機要求失敗,就反覆申請系統網路權限。
更新後再次出現驗證提示,舊的登入項目還能用嗎?
新版本可能會再次觸發安全性檢查,請重新確認來源並依個別應用程式的流程處理。若已更換應用程式資料夾或名稱,請在「登入項目」中移除舊路徑並加入新位置,再重新檢查連接埠與啟動選項;不要同時執行兩個副本。
排除問題時只需記錄 macOS 版本、v2rayN 版本、處理器架構、錯誤時間,以及已去除敏感資訊的錯誤訊息。分享記錄前,請刪除訂閱網址、伺服器憑證與可識別網路的資訊。若想了解訂閱匯入或路由概念,可繼續參閱本站的快速入門與進階手冊。