適合初次安裝 v2rayN,或換機後重新部署的 Mac 使用者。依序檢查安裝包架構、Gatekeeper 提示、本機監聽、系統代理與網路權限。先找出問題所在,再決定是否重新安裝、調整代理或變更權限。
安裝 v2rayN 並處理首次開啟提示
確認處理器架構
開啟 Apple 選單 →「關於這台 Mac」。顯示 Apple 晶片的 Mac 請選 arm64 版本;顯示 Intel 處理器的 Mac 請選 x64 版本。也請確認下載頁標示的系統需求。架構不符造成的啟動錯誤,無法靠調整網路權限解決。
移至「應用程式」
壓縮檔請先解壓縮,磁碟映像檔請先開啟,再將 v2rayN 拖曳至 Finder 的「應用程式」資料夾。確認複製完成後,從該資料夾開啟應用程式,不要從下載資料夾或磁碟映像檔啟動另一份副本。升級前請先結束正在執行的舊版,並備份必要設定。
確認系統提示內容
「無法驗證開發者」表示系統未能完成相應的信任驗證,與節點測試結果無關。記下提示視窗中的應用程式名稱,並確認它與剛移至「應用程式」的版本相同。如果來源不明,或系統提示應用程式會損害電腦,請勿開啟,改用來源明確的發布版本。
查看個別開啟選項
在 macOS 13 或更新版本中,開啟 Apple 選單 →「系統設定」→「隱私權與安全性」,向下找到「安全性」。嘗試開啟遭到封鎖後,系統可能會為該應用程式顯示「仍要打開」。確認發布來源、應用程式無誤,且裝置管理政策允許後,才使用此選項並依提示完成驗證,再確認開啟。此例外僅適用於該應用程式,不必變更整台 Mac 的安全政策。
從 macOS 15 開始,不能再依賴在 Finder 中按住 Control 點按 →「打開」來處理這類簽章或公證遭封鎖的情況。若沒有看到「仍要打開」,請先確認最近一次遭封鎖的是目前安裝的版本。受機構管理的 Mac 可能會限制此選項,請洽管理員確認政策,不要自行變更全域設定。
分辨 Gatekeeper、代理與網路權限
依提示判斷問題所在
建議主視窗沒有出現,先查看系統提示;主視窗已出現但核心結束執行,先查看 v2rayN 記錄;核心正在監聽但瀏覽器無法連線,再檢查代理位址與連接埠。每次只變更一項,並記下變更前的值。
適用情境:初次安裝、升級後故障、換機移轉
保留現有系統代理設定
辦公室網路已有代理或自動代理設定時,請先保留原設定。使用支援個別代理設定的測試應用程式,填入 v2rayN 實際監聽的位址,以單一應用程式區分核心故障與系統代理設定衝突。
適用情境:現有代理無法涵蓋,或只需測試單一應用程式
系統代理是應用程式可讀取的代理設定,不會接管所有流量。應用程式若使用自己的代理設定或直接連線,變更系統代理未必會改變其連線路徑。v2rayN 的路由規則則只會套用至已送進核心的請求;調整路由無法讓原本直接連線的應用程式自動改用本機監聽。
檢查監聽連接埠與 macOS 系統代理
先從 v2rayN 的「設定」→「參數設定」檢查本機監聽設定,再以核心啟動記錄和實際監聽狀態為準。不同版本的欄位名稱、監聽方式與連接埠可能不同。不要照著舊教學把兩個連接埠分別填入 SOCKS 和 HTTP;若版本使用混合入站,請依實際設定確認同一連接埠是否接受兩種協定。
檢查本機監聽
- 伺服器
- 僅供本機測試使用
127.0.0.1 - 連接埠
- 查看目前設定與啟動記錄
- 協定
- 確認是 HTTP、SOCKS 或混合入站
- 狀態
- 確認核心程序仍在執行
連接埠正在監聽,只能證明有程序占用,不能證明遠端節點可用。
檢查系統代理
- 設定位置
- 「系統設定」→「網路」
- 網路服務
- 目前使用的 Wi-Fi 或乙太網路 →「詳細資訊」→「代理」
- 代理類型
- 需與本機入站協定相符
- 伺服器與連接埠
- 填寫本機監聽資訊,不要填遠端訂閱節點
變更前請記下原有的手動代理、自動代理設定與例外項目,以便還原。
在 v2rayN 選擇「設定系統代理」後,回到目前使用的網路服務,檢查實際寫入的設定。切換到另一張網卡後,若應用程式突然不再走代理,請先檢查新服務的設定。若核心記錄出現 address already in use,可在終端機使用下方範例查看占用連接埠的程序;請將範例連接埠換成記錄中報錯的連接埠。
lsof -nP -iTCP:10808 -sTCP:LISTEN
確認占用連接埠的程序後,再決定是否結束舊執行個體,或替目前執行個體更換連接埠。更換後,請同步更新仍使用舊連接埠的系統代理或應用程式個別代理設定。結束 v2rayN 後網頁反而無法開啟,請優先確認系統是否仍指向已停止監聽的迴路連接埠;如果原本使用辦公室代理,請還原先前記錄的設定,不要一律清除。
macOS 網路權限常見問題
拒絕「本機網路」權限,訂閱就無法更新嗎?
不一定。macOS 15 的本機網路權限適用於存取區域網路裝置等情境,並不是通用的網際網路開關。公網訂閱更新失敗時,請先查看記錄,確認是解析失敗、連線逾時,還是服務回傳錯誤。只有在確實需要存取區域網路資源時,才到「系統設定」→「隱私權與安全性」→「本機網路」檢查該應用程式的權限狀態。
防火牆提示允許傳入連線,該按允許嗎?
僅在本機使用系統代理時,不要為了修復對外連線逾時而開放區域網路傳入連線。前往「系統設定」→「網路」→「防火牆」→「選項」查看該應用程式的規則,並確認監聽只綁定迴路位址。防火牆的傳入規則與核心能否連線至遠端,是兩個不同問題。
瀏覽器可以連線,為什麼另一個應用程式仍然直連?
檢查該應用程式是否有自己的代理設定。若支援手動設定,請選擇與本機監聽相同的協定,填入迴路位址和實際連接埠,再重試相同的請求。若只支援直連,不要因為系統代理設定成功,就認定該應用程式已使用代理。
系統要求加入網路設定,一般代理也需要嗎?
先確認是否主動啟用了 TUN 或其他虛擬網路功能。測試一般系統代理時,可先退出該模式,只檢查本機監聽與目前網路服務的代理設定。若需要額外授權,請確認提示中的要求對象與用途;受管理的裝置應由管理員確認是否允許啟用。