v2rayN macOS 安裝教學：無法開啟、開發者未驗證與網路權限設定

1. macOS 安裝套件怎麼選：ARM64 與 x64

Mac 應下載 v2rayN Desktop 的 macOS 安裝套件，而非 Windows WPF 版。Desktop 採用跨平台介面架構，但不同作業系統的執行檔無法互通；若檔名含有 WPF 或 Windows，請返回下載頁重新選擇。

可在「蘋果選單」→「關於這台 Mac」查看晶片資訊。若顯示 Apple M 系列晶片，請選 ARM64；若顯示 Intel 處理器，請選 x64。系統版本需求請以目前安裝套件的發行說明為準，不能只憑晶片型號就認定舊版 macOS 能執行。

2. DMG 安裝與首次啟動

先將應用程式複製到「應用程式」，再從本機位置啟動。直接從已掛載的 DMG 磁碟映像執行，會讓更新、寫入與權限排查多出變因；重新安裝時，也請確認開啟的不是「下載項目」資料夾中的舊版本。

1. 確認晶片型號

   開啟「蘋果選單」→「關於這台 Mac」，記下晶片類型與 macOS 版本，再前往本站下載中心選擇相符的 macOS 安裝套件。

2. 複製應用程式

   按兩下 DMG，依安裝視窗指示將 v2rayN 拖曳至「應用程式」。等待複製完成後退出磁碟映像，不要只把應用程式捷徑留在桌面。

3. 首次啟動

   在「Finder」→「應用程式」中開啟 v2rayN。若遭到攔截，請記下提示原文，再依下一節前往「隱私權與安全性」處理；不要反覆按兩下碰運氣。

4. 匯入設定

   在用戶端選擇「訂閱群組」→「訂閱群組設定」，新增服務提供者提供的訂閱網址並儲存，再透過「訂閱群組」選單更新訂閱。選單名稱可能因版本而異，請以目前介面為準。

5. 先測試一般代理

   選擇一台伺服器，先使用系統代理測試瀏覽器連線；確認核心能啟動後，再考慮使用 TUN。首次安裝時不建議同時變更核心、路由、DNS 與流量接管方式。

訂閱網址是取得伺服器設定的入口，不是應用程式安裝套件，也不是帳號密碼欄位。匯入後若沒有伺服器，請先檢查訂閱回應內容與更新記錄；應用程式能開啟但清單空白時，不必重新執行系統允許程序。

3. 無法驗證開發者：依系統提示個別允許

「無法驗證開發者」表示 macOS 無法依目前安全性政策確認此應用程式，不代表已判定檔案損壞。請先確認下載來源與檔案類型；來源不明的副本應停止使用並重新取得，不要直接允許開啟。

在 macOS 13 及後續版本，常見路徑為「蘋果選單」→「系統設定」→「隱私權與安全性」。嘗試開啟應用程式後，前往頁面中的安全性區域，查看是否出現此次遭封鎖的記錄與「仍要打開」按鈕。按下按鈕後依系統要求完成驗證，再於確認視窗選擇「打開」。

較舊系統的對應入口為「系統偏好設定」→「安全性與隱私權」→「一般」。受管理的電腦可能不允許使用者核准應用程式，此時請聯絡裝置管理員，不要嘗試解除管理限制。

4. 應用程式已損壞：重新下載，再檢查隔離屬性

「應用程式已損壞，無法打開」可能與下載不完整、應用程式套件遭修改、簽章問題或系統隔離下載檔案有關。這項提示本身無法證明磁碟中的檔案確實損壞，也不能作為直接移除隔離屬性的理由。

• 檢查磁碟映像：若 DMG 無法掛載，或複製途中發生錯誤，請先刪除這次下載的檔案，再重新下載完整安裝套件。
• 確認副本位置：先結束用戶端，再從「應用程式」啟動新副本，避免仍在執行已掛載磁碟映像中的舊版應用程式。
• 檢查系統需求：若系統版本過舊或架構不符，請改用支援的套件或升級系統；調整權限無法補足執行條件。
• 保留錯誤原文：簽章無效、開發者無法驗證與惡意軟體警告應分別處理，不要一概歸因於「權限不足」。

只有在確認來源可信、重新下載後仍遇到隔離相關攔截，且了解可能的影響時，才考慮檢查應用程式的延伸屬性。以下指令假設應用程式位於 /Applications/v2rayN.app；若名稱不同，必須改成實際路徑，也可以從 Finder 將應用程式拖入終端機確認路徑。

# 唯讀檢查：查看此應用程式是否具有下載隔離屬性
xattr -p com.apple.quarantine "/Applications/v2rayN.app"

# 可選操作：僅移除此已確認可信的應用程式套件的隔離屬性
xattr -r -d com.apple.quarantine "/Applications/v2rayN.app"

5. 系統代理授權與本機連接埠檢查

系統代理會將使用 macOS 代理設定的應用程式請求轉交給本機用戶端；它並非遠端伺服器的連接埠設定。v2rayN 介面能開啟，不代表代理核心已成功監聽，也不代表所有應用程式都會使用系統代理。

以下以 127.0.0.1:10808 為例，並非所有版本都使用相同連接埠。請先在 v2rayN「設定」→「參數設定」中查看實際的本機監聽設定；部分舊版設定會分別指定 HTTP 與 SOCKS 連接埠，不要將 SOCKS 專用連接埠直接填入 HTTP 代理欄位。

即使同意授權後仍未寫入代理設定，請先確認目前使用的是 Wi-Fi 還是乙太網路，以及裝置是否受管理政策控制。不要因此開啟「完整磁碟存取權」：這項權限與正常寫入網路代理設定無關。

# 查看系統代理狀態，不修改設定
scutil --proxy

# 檢查範例連接埠是否有程式監聽；請依實際連接埠修改
lsof -nP -iTCP:10808 -sTCP:LISTEN

# 僅在此連接埠支援 HTTP 代理時測試
curl -I --connect-timeout 10 --proxy http://127.0.0.1:10808 https://example.com/

若測得 HTTP 回應，表示這次請求至少已透過該代理完成連線；逾時不一定是授權問題，也可能是節點、DNS 或遠端連線失敗。若連接埠支援 SOCKS，可另以 curl -I --connect-timeout 10 --proxy socks5h://127.0.0.1:10808 https://example.com/ 測試，其中 socks5h 會將目的網域交由代理解析。

6. TUN、網路延伸功能與本機網路權限

TUN 與系統代理是兩種不同的流量接入方式。TUN 通常透過虛擬網路介面、路由與 DNS 設定接管流量，可能需要提升權限；實際方式則依用戶端版本與所選核心而異，不能將所有 TUN 啟動都視為安裝 macOS 網路延伸功能。

• 一般系統代理：先用瀏覽器確認節點與核心運作正常。部分應用程式不使用系統代理，不代表用戶端安裝失敗。
• TUN 提權要求：只有在主動啟用 TUN，且確認要求來自正在執行的用戶端時才授權。若啟動失敗，請檢查記錄中的權限、虛擬介面或路由錯誤。
• 核准網路延伸功能：只有目前版本確實使用網路延伸功能並觸發系統提示時才需要處理。較新的系統可前往「系統設定」→「一般」→「登入項目與延伸功能」→「網路延伸功能」查看；其他版本請依提示檢查「隱私權與安全性」。
• 本機網路權限：若系統提供此設定，請前往「系統設定」→「隱私權與安全性」→「本機網路」，確認應用程式是否獲准存取區域網路。此權限不代表允許所有網際網路連線，也不能取代 TUN 提權。

排查 TUN 時，請先結束其他正在接管網路的工具，再只啟用一種接管方式進行比較。若系統代理可用但 TUN 無法運作，請優先檢查權限、介面、路由與 DNS，不必立刻重裝用戶端或更換所有伺服器。FakeDNS 也不是安裝必備項目，不要為了解決應用程式無法開啟而順手啟用。

7. 安裝後驗證與退出後還原

完成安裝後，透過可重現的檢查流程確認結果，比只看「已連線」更可靠。用戶端管理介面、代理核心、系統接入方式與遠端伺服器各有不同用途，應逐層驗證。

1. 應用程式層：從「應用程式」啟動，確認沒有安全性攔截；結束後再次開啟，確認使用的是同一份應用程式。
2. 設定層：訂閱已產生伺服器項目，所選的 VMess 或 VLESS 設定符合服務提供者的要求。請勿憑經驗任意變更通訊協定、傳輸方式與 TLS 參數。
3. 核心層：啟動記錄沒有持續當機或監聽失敗，本機連接埠也能查到對應處理程序；不要同時執行多個用戶端，以免爭用連接埠。
4. 接入層：先測試系統代理，再單獨測試 TUN。每次只變更一項設定，並記錄變更前後的結果。
5. 還原層：結束前先關閉 TUN，再將系統代理切換為「清除系統代理」。若程式異常結束，請到 macOS 目前網路服務的「代理伺服器」頁面，確認是否有殘留設定。

若關閉用戶端後所有網頁都無法開啟，常見原因是系統仍指向已停止監聽的本機連接埠。清除殘留代理後再測試直接連線，不要先刪除整個網路服務。重新安裝前請備份必要設定；將記錄提供給他人時，請遮蔽訂閱網址、伺服器憑證與帳戶資訊。

最後可依序排查：選對套件、複製到本機、核准單一應用程式、確認核心監聽、檢查系統代理，最後處理 TUN 權限。這樣既能找出「無法開啟」的原因，也能避免混淆安裝問題與節點連線問題。