v2rayN 首次安裝設定完整教學：Windows 與 macOS 通用重點及常見問題

一、下載前先確認系統架構與執行方式

v2rayN 是桌面圖形化用戶端，負責管理訂閱、節點、路由規則與系統代理，實際的協定連線則由 Xray 或 v2fly 等核心程序完成。首次安裝時，用戶端介面能開啟，不代表核心已正常執行；後續仍須同時檢查主程式、核心檔案與本機監聽連接埠。

下載前先查看裝置架構。Windows 可開啟「設定」→「系統」→「系統資訊」，在「系統類型」中確認 x64 或 ARM64；macOS 可開啟左上角系統選單中的「關於這台 Mac」，確認裝置使用 Apple 晶片還是 Intel 處理器。架構選錯時，常見結果是程式無法啟動、核心立即結束，或系統提示應用程式不相容。

1. 確認架構

   Windows 查看「系統類型」，macOS 查看處理器資訊；x64、ARM64 安裝包不可任意混用。

2. 取得用戶端

   進入本站下載中心，依目前的桌面作業系統選擇 v2rayN 7.x 對應版本，不要用 Android 用戶端安裝包取代桌面程式。

3. 完整解壓縮

   壓縮檔必須完整解壓縮至獨立資料夾。Windows 可放在使用者資料夾下，避免直接放入需要持續取得系統管理員權限的位置。

4. 檢查執行環境

   若選擇依賴執行環境的版本，請依啟動提示安裝相符的 .NET 8 Desktop Runtime；自包含版本通常不需要另外安裝。

5. 首次啟動

   Windows 執行主程式；macOS 將應用程式放入「應用程式」後啟動，並依系統提示確認開啟權限。

6. 保留原始資料夾

   啟動後不要移動單一可執行檔。核心、設定、記錄與主程式應維持完整的資料夾結構。

Windows 出現「缺少執行環境」時，應先確認下載的是依賴執行庫版本還是自包含版本。反覆以系統管理員身分啟動，無法補齊缺少的元件。macOS 首次阻止開啟時，可進入「系統設定」→「隱私權與安全性」，確認遭阻擋的應用程式名稱後，使用系統提供的「仍要開啟」操作；不要透過刪除安全屬性來繞過來源確認。

二、首次啟動先選擇核心，再調整基本參數

進入主介面後，先開啟「設定」→「參數設定」→「Core 類型」。如果訂閱包含 VLESS、Reality、XTLS Vision 等設定，應優先選擇 Xray 核心；只使用傳統 VMess 設定時，v2fly 核心也能完成基本連線。核心類型必須與節點協定及傳輸參數相容，否則節點雖能匯入，卻會在啟動階段顯示「不支援的欄位」或直接結束。

基本參數不必一次全部修改。建議先保留預設記錄層級，確認本機 SOCKS 連接埠與 HTTP 連接埠，再決定是否啟用開機啟動。常見設定以 10808 作為 SOCKS 連接埠、10809 作為 HTTP 連接埠，但實際數值必須以「設定」→「參數設定」中顯示的本機監聽設定為準。

• Core 類型：一般新設定選擇 Xray，只有明確需要相容既有 v2fly 設定時才切換。
• 本機位址：僅供本機使用時保持 127.0.0.1，不要為了排查問題直接改成監聽所有網路介面。
• SOCKS 連接埠：範例為 10808，供支援 SOCKS5 的應用程式個別填寫。
• HTTP 連接埠：範例為 10809，可供瀏覽器、命令列工具或系統代理使用。
• 記錄層級：首次設定保留 info；定位問題時暫時切換至 debug，排查完成後恢復，避免記錄快速增加。

三、匯入訂閱並檢查節點欄位

準備好完整的訂閱連結後，在主介面進入「訂閱群組」→「訂閱群組設定」→「新增」。填寫群組備註並貼上連結，儲存後執行「更新所有訂閱」。不同 7.x 小版本的按鈕位置可能略有調整，但操作順序始終是先建立訂閱群組，再觸發更新，而不是把訂閱網址當成單一節點連結直接匯入。

判斷更新成功的最低標準不是跳出「完成」，而是主清單出現節點，且協定、位址、連接埠、傳輸方式等欄位都有有效值。若清單為空，先檢查連結頭尾是否夾帶空格、複製內容是否被聊天工具截斷，以及訂閱服務是否要求先透過既有代理更新。

匯入節點後，選擇一個節點並設為作用中伺服器，再觀察底部狀態與核心記錄。連線過程通常會經歷產生設定、啟動核心、本機連接埠監聽三個階段。若記錄在產生設定前終止，優先檢查節點欄位；若提示位址已被使用，表示本機連接埠發生衝突；若核心正常監聽但連線逾時，再檢查節點可用性、網路路徑與系統代理。

四、系統代理與開機啟動要分開設定

v2rayN 核心啟動後，只代表本機出現可用的代理連接埠，並不會自動讓所有軟體經過該連接埠。若要讓遵循系統網路設定的瀏覽器與應用程式使用代理，還需要在 v2rayN 托盤選單或系統代理功能中選擇「自動設定系統代理」。退出用戶端前應恢復系統代理，避免系統繼續指向已停止監聽的 127.0.0.1:10809。

Windows 的「以系統管理員身分執行」和「開機自動啟動」不是同一件事。一般本機代理通常不要求每次取得提升權限；只有防火牆規則、受保護資料夾寫入或特定系統設定需要授權時，系統才會提示。長期將程式放在受保護資料夾，可能使設定儲存與自動更新反覆遇到權限問題，因此建議放在目前使用者可讀寫的固定資料夾。

macOS 啟用登入時啟動後，還應進入「系統設定」中的登入項目頁面，確認 v2rayN 是否獲准在背景啟動。若登入後程式已執行但代理沒有生效，應分別查看核心是否啟動、作用中節點是否保留、系統代理是否切換，不能只依選單列圖示判斷連線狀態。

五、透過連接埠、命令與記錄完成首次驗收

首次設定完成後，建議進行兩輪測試。第一輪繞過系統代理，直接將請求送至 v2rayN 的 HTTP 連接埠，用來確認核心與節點是否正常；第二輪再開啟系統代理，使用瀏覽器存取網站，確認系統設定已正確指向本機連接埠。如此可避免將節點故障、連接埠衝突與系統代理錯誤混為一談。

Windows 查看 10809 連接埠：
netstat -ano | findstr 10809

macOS 查看 10809 連接埠：
lsof -nP -iTCP:10809 -sTCP:LISTEN

透過本機 HTTP 代理測試：
curl --proxy http://127.0.0.1:10809 https://v2raymap.com/

若連接埠命令沒有任何輸出，表示核心沒有監聽該連接埠，請先回到 v2rayN 檢查核心記錄與本機連接埠設定。若連接埠存在，但 curl 回傳連線被拒絕，請確認輸入的是 HTTP 連接埠還是 SOCKS 連接埠；使用 SOCKS5 測試時，應將參數改為對應的 SOCKS5 代理格式，並使用實際連接埠。

排查記錄應從第一筆明確錯誤開始，而不是只看最後一行。連接埠佔用通常包含「address already in use」，節點欄位不相容會指出具體設定項目，網域名稱解析或遠端連線失敗則常見 timeout、connection refused 等訊息。記下錯誤發生時間，再對照剛執行的操作，定位速度會比持續切換節點更快。

六、Windows 與 macOS 最常見的安裝問題

兩個平台的共同問題主要集中在資料夾不完整、架構不相符、執行環境缺少，以及連接埠設定不一致。Windows 也容易受到受保護資料夾寫入、防火牆授權與舊程序殘留影響；macOS 則較常見首次開啟權限、登入項目尚未核准，以及退出後系統代理未恢復。

完成安裝後，建議保留一組可重現的基準：Core 類型為 Xray，本機位址為 127.0.0.1，SOCKS 與 HTTP 連接埠分別記錄實際值，至少一個節點能通過命令列測試，系統代理也能手動開啟與恢復。這組基準穩定後，再加入路由分流、區域網路分享或更複雜的規則。

• 更新用戶端前，備份訂閱群組、路由規則與自訂設定。
• 變更連接埠後，同步修改系統代理與所有手動填寫代理的應用程式。
• 節點無法使用時，先切換至同一訂閱中的其他節點，不要立即重新安裝用戶端。
• 訂閱更新失敗與節點連線失敗是兩條不同的鏈路，應分別查看錯誤。
• 退出程式前恢復系統代理，避免留下指向本機空連接埠的網路設定。