適合初次安裝 v2rayN,或升級後遇到啟動遭封鎖、代理未生效的 macOS 使用者。先確認 App 來源與處理器架構,再依系統提示允許個別 App 開啟;進入主畫面後,分別測試系統代理、區域網路與 TUN,勿將三種權限混在一起排查。
辨識 Gatekeeper 提示與安裝包架構
程式碼簽署用來確認簽署者身分,以及簽署後程式碼是否完整;公證則是 Apple 對提交的軟體進行自動化安全檢查的流程。Gatekeeper 會依系統政策評估下載的 App。若出現「無法驗證開發者」或「無法確認是否含有惡意軟體」的提示,不能只憑警告視窗判斷安裝包是否安全,也不應把所有啟動失敗都歸因於未經公證。
- 架構:開啟 Apple 選單 →「關於這台 Mac」。若顯示 Apple 晶片,請選 ARM64;若顯示 Intel 處理器,請選 x64。架構不符與簽章驗證是兩回事;調整安全性設定,無法讓架構錯誤的程式原生執行。
- 來源:確認下載管道、發布版本與檔名。來路不明的鏡像站、聊天附件或重新打包的檔案,不應只因名稱與圖示相同就直接開啟。
- 警告類型:若系統明確指出含有惡意軟體,或提示 App 已損毀,請停止開啟,重新確認來源並重新下載安裝包。若受組織管理的 Mac 限制 App 執行,請洽管理員確認組織政策。
在「隱私權與安全性」中允許個別 App 開啟
以下步驟適用於使用「系統設定」的 macOS 版本。僅在確認來源可信,且系統提供個別 App 例外選項時操作;無須關閉 Gatekeeper,也不必變更系統層級的安全政策。
移至「應用程式」
若安裝包是磁碟映像檔,開啟後依視窗指示將 v2rayN 拖移至「應用程式」;若是壓縮檔,請先解壓縮,再將其中的 App 移至「應用程式」。之後從 Finder 的「應用程式」啟動,避免誤開下載資料夾中的舊版本。
觸發啟動檢查
連按兩下剛安裝的 v2rayN。若出現無法驗證的警告視窗,先關閉視窗並記下 App 名稱。若未出現警告且能開啟主畫面,可略過本節後續步驟。
尋找安全性提示
開啟 Apple 選單 →「系統設定」→「隱私權與安全性」,向下找到「安全性」。確認最近遭封鎖的 App 是否為 v2rayN,再點選「仍要打開」。通常在嘗試啟動後約一小時內,這個選項才會顯示。
確認開啟
依系統對話框指示驗證身分並確認開啟。這項例外僅適用於選定的 App,不代表已授予網路權限。更新或替換 App 後若再次出現提示,請先重新確認新安裝包的來源與版本。
分別測試系統代理與 TUN
能開啟主畫面,只代表 App 已啟動,不代表核心正在正常監聽,也不代表瀏覽器流量已進入代理。首次測試時只啟用一種連線方式;若兩種同時開啟,即使瀏覽器恢復連線,也無法判斷是哪項設定生效。
兩種連線方式的檢查步驟
系統代理:先測試瀏覽器
- 關閉 TUN,選擇節點,然後在 v2rayN 的「系統代理」選單中選擇「自動設定系統代理」。若系統因這次變更顯示驗證視窗,請確認要求與剛才的操作相符,再依提示完成驗證。
- 前往「系統設定」→「網路」→目前使用的服務(例如「Wi-Fi」)→「詳細資訊」→「代理」,查看已啟用的項目。確認位址與連接埠是否對應 v2rayN 的本機監聽設定;切換至有線網路後,請重新確認目前使用的服務。
TUN:接著測試虛擬網卡
- 先清除系統代理,再啟用 v2rayN 的 TUN 模式。請依實際提示區分管理員驗證、加入 VPN 設定檔及允許網路延伸功能;這些不是同一項權限,而且並非所有實作都會要求網路延伸功能。
- 在 macOS 15 中,若明確提示網路延伸功能已停用,可前往「系統設定」→「一般」→「登入項目與延伸功能」→「網路延伸功能」,開啟詳細資訊並啟用對應項目。若實際提示要加入 VPN 設定檔,請在系統確認視窗中核對名稱,再前往「系統設定」→「VPN」檢查狀態。
代理頁面顯示的連接埠與用戶端監聽連接埠相同,只能證明設定指向同一個入口;節點是否連線成功,仍須查看核心記錄與實際請求。
修改系統代理不一定會跳出授權視窗,也沒有適用於所有版本的常駐權限開關。若代理頁面沒有變化,先確認用戶端選擇的不是「不變更系統代理」,再查看用戶端記錄是否有權限錯誤。若代理由其他軟體或管理政策控管,請先記錄原設定,避免直接覆寫。
依存取對象判斷是否需要區域網路權限
macOS 15 的「區域網路」權限用來控管 App 是否能存取區域網路裝置。瀏覽器連線至本機迴路位址 127.0.0.1,與 v2rayN 或其核心連線至另一台區域網路主機,是兩種不同的連線。使用公網節點並讓瀏覽器連到迴路連接埠時,不要只因網頁無法開啟就啟用區域網路權限。
公網節點與迴路監聽
建議讓代理維持在本機監聽,使用遵循系統代理設定的瀏覽器測試連線。若填入範例連接埠 10808,但記錄顯示實際監聽的是其他連接埠,請修正用戶端或代理設定。
適用情境:初次安裝、僅代理本機 App
連線至區域網路節點
若節點確實部署在同一個區域網路,例如位址為 192.168.1.20,請前往「系統設定」→「隱私權與安全性」→「區域網路」,檢查對應 App 的開關。若清單中尚未出現該項目,請先實際連線並留意系統是否顯示存取要求。以系統顯示的要求來源為準,不要一次允許不明項目。
適用情境:節點或目標服務確實位於區域網路
授權後仍無法連線的排查順序
- 檢查本機監聽。在終端機執行
lsof -nP -iTCP:10808 -sTCP:LISTEN,並將連接埠替換為用戶端目前使用的值。若有結果,請確認處理程序名稱;若沒有,請查看 v2rayN 記錄,確認核心是否啟動、連接埠是否繫結失敗。監聽成功不代表遠端交握成功。 - 檢查節點交握。選定節點後發出請求,對照當時的核心記錄。連線逾時時先檢查節點位址與連接埠;交握錯誤則重新確認伺服器要求的傳輸方式與安全層設定。勿只憑節點名稱判斷設定,也不要關閉憑證驗證來掩蓋錯誤。
- 檢查 App 與路由。若瀏覽器正常但特定 App 連線失敗,先確認該 App 是否會讀取系統代理。若只有 TUN 模式失敗,先關閉其他 VPN,再檢查路由與 DNS 是否衝突;若只有區域網路服務無法連線,則確認分流規則、區域網路權限及目標裝置是否在線。
- 還原原本的網路設定。排查完成後,先關閉 TUN,再透過 v2rayN 清除系統代理。返回目前網路服務的「代理」頁面確認;使用組織代理或手動代理的裝置,應還原先前記錄的設定,而非一律關閉所有項目。