本文適合初次在 Mac 安裝 v2rayN，或遇到應用程式無法開啟、系統代理未生效的使用者。先依處理器架構選擇安裝檔，將應用程式移至「應用程式」資料夾，再透過 macOS 提供的單一應用程式允許選項啟動；接著分別確認本機監聽、系統代理，以及視需要出現的網路權限。Gatekeeper 允許應用程式執行，不代表代理連線已成功；管理員授權也不等於必須關閉系統安全功能。
選擇安裝檔：先確認晶片，再查看系統需求
點選螢幕左上角的 Apple 選單 →「關於這台 Mac」。若顯示「晶片 Apple M…」，請選擇 Apple Silicon，也就是 ARM64 架構；若顯示「處理器 Intel…」，請選擇 Intel，也就是 x64 架構。不要依外觀或購買年份判斷，同一產品名稱可能搭載不同處理器。
Apple Silicon 原生版本
建議適用於 Apple 晶片裝置，下載項目通常會標示 arm64。建議是指 Apple 晶片裝置優先使用相符的原生架構，並非所有 Mac 都應選這個版本。
適用裝置：在「關於這台 Mac」中顯示 Apple 晶片的 Mac。
Intel 原生版本
適用於 Intel 裝置，下載項目通常會標示 x64。Intel Mac 無法執行 ARM64 版本；Apple 晶片執行部分 Intel 程式可能需要 Rosetta，但初次安裝時不建議預設採用轉譯方式。
適用裝置：在「關於這台 Mac」中顯示 Intel 處理器的 Mac。
前往用戶端下載頁選擇 macOS 版本，並確認該次發行版本註明的最低系統需求。macOS 請下載對應的桌面應用程式，不要選 Windows WPF 版本。如果系統提示需要 Rosetta，而裝置使用 Apple 晶片，請先重新確認下載的架構；應用程式本體與隨附核心也應架構相符，避免混入舊資料夾中的其他架構執行檔。
- 壓縮檔請先完整解壓縮，再將應用程式移至「應用程式」資料夾；磁碟映像則先開啟，再將其中的應用程式拖曳至「應用程式」資料夾。
- 替換應用程式前先退出舊版；初次啟動時，不要直接執行壓縮檔預覽或磁碟映像中的暫存副本。
- 更新前，使用用戶端提供的備份或匯出功能保存設定；請勿將包含訂閱網址的備份上傳至公開位置。
Gatekeeper 阻擋啟動：使用「仍要打開」單獨允許
「無法驗證開發者」或「Apple 無法檢查它是否包含惡意軟體」是應用程式信任檢查提示，並非節點、DNS 或訂閱故障。請先確認檔案來自預期的發布管道，再使用系統提供的該應用程式例外選項。以下步驟適用於使用「系統設定」介面的 macOS；不同系統版本的提示文字可能略有差異。
-
初次開啟
在「Finder」→「應用程式」中按兩下 v2rayN。若安全性檢查阻止啟動，請看清楚提示後關閉對話框，保留這次啟動記錄。
-
前往安全性設定
開啟 Apple 選單 →「系統設定」→「隱私權與安全性」，向下找到「安全性」區域，確認遭阻擋的應用程式名稱是否為剛才開啟的 v2rayN。
-
單獨允許開啟
點選該筆記錄旁的「仍要打開」。系統要求時，使用 Touch ID 或管理者帳號確認，接著在確認視窗中選擇「打開」。
-
檢查主畫面
應用程式啟動後，先查看主畫面與記錄，確認核心沒有啟動失敗。能開啟視窗只代表應用程式已獲准執行，還需繼續檢查代理監聽和網路設定。
部分舊版 macOS 可在「Finder」中按住 Control 點按應用程式，再選擇「打開」以觸發例外確認；較新的系統不一定保留這種允許方式。請優先使用「隱私權與安全性」中的選項。本文不需要關閉整台 Mac 的 Gatekeeper，也不需要關閉系統完整性保護。
首次連線：分清本機連接埠與系統代理
在 v2rayN 主畫面匯入自己的訂閱，更新後選擇一個有效節點作為目前使用的伺服器。先查看「設定」→「參數設定」中的本機監聽連接埠，再從主畫面或選單列圖示的「系統代理」選單選擇「自動設定系統代理」。不同桌面版本的選項位置可能不同，請以目前介面顯示的同名設定為準。
以下使用 127.0.0.1:10808 示範支援 HTTP 代理的本機監聽位址；這不代表所有版本都預設使用此連接埠。如果目前用戶端顯示其他連接埠，或 HTTP 與 SOCKS 分別監聽，系統的網頁代理必須指向實際的 HTTP 入口，請勿照抄範例。
啟用後，開啟「系統設定」→「網路」→目前使用的 Wi-Fi 或乙太網路服務→「詳細資訊」→「代理伺服器」。若使用手動 HTTP 系統代理，請確認「網頁代理（HTTP）」和「安全網頁代理（HTTPS）」指向正確的本機位址與連接埠。這裡的 HTTPS 代理設定表示 HTTPS 請求會透過該 HTTP 代理建立通道，不代表本機入口本身必須啟用 TLS。
用戶端監聽範例
- 監聽位址
- 127.0.0.1
- 監聽連接埠
- 10808
- 入口支援
- 支援 HTTP 代理
- 目前使用的伺服器
- 已選取的有效節點
先確認記錄顯示核心啟動成功；範例數值必須替換為本機實際設定。
系統代理設定範例
- 網頁代理
- 127.0.0.1:10808
- 安全網頁代理
- 127.0.0.1:10808
- 代理伺服器驗證
- 僅依本機入口設定填寫
- 生效服務
- 目前連線的網路服務
若用戶端設定的是 PAC，請檢查自動代理設定網址，不要再疊加來源不明的手動代理。
系統代理只會影響遵循這項設定的應用程式。瀏覽器可以連線，但某個命令列工具仍直接連線，並不代表授權失敗；該工具可能需要個別設定代理參數。反之，系統設定顯示代理已啟用，也不能證明核心正在監聽，兩者必須分開確認。
網路權限：分別判斷管理員、本機網路與 TUN
macOS 沒有必須統一開啟的「允許所有代理流量」開關。出現權限提示時，請先確認是哪個程式提出要求，以及要變更什麼設定。一般系統代理、本機網路探索和虛擬網卡接管的用途不同，不要因為網頁無法開啟就把所有權限一律開啟。
| 提示或設定位置 | 實際用途 | 處理方式 |
|---|---|---|
| 管理員帳號確認 | 變更受保護的網路設定或安裝必要的輔助元件 | 確認提出要求的程序與操作確實是剛執行的用戶端動作後，再授權；不要將密碼輸入訂閱或節點表單。 |
| 隱私權與安全性 → 本機網路 | 控制應用程式存取區域網路裝置等本機網路資源 | macOS 15 與後續版本可能會出現相關請求。只有確實需要區域網路功能時才允許，不要把它當成控制網際網路存取的總開關。 |
| TUN 相關權限提升 | 建立虛擬網路介面、調整路由或 DNS | 只有目前版本提供此功能，且確實需要接管不遵循系統代理的應用程式時才啟用，並依照用戶端說明完成授權。 |
| 網路 → 防火牆 | 管理傳入連線 | 本機代理無法對外連線，通常不能靠關閉防火牆解決；只有明確需要其他裝置連入時，才檢查對應的輸入規則。 |
若「本機網路」列表沒有 v2rayN，不代表安裝有缺漏。通常要等應用程式觸發相關存取請求後，項目才會出現在列表中；單純透過迴路位址使用本機代理，不應因此判定必須補授權。受管理的工作電腦可能由組織政策控管網路擴充功能或代理設定，請交由管理員處理，不要自行移除管理設定檔。
連線疑難排解：先查監聽，再查目前使用的網路服務
若出現「系統代理已啟用，但網頁仍無法開啟」，請依序檢查本機入口、系統設定與遠端連線。先退出其他會修改系統代理的工具，避免多個程式互相覆寫設定。以下命令只會讀取狀態，不會修改系統設定；請在「應用程式」→「工具程式」→「終端機」中執行。
# 檢查範例連接埠是否有 TCP 監聽
lsof -nP -iTCP:10808 -sTCP:LISTEN
# 列出網路服務，確認實際使用的服務名稱
networksetup -listallnetworkservices
# 以下以服務名稱 Wi-Fi 為例
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getautoproxyurl "Wi-Fi"- 沒有監聽輸出：返回 v2rayN 記錄，確認核心是否已結束、連接埠是否不同。如果連接埠遭占用，先找出占用中的程序或在用戶端更改連接埠，再重新設定系統代理。
- 系統仍指向舊連接埠：先在用戶端清除系統代理，再重新自動設定；若要手動修改，請確保目前連線服務中的兩項網頁代理都已更新。
- 查詢服務名稱時發生錯誤：將命令中的
Wi-Fi替換為列表中實際的網路服務名稱；名稱含空格時，請保留英文雙引號。 - 監聽與系統設定都正確：查看記錄中的遠端連線、TLS 或網域名稱解析錯誤。逾時可能是伺服器無法連線；若有憑證錯誤，請檢查系統時間與節點 TLS 參數，不要以略過憑證驗證取代疑難排解。
也可以用以下請求單獨測試本機 HTTP 代理。此命令會明確指定代理，不依賴系統代理開關；請將範例連接埠改為實際使用的連接埠。目標是本站首頁，測試結果會受目前網路、節點和目標網站狀態影響，不要以單次請求的結果推論所有應用程式的連線狀況。
curl --proxy http://127.0.0.1:10808 --head --max-time 15 https://v2raydns.com/若顯示無法連線至 127.0.0.1，請優先檢查本機監聽；若已連上本機但遠端請求失敗，再檢查目前使用的節點與記錄。若明確指定代理的請求成功，但瀏覽器仍失敗，請檢查瀏覽器是否另有代理設定、舊 PAC 或擴充功能覆寫設定。本機入口尚未正常運作前，請勿反覆修改 DNS。
常見問題：允許啟動後還要檢查哪些項目？
為什麼沒有「仍要打開」按鈕？
先從「應用程式」再次嘗試啟動，接著立即查看「系統設定」→「隱私權與安全性」下方的安全性區域。確認提示確實是開發者驗證問題，而非惡意軟體阻擋或組織政策所致。若仍找不到允許選項，請記下系統版本與完整提示內容，不要改用關閉整台 Mac 安全性檢查的方式。
已允許開啟，為什麼記錄仍顯示權限不足？
Gatekeeper 只負責應用程式執行信任檢查。請確認錯誤涉及的是核心執行、設定資料夾寫入，還是 TUN 權限提升；並確認應用程式已完整移至「應用程式」資料夾，且目前帳號可寫入用戶端實際使用的設定資料夾。不要以管理員身分啟動整個桌面程式來掩蓋資料夾權限問題。
切換 Wi-Fi 後代理失效，需要重新授權嗎？
先檢查目前網路服務的「詳細資訊」→「代理伺服器」。從 Wi-Fi 切換到有線網路，可能會改用另一個服務，而該服務的代理設定未必相同。請在 v2rayN 重新執行自動設定系統代理，再確認位址與連接埠；不要把網路服務差異誤判為 Gatekeeper 再次阻擋。
退出用戶端後，整個瀏覽器都無法連線怎麼辦？
啟動 v2rayN，在「系統代理」中選擇「清除系統代理」後再退出。若應用程式已無法啟動，請前往目前網路服務的「代理伺服器」頁面，關閉指向本機舊連接埠的網頁代理或停用舊 PAC。只清除屬於該用戶端的設定；若是組織要求使用的代理，請先洽詢管理員。
完成安裝設定：保留可還原的網路狀態
完成設定後，至少完整測試一次「啟動用戶端 → 開啟系統代理 → 正常連線 → 清除系統代理 → 退出用戶端」流程。這樣才能確認連線正常是因為實際監聽與設定正確，而非瀏覽器快取或其他代理設定殘留。更新應用程式、更換節點或啟用 TUN 時，每次只變更一類設定，發生問題時才容易找出原因。
- 記下本機實際監聽連接埠與目前使用的網路服務名稱，方便日後核對；請勿在公開的疑難排解截圖中留下訂閱網址。
- 分享記錄前，請隱藏伺服器位址、使用者識別資訊、訂閱權杖等敏感資料，只保留錯誤類型與必要的相關資訊。
- 解除安裝前，先關閉 TUN（若已啟用）並清除系統代理；刪除應用程式本身，不代表網路設定也會一併還原。
- 若要進一步了解匯入訂閱與 DNS 設定，請依入門教學逐項設定，不要同時變更核心、路由與解析策略。