v2rayN macOS 安裝教學：解除「無法驗證開發者」封鎖與網路權限設定

一、確認安裝檔架構與應用程式位置

開啟 Apple 選單中的「關於這台 Mac」。若顯示 Apple 晶片，請選擇 Apple Silicon 版本；若顯示 Intel 處理器，則選擇 Intel 版本。架構不符可能導致應用程式無法啟動、要求額外的相容執行環境，或雖能開啟介面，隨附核心卻無法執行。啟動問題不一定都是開發者驗證所致。

1. 確認晶片型號

   從 Apple 選單開啟「關於這台 Mac」，確認晶片類型，再前往用戶端下載頁的 macOS 區段，選擇相符的版本。

2. 解壓縮安裝檔

   若下載的是壓縮檔，請先解壓縮並找到應用程式本體；若是磁碟映像檔，請先開啟，再將其中的應用程式複製出來。不要直接拖曳壓縮檔，也不要長期從暫存預覽資料夾執行。

3. 移至「應用程式」

   在 Finder 選擇「前往」→「應用程式」，將 v2rayN 拖曳至此。更新前先結束舊版程序，再替換應用程式，並備份現有設定。

4. 首次開啟

   從「應用程式」啟動。如果系統封鎖，請先看清楚完整提示，再依下一節前往「隱私權與安全性」處理。不要反覆解壓縮出多個副本再逐一嘗試。

5. 確認核心是否執行

   進入主畫面後匯入設定、選擇節點並查看執行記錄。介面正常不代表代理核心已啟動；請先確認沒有連接埠衝突或設定解析錯誤。

本文以 v2rayN.app 作為應用程式名稱範例。實際檔名、選單文字與功能位置可能因用戶端版本而異；命令中的應用程式路徑應與 Finder 顯示的名稱一致。系統路徑以 macOS 13 及更新版本的「系統設定」介面為例，並非用戶端的最低系統需求。

二、無法驗證開發者：解除 Gatekeeper 封鎖

「無法驗證開發者」或「Apple 無法檢查此 App 是否包含惡意軟體」是應用程式執行前的安全檢查提示，與訂閱網址、VMess 或 VLESS 參數無關。解除封鎖前，請先確認安裝檔來源及預期相符，而且剛才嘗試開啟的確實是放在「應用程式」中的那份程式。

1. 嘗試開啟應用程式一次，記下提示內容後關閉提示視窗。
2. 前往 Apple 選單中的「系統設定」→「隱私權與安全性」，向下找到「安全性」區段。
3. 如果看到該應用程式的封鎖記錄，請先核對名稱，再按一下「仍要打開」。此按鈕通常只會在最近一次遭封鎖後的一段時間內顯示。
4. 依系統要求使用密碼或 Touch ID 確認；若再次出現確認提示，核對後選擇「打開」。

部分 macOS 版本可在 Finder 中按住 Control 鍵並點按應用程式，再選擇「打開」；較新的系統可能仍須回到「隱私權與安全性」確認。如果 Mac 由組織管理，「仍要打開」可能受管理政策限制，請聯絡管理員，不要自行修改系統政策。

若要記錄檢查資訊，可在「應用程式」→「工具程式」→「終端機」執行以下唯讀命令。com.apple.quarantine 屬性表示檔案帶有下載隔離標記，不能單憑此項判定檔案可信或有害；評估結果也不等同完整的程式行為稽核。

xattr -l "/Applications/v2rayN.app"
spctl --assess --type execute --verbose "/Applications/v2rayN.app"

三、系統代理與 TUN：先選擇流量接管方式

開啟 v2rayN 主畫面後，建議先用系統代理進行基本測試。系統代理會將目前網路服務的代理設定指向本機監聽連接埠，供遵循系統代理設定的應用程式使用；它不會自動接管所有程序，也不保證處理所有 UDP 流量。TUN 則涉及虛擬網路介面與路由，所需權限及故障範圍都不同。

建議先關閉 TUN，只保留一種流量接管方式。確認系統代理可正常運作後，再視需要測試 TUN。兩種方式同時啟用會增加路由、DNS 與本機迴圈的排查難度；發生問題時，也更難判斷連線實際經過哪條路徑。

四、本機監聽與 macOS 代理欄位對照

以下以 10808 作為代理輸入連接埠範例，並以 10809 作為備用連接埠。這些數值不代表所有版本的預設值。請開啟 v2rayN「設定」→「參數設定」，檢查本機監聽相關項目；最後以儲存後的設定和目前的啟動記錄為準。變更連接埠後，也必須同步更新系統代理中的連接埠。

前往「系統設定」→「網路」→目前使用的 Wi-Fi 或乙太網路→「詳細資訊」→「代理伺服器」。HTTP、安全網頁代理與 SOCKS 是不同選項；設定前請確認核心輸入端接受哪種協定。只有在輸入端明確支援 HTTP 與 SOCKS 混合連線時，才能讓兩種要求使用同一個連接埠。

可在終端機唯讀檢查監聽狀態及目前的系統代理。第一個命令若沒有輸出，請先確認核心是否啟動或連接埠是否已變更；看到監聽狀態，只能證明程序正在使用該連接埠，不能證明遠端節點可用。第二個命令顯示的代理位址應與用戶端的本機輸入端設定相符。

lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy

五、網路權限：依實際需求逐項核准

系統代理、網路擴充功能、本機網路與輸入連線防火牆屬於不同層級。啟用系統代理不一定會觸發網路擴充功能核准；出現本機網路提示，也不表示連線遠端代理必須存取區域網路。請只核准目前使用方式所需的權限，並確認要求權限的是哪個應用程式或元件。

如果系統沒有出現網路擴充功能的核准項目，而用戶端記錄顯示使用其他 TUN 實作方式，就不必為了尋找不存在的開關而反覆重裝。請先從記錄確認故障階段：建立介面、申請權限、設定路由，還是 DNS 要求失敗。系統代理已能正常運作時，建議先維持可用模式，再單獨處理 TUN。

六、升級後權限異常與代理設定殘留

替換應用程式可能改變可執行檔、簽署狀態或輔助元件，因此系統可能再次要求核准權限。不過，升級後無法連線不一定是權限遺失：舊程序占用連接埠、新核心無法讀取設定、網路服務切換，以及退出後系統代理設定未清除，都可能造成類似狀況。

• 替換前：先備份設定，在用戶端清除系統代理並關閉 TUN，再結束應用程式；必要時用「活動監視器」確認舊程序已結束。
• 替換後：只從「應用程式」啟動新版。若再次出現開發者驗證提示，請依前述步驟重新確認，不要同時執行下載資料夾中的舊版本。
• 檢查權限：只有系統明確要求重新核准時，才檢查對應的擴充功能或輔助元件。不要把所有權限全部關閉再開啟，當成固定的升級步驟。
• 確認連接埠：查看記錄中的監聽位址，並核對 scutil --proxy 的輸出；若連接埠不一致，請重新執行用戶端的系統代理設定。
• 恢復直接連線：若應用程式暫時無法執行，請前往目前網路服務的「代理伺服器」設定，關閉先前為本機代理啟用的選項並套用。若代理設定受管理，請先詢問管理員。

七、安裝與解除封鎖常見問題