本文重點

適合已下載 v2rayN，卻在 macOS 首次啟動或連線時遇到問題的使用者。先確認晶片架構與應用程式來源，再透過系統提供的選項處理開發者驗證，最後釐清系統代理、區域網路權限與 TUN 授權。目標是先讓本機代理正常監聽，再確認瀏覽器與命令列工具是否確實透過代理連線。

一、安裝前確認晶片架構與應用程式位置

v2rayN 是桌面用戶端，負責管理訂閱、節點與路由；實際的代理連線則由它啟動的核心處理。介面能開啟，不代表核心已成功執行。安裝包架構不符、應用程式仍在磁碟映像檔中，或核心執行失敗，都可能讓問題看起來像是「權限不足」。

開啟蘋果選單 →「關於這台 Mac」。若電腦配備 Apple 晶片，請優先選擇 macOS ARM64 版本；若配備 Intel 處理器，則選擇 macOS x64 版本。請前往下載中心查看下載連結與安裝說明。安裝包所需的最低系統版本請以下載頁面及包內說明為準，別只因檔案能解壓縮就判斷相容。

選擇符合晶片架構的原生版本

建議

Apple 晶片選 ARM64，Intel 選 x64。用戶端與隨附核心都應符合目標平台，盡量減少架構轉譯帶來的額外變數。

適用情況：首次安裝、重新整理應用程式目錄。

在 Apple 晶片上執行 x64 版本

部分程式可透過 Rosetta 執行，但不代表包內所有輔助程式都相容。只有發行說明明確表示支援時才考慮使用，不要把它當成預設的修復方式。

適用情況：確有相容需求，且能確認發行說明的使用者。

若下載的是磁碟映像檔，請先將應用程式拖曳至「應用程式」資料夾，再啟動程式；若下載的是壓縮檔，請完整解壓縮並保留隨附目錄。不要只從整套檔案中抽出主程式，也不要直接從壓縮檔預覽中執行。更新前請先關閉舊版，並備份用戶端設定；備份可能包含訂閱網址，請存放在私人目錄。

二、透過系統設定允許開啟「無法驗證開發者」的應用程式

這類提示通常來自 macOS 的 Gatekeeper 檢查：系統無法依目前政策確認應用程式的開發者身分或公證狀態。這與節點是否可用，以及 VMess 或 VLESS 參數是否正確無關。請先確認下載來源與應用程式名稱，再個別允許這個應用程式開啟，不必停用整台電腦的安全檢查。

  1. 觸發一次安全提示

    在 Finder 的「應用程式」資料夾中，按兩下 v2rayN。記下彈出視窗的原文，然後關閉提示。尚未確認應用程式來源前，請勿繼續授權。

  2. 開啟安全性設定

    前往蘋果選單 →「系統設定」→「隱私權與安全性」，向下找到「安全性」區段。針對剛遭阻擋的應用程式，系統可能會顯示允許開啟的選項。

  3. 選擇「仍要打開」

    確認說明中的應用程式是 v2rayN 後，按一下「仍要打開」。依系統提示使用 Touch ID 或管理員憑證確認，然後在後續對話框中選擇「打開」。

  4. 重新確認是否能啟動

    等待主畫面出現，並檢查用戶端記錄中是否仍有輔助程式遭阻擋、架構不支援或核心啟動失敗等訊息。若出現新的安全提示，請先確認相關元件，不要反覆允許來源不明的檔案。

以上步驟適用於使用「系統設定」的較新版本 macOS。較舊版本可能顯示「系統偏好設定」→「安全性與隱私權」→「一般」。按鈕文字也可能因系統版本而異；尤其 macOS 15 及後續版本，不要將「按住 Control 並按一下來打開」視為通用的繞過方式，請以「隱私權與安全性」中的系統選項為準。

如果沒有「仍要打開」按鈕，請先再次觸發阻擋提示，再回到設定檢查。受公司管理的電腦可能受到裝置管理政策限制，請交由管理員處理。即使使用管理員帳號，也不一定能繞過組織政策。

三、釐清系統代理、區域網路與 TUN 權限

macOS 並沒有一項授權就能解決所有網路問題的「萬用權限」。一般對外連線通常不需要個別確認；存取區域網路、修改系統代理、安裝特權輔助元件及建立 TUN 介面，則是不同操作。請先採用影響範圍較小的系統代理方案，確認可正常運作後，再視需要啟用 TUN。

先使用系統代理，再視需要啟用 TUN

系統代理方式
  • 讓支援系統代理的瀏覽器與應用程式連線至本機入口。
  • 在 v2rayN 的系統代理選單中選擇「自動設定系統代理」。選項位置可能因版本而異。
  • 修改網路服務的代理設定時，系統可能會要求管理員確認。
TUN 方式
  • 若目前版本支援 macOS TUN，可透過虛擬網路介面接管流量。
  • 可能需要安裝輔助元件、提升權限或核准網路設定，請依實際系統提示操作。
  • 此方式會變更路由與 DNS，不能只看開關已開啟就認定流量已成功接管。

一次只啟用一種接管方式；系統代理確認可用後，再單獨測試 TUN，較容易判斷故障所在。

若要檢查系統代理，請前往「系統設定」→「網路」→目前使用中的 Wi-Fi 或乙太網路服務→「詳細資訊」→「代理伺服器」。確認 HTTP、HTTPS 或 SOCKS 項目是否指向正確的本機回送位址與連接埠。不要在這裡填入遠端節點的伺服器位址：這些欄位應連線至電腦上正在執行的本機代理。

四、確認本機監聽設定與系統代理一致

匯入訂閱後，選取一個節點並設為目前使用的伺服器，再查看記錄確認核心已啟動。檢查「設定」→「參數設定」中的本機監聽設定；不同版本可能使用「本機連接埠」或「入口設定」等名稱。請以介面與記錄中顯示的實際連接埠及協定為準，不要假設所有版本都使用教學中的數字。

10808
本文範例的 HTTP 或混合入口連接埠
443
下方 HTTPS 測試使用的目標連接埠

以下範例假設已在用戶端確認 127.0.0.1:10808 可接受 HTTP 代理連線。如果該連接埠僅提供 SOCKS 入口，請使用後面的 SOCKS 命令；若實際連接埠不同，請先修改命令中的連接埠。不要為了套用範例而覆蓋現有可用的設定。

HTTP 測試參數

監聽位址
127.0.0.1
範例連接埠
10808
命令使用的協定
http://
適用的入口類型
HTTP 或支援 HTTP 的混合入口

系統的 HTTP 與 HTTPS 代理可使用同一個本機 HTTP 代理連接埠。

SOCKS 測試參數

監聽位址
127.0.0.1
範例連接埠
10808
命令使用的協定
socks5h://
適用的入口類型
SOCKS 或支援 SOCKS 的混合入口

socks5h 會透過代理解析目標網域；純 HTTP 入口無法使用這個命令。

開啟「終端機」，先檢查連接埠是否正在監聽，再確認系統代理狀態。這兩個命令只會讀取狀態，不會變更網路設定。

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

第一個命令應能找到對應的監聽程序；若沒有輸出，請先排查核心啟動或連接埠設定。第二個命令會檢查目前的系統代理設定，請特別留意 HTTPEnable、HTTPProxy、HTTPPort 等欄位。已啟用的項目應指向實際的本機入口；代理顯示為啟用，不代表遠端節點一定可連線。

五、使用明確指定代理的命令測試連線

macOS 終端機中的程式不一定會自動使用系統代理。因此，即使瀏覽器可以連線，一般的 curl 失敗也不代表 v2rayN 有問題。請先使用明確指定代理的命令，分別測試「應用程式是否使用代理」及「代理本身是否連通」。

# 適用於接受 HTTP 代理的本機入口
curl --noproxy "" --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

# 僅適用於該連接埠接受 SOCKS 連線的情況
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

依實際入口類型選擇其中一個命令即可。--noproxy "" 可避免環境中的代理略過清單干擾這次測試。收到 HTTP 回應，表示這次要求已與目標網站完成通訊；不代表所有應用程式都已接管，也不代表所有網站都能連線。HTTP 代理顯示隧道已建立後，仍應確認最終網站的回應或錯誤。

狀況優先檢查項目下一步
無法連線至本機連接埠核心未執行、連接埠填錯查看記錄與監聽結果，先不要調整系統權限。
本機連接埠可連線，遠端連線逾時目前使用的節點、伺服器位址、傳輸與 TLS 參數查看核心錯誤，並改用已知可用的節點比對。
明確指定代理後可連線，瀏覽器卻無法連線系統代理、瀏覽器個別代理、略過規則確認目前使用的網路服務與瀏覽器設定。
系統代理正常，TUN 無法使用輔助元件、路由、DNS、其他隧道先關閉 TUN 恢復基準狀態，再逐項檢查相關記錄。

成功匯入訂閱只代表用戶端讀取到設定。VMess、VLESS 等協定仍需要有效的伺服器資訊與驗證參數；TLS 連線也仰賴正確的系統時間與伺服器名稱。節點設定錯誤，不會因為反覆核准網路權限而消失。若要進一步檢查設定，請參考設定大全，先了解各欄位用途，再修改原始訂閱。

六、退出、更新與故障復原

首次安裝完成後，建議測試一次退出流程：先在用戶端停用系統代理、關閉 TUN，再結束 v2rayN。瀏覽器應能依原本的直連設定存取網路。若直接強制結束程序，系統代理可能仍指向已停止監聽的連接埠，導致關閉用戶端後所有網頁反而都無法開啟。

最後請分別確認三件事：應用程式能啟動、核心正在監聽、要求能透過正確的代理入口完成。依這三個層次逐一排查，就不會把開發者驗證、macOS 權限授權與節點連線問題混為一談。訂閱更新與連接埠衝突等常見問題，也可參考常見問題。