第一次在 Mac 安裝 v2rayN,先依晶片選擇安裝包,再依系統提示決定是否個別允許開啟。主視窗開啟後,先確認系統代理,再視需要測試 TUN。如此可分辨應用程式啟動、代理核心與系統網路設定這三個環節的問題。
Apple 晶片與 Intel:依架構選擇安裝包
開啟 Apple 選單「」→「關於這台 Mac」。若看到「晶片」及 Apple M 系列名稱,請選 ARM64;若看到「處理器」及 Intel 名稱,請選 x64。兩種架構都要確認目前版本標示的最低 macOS 版本;晶片符合不代表系統版本也符合需求。
ARM64 原生版
推薦Apple 晶片 Mac 優先使用標示為 ARM64 或 arm64 的 macOS 安裝包。首次開啟時若意外出現安裝 Rosetta 的提示,請先確認下載項目及所用核心的架構。
適用:Apple 晶片 Mac
x64 原生版
Intel Mac 請選擇 x64 或 x86_64 安裝包。ARM64 安裝包無法在 Intel Mac 上執行;調整隱私權限也無法解決架構不相容的問題。
適用:Intel 處理器 Mac
若下載的是磁碟映像檔,請開啟映像檔,將 v2rayN 應用程式拖曳至「應用程式」,退出映像檔後再從「應用程式」啟動。若下載的是壓縮檔,請先完整解壓縮,再依該版本說明移動應用程式;不要直接從壓縮檔預覽畫面執行,也不要只移動其中的核心檔案。
Gatekeeper 提示:「仍要打開」在哪裡?
「無法驗證開發者」是啟動時的系統檢查,與訂閱、節點及網路權限無關。只有在確認軟體來源可信、檔案確實是預期的版本,且裝置管理政策允許時,才為該應用程式個別設定例外。若系統提示應用程式會損害電腦或偵測到惡意軟體,請停止執行並重新確認來源,不要將這類警告當成一般的開發者驗證提示。
從「應用程式」啟動
在 Finder 中開啟「應用程式」,連按兩下 v2rayN。記下彈出視窗中的應用程式名稱和提示原文,再關閉提示。請先核對名稱,避免誤允許同一時間遭系統封鎖的其他程式。
開啟安全性設定
macOS 13 或以上版本,請開啟「」→「系統設定」→「隱私權與安全性」,向下捲動至「安全性」。建議在應用程式遭封鎖後立即查看;此選項只會針對近期的啟動嘗試顯示,不會一直出現。
確認並個別允許開啟
確認「安全性」區塊顯示的是 v2rayN,再點選「仍要打開」。依系統提示完成身分驗證,並在確認視窗中選擇打開。若受管理的裝置沒有此選項,請聯絡管理員,不要變更全域安全性政策。
確認啟動結果
主視窗出現後,再處理訂閱和代理設定。若主視窗能開啟,但記錄顯示核心啟動失敗,問題就不在應用程式啟動權限。請依錯誤訊息確認核心架構、檔案是否完整,以及監聽連接埠是否已被占用。
系統代理:先確認本機監聽,再檢查網路服務
先關閉 TUN,選取一個已知可用的節點。透過 v2rayN 的「設定」→「參數設定」查看本機監聽設定,再於主畫面的「系統代理」選取「自動設定系統代理」(不同版本的按鈕位置可能不同)。以下數值僅供確認位址和連接埠時參考,不代表所有版本的預設值。
- 檢查目前的網路連線。在「系統設定」→「網路」中選取目前使用的連線。以無線連線為例,進入「Wi-Fi」→ 已連線網路旁的「詳細資訊」→「代理伺服器」。有線連線則需檢查對應的乙太網路服務。切換連線後,原服務的代理設定不代表新服務也已完成設定。
- 確認代理類型相符。查看已啟用的網頁代理或 SOCKS 代理所填的位址和連接埠,並依實際監聽的協定核對。不要將僅支援 SOCKS 的連接埠填入 HTTP 代理;若版本採用混合監聽,則以該監聽實際支援的協定為準。
- 確認瀏覽器請求。使用會遵循系統代理設定的瀏覽器開啟已知可連線的網頁,同時查看 v2rayN 記錄是否收到新請求。若有請求但連線失敗,優先檢查節點和路由;若完全沒有請求,先確認瀏覽器是否使用獨立代理設定,以及目前網路服務的代理設定是否生效。
啟用系統代理前,請記下原有的手動代理或自動設定位址。測試結束後,先在 v2rayN 清除用戶端寫入的系統代理,再結束程式,並確認原有設定已還原。否則瀏覽器可能會繼續連線到已停止監聽的本機連接埠。
TUN 與網路擴充功能:只授權目前功能需要的項目
系統代理適用於會遵循代理設定的應用程式。TUN 則透過虛擬介面和路由接管流量,適合測試不讀取系統代理設定的程式。TUN 不等於網路擴充功能:不同版本的實作可能需要管理員授權、使用特權輔助程式,或觸發系統的 VPN 設定及網路擴充功能提示。若沒有出現擴充功能提示,不代表少了安裝步驟。
- 先確認節點在系統代理模式下可以使用。測試 TUN 時,清除本次寫入的系統代理設定,保留必要的網路管理設定,再單獨啟用 TUN,避免混淆流量的傳輸路徑。
- 若系統要求新增 VPN 設定或允許網路擴充功能,請先確認提示中的應用程式名稱,以及是否符合你目前主動執行的操作。macOS 15 可在「系統設定」→「一般」→「登入項目與擴充功能」的「網路擴充功能」中檢查相關項目;只有在目前版本確實使用該擴充功能,且項目與提示相符時才啟用。若提示要求管理員確認,請使用具備權限的帳號在系統對話框中完成操作。
- 啟用後測試網頁和區域網路資源,再查看記錄中的介面建立、DNS 或路由錯誤。若無法連線公司資源,請先關閉 TUN 並確認原有連線已恢復,再檢查是否與現有 VPN、網段路由或企業政策衝突。一次只調整一項,避免把修正路由和更換節點混在同一次測試中。
首次啟動與無法連線排查
為什麼看不到「仍要打開」?
從「應用程式」再次嘗試啟動 v2rayN,關閉封鎖提示後,立即回到「隱私權與安全性」頁面底部。若提示是架構不相容或系統版本過舊,請依安裝包需求重新選擇版本;若受到裝置管理政策限制,請交由管理員處理。
訂閱更新成功,為什麼網頁還是打不開?
訂閱更新成功只代表訂閱網址可連線並取得設定,不代表所選節點可用。選取目標節點,確認核心記錄中的監聽狀態,再到目前網路服務的「代理伺服器」頁面比對連接埠。若記錄有請求但交握失敗,請檢查節點設定,無須重新授權應用程式。
結束 v2rayN 後,瀏覽器為什麼無法連線?
檢查目前網路服務是否仍將網頁請求導向回送位址。若殘留的是本次測試寫入的代理設定,可重新啟動 v2rayN,先清除系統代理再結束程式;或在網路設定中還原事先記下的值。若剛才使用過 TUN,也請確認已將它關閉。