適合首次在 Mac 安裝 v2rayN,或系統升級後發現代理失效的使用者。先根據提示判斷問題出在應用程式啟動、本機監聽,還是系統代理設定,再依情況逐項檢查。只有確認來源可信,且系統提供例外選項時,才考慮個別允許該應用程式。
先分辨啟動遭封鎖與代理故障
Gatekeeper 會檢查從網際網路下載的應用程式,並以簽章與公證作為判斷依據。「無法驗證開發者」表示系統未能依預設政策驗證目前的應用程式副本,不代表網路權限遭拒,也不能證明檔案安全。若安裝包來源不明、系統明確指出含有惡意軟體,或出現「已損壞」提示,請勿把一般的開發者驗證例外當成解決方式。
從提示出現的位置開始檢查
建議按兩下後沒有主視窗,先處理啟動提示;看得到主視窗,但啟用代理後才無法上網,先查看核心記錄與目前網路服務的代理設定。先記下原始提示,每次只調整一項設定。
適用情況:首次安裝、升級後不確定問題原因
先測試直接連線
如果 v2rayN 能開啟,先記錄原本的代理設定,再清除這次測試寫入的代理設定,並用同一個瀏覽器重試原本可直接連線的網站。如果直接連線也失敗,請優先檢查 Wi-Fi、入口網站登入或現有網路政策,不要繼續調整節點參數。
適用情況:切換網路後,瀏覽器突然無法瀏覽網頁
結論:先確認主視窗是否出現
只要主視窗能開啟,就先保留目前的安全設定,改查核心記錄;應用程式獲准啟動,不代表隨附的核心也已成功執行。
在「隱私權與安全性」中個別允許開啟
確認安裝包
重新確認下載來源是否為可信的發布管道。在蘋果選單 →「關於這台 Mac」確認使用的是 Apple 晶片還是 Intel 處理器,並選擇標示為 arm64 或 x64 的對應版本。解壓縮後,在 Finder 確認後續都開啟同一份應用程式,避免同時測試下載資料夾與「應用程式」中的不同副本。
查看封鎖提示
按兩下應用程式並閱讀系統提示。如果只是無法驗證開發者,且來源可信,關閉提示後繼續下一步。如果系統提示應用程式會損害電腦,或無法確認來源,請停止開啟,並向發布者或裝置管理員確認。
開啟安全性設定
在 macOS 13 或以上版本,前往蘋果選單 →「系統設定」→「隱私權與安全性」,向下捲動至「安全性」。找到剛才遭封鎖的應用程式記錄;只有確認應用程式名稱與剛才開啟的副本相符,才按一下「仍要打開」。
確認這次授權
依照系統對話框確認,必要時使用具備權限的帳戶驗證。如果沒有看到按鈕,可再次嘗試開啟同一份應用程式,並立即返回設定頁面查看;如果裝置由學校或公司管理,請向管理員確認是否允許例外,不要關閉系統層級的保護。
檢查核心記錄
主視窗開啟後,選擇一筆現有設定並查看用戶端記錄,確認對應的核心能否啟動,以及本機監聽是否出錯。此時先不要啟用 TUN,也不要批次更新訂閱,避免將應用程式啟動、核心載入與遠端連線問題混在一起排查。
確認系統代理與本機網路權限
系統代理設定屬於網路服務。v2rayN 設定的位址與連接埠,是供遵循系統代理的應用程式使用,並非適用於所有程式的網路權限。使用 Wi-Fi 時,在用戶端底部的「系統代理」選單選擇「自動設定系統代理」;若介面版本不同,請以目前用戶端提供的系統代理選項為準。接著前往蘋果選單 →「系統設定」→「網路」→「Wi-Fi」→ 目前已連線網路的「詳細資訊」→「代理伺服器」確認設定。使用有線連線時,則檢查實際使用的乙太網路服務。
- 檢查監聽連接埠:在 v2rayN「設定」→「參數設定」確認本機監聽連接埠,再對照核心記錄。若連接埠實際為
10808,可在終端機執行lsof -nP -iTCP:10808 -sTCP:LISTEN查看監聽程序。若連接埠已被其他程序占用,先確認程序所屬,再結束已知的衝突程式或更換連接埠,並重新套用系統代理。 - 確認代理類型相符:系統中的「網頁代理伺服器(HTTP)」、「安全網頁代理伺服器(HTTPS)」與「SOCKS 代理伺服器」是不同項目。請依照用戶端實際設定的項目及對應的監聽類型操作,不要把 SOCKS 專用連接埠填入 HTTP 欄位。如果原本使用自動代理設定或公司網路代理,請先記錄原值,以免覆寫後無法還原。
- 只授予必要的存取權:macOS 15 起,存取區域網路裝置時,系統可能會要求本機網路權限。若確實需要存取區域網路位址,可前往「系統設定」→「隱私權與安全性」→「本機網路」,確認是否有與操作相符的應用程式項目。若只透過
127.0.0.1使用本機代理,通常不需要因此開啟區域網路存取權。
系統升級後恢復代理設定
- 確認目前執行的是哪一份應用程式。從「應用程式」資料夾啟動預計繼續使用的副本。若升級後更換了應用程式套件,並再次收到驗證提示,請視為新的啟動檢查,重新確認來源。不要假設舊副本的例外設定會套用到新副本。
- 先讓核心恢復監聽。開啟用戶端記錄檢查啟動結果。遇到連接埠占用時,先排除監聽衝突;若記錄顯示核心檔案遺失或無法執行,請檢查是否已完整解壓縮,或是否混用了不同處理器架構的檔案。核心尚未開始監聽時,反覆啟用系統代理只會讓程式繼續連線到無法使用的連接埠。
- 重新套用至目前的網路。確認核心已就緒後,透過用戶端的「系統代理」選單清除這次寫入的舊設定,再自動設定代理。返回目前網路服務的「代理伺服器」頁面確認結果。如果系統要求驗證,只有在確認是自己發起操作,而且提示內容與目前操作相符時才確認。受管理的項目請交由管理員處理。
- 分別測試瀏覽器與其他應用程式。先用遵循系統代理的瀏覽器測試,再測試目標應用程式。如果瀏覽器已恢復正常,但目標應用程式仍無法使用,先檢查該應用程式是否使用自己的代理設定。如果瀏覽器也無法使用,請參照核心記錄,分辨本機連線遭拒與遠端連線逾時,避免反覆修改系統權限。
首次開啟與網路權限常見問題
為什麼找不到「仍要打開」?
先從 Finder 開啟預計使用的應用程式,記下提示原文,再查看「隱私權與安全性」頁面下方。如果提示是損壞或惡意軟體警告,或裝置政策不允許例外,這個選項就不適用。
為什麼結束 v2rayN 後,網頁也無法開啟?
檢查目前網路服務是否仍將要求送往已停止監聽的本機連接埠。可重新開啟用戶端,透過「系統代理」選單清除其設定;如果原本有公司代理或自動設定網址,請還原先前記錄的值,而不是關閉所有代理項目。
「本機網路」中沒有 v2rayN,需要手動加入嗎?
先確認目標是否為區域網路裝置。若無法連線至遠端伺服器,優先檢查遠端位址、連接埠與核心記錄;若確實需要存取區域網路,再重試該操作並確認系統是否提出權限要求。一般上網不必另外尋找授權。