初次設定先完成四件事：選對系統與處理器架構的安裝包、確認核心能正常啟動、匯入有效訂閱，並透過明確指定代理的請求測試連線。Windows 與 macOS 的主要差異在啟動方式、執行環境和系統權限。本文依實際操作順序說明，適合剛解壓縮程式、介面能開啟卻無法連網的使用者；確認連線正常後，再設定路由與開機啟動。
一、選擇安裝包：系統、架構與執行環境
v2rayN 是桌面用戶端介面，實際連線由它呼叫的核心處理。看得到主視窗，不代表核心已正常執行。下載時要一併確認作業平台、處理器架構，以及安裝包是否包含所需執行環境與核心，不能只看檔名裡有沒有 v2rayN。
符合裝置需求的完整安裝包
建議初次使用建議優先下載頁面標示包含所需元件的完整安裝包。Windows 分為傳統 WPF 介面與跨平台介面；macOS 請選擇對應平台的跨平台安裝包，Windows 執行檔無法在 macOS 上執行。
適合：初次安裝，或想省去手動補齊元件的使用者。
依賴外部執行環境的安裝包
只有在清楚知道缺少哪些相依元件時才選用。若啟動時提示缺少 .NET，請依該安裝包的說明安裝相符的執行環境；Windows WPF 介面通常需要對應的 .NET Desktop Runtime，而非一般執行階段。
適合：已設定執行環境，且能看懂啟動錯誤訊息的使用者。
Windows 可在「設定」→「系統」→「系統資訊」查看系統類型；macOS 可從蘋果選單→「關於這台 Mac」查看晶片。Intel 裝置通常選 x64，Apple 晶片裝置優先選 arm64。別依瀏覽器名稱猜測架構，也不建議初次安裝就採用轉譯執行。
二、解壓縮與初次啟動：先固定安裝位置
Windows 免安裝版請完整解壓縮至目前使用者可寫入、路徑穩定的資料夾，例如 C:\Tools\v2rayN。不要直接在壓縮軟體裡雙擊主程式，也不要只解出單一執行檔；核心、資源和設定資料夾都必須保留原有相對位置。一般使用不必先授予系統管理員權限，涉及 TUN 或系統層級操作時，再依提示授權。
兩種系統的啟動準備
Windows
- 完整解壓縮後，從安裝包資料夾執行主程式，避免放在暫存解壓縮資料夾中。
- 若出現執行環境提示，記下所需名稱與架構，再安裝缺少的相依元件。
- 啟動失敗時查看安全軟體的紀錄，確認核心是否遭到封鎖，不要直接關閉所有防護功能。
macOS
- 先將應用程式移至「應用程式」資料夾；其他封裝檔請依內附說明完整解壓縮。
- 初次啟動遭系統封鎖時，先確認應用程式來源，再查看「系統設定」→「隱私權與安全性」中的提示。
- 確認應用程式可信後，才使用系統提供的核准選項；不要全面關閉安全檢查。
先讓程式在固定位置正常啟動，再匯入訂閱並建立登入時啟動項目，避免移動資料夾後捷徑失效。
若 macOS 顯示應用程式已損毀、架構不相容或無法執行，不要把所有錯誤都當成權限問題。先重新確認安裝包類型與解壓縮是否完整，再閱讀系統提示。更換安裝位置或升級前，請使用用戶端提供的匯出功能備份設定；備份可能包含訂閱憑證，請勿任意上傳至公開位置。
三、核心與訂閱：依序完成初始設定
先使用安裝包內支援的核心與預設設定，暫時不要啟用 TUN、複雜分流或多組上游代理。VMess、VLESS 是協定名稱，Xray 是核心名稱，v2rayN 則是管理介面，三者不可混為一談。若節點使用特定傳輸方式或安全參數，所選核心也必須支援。
-
確認核心
前往「設定」→「參數設定」，查看「Core 類型」相關選項；部分介面會將其獨立列為「Core 類型設定」。初次使用請保留安裝包內的設定，確認核心檔案存在，且記錄中沒有「找不到檔案」或啟動失敗等訊息。
-
記下連接埠
前往「設定」→「參數設定」查看本機監聽連接埠與監聽位址，並記下實際值。初次使用請維持回環位址監聽，不要啟用「允許來自區域網路的連線」，避免本機代理意外開放給其他裝置。
-
新增群組
開啟「訂閱群組」→「訂閱群組設定」，使用「新增」或「+」建立群組。填寫可辨識來源的備註，並貼上完整訂閱網址，例如
https://example.com/sub?token=xxxx；此範例無法用來取得伺服器。 -
更新訂閱
儲存後，在「訂閱群組」選單選擇「更新所有訂閱（不透過代理）」。初次設定尚無可用連線時，先使用目前網路；只有直連失敗且已經有可用代理時，才嘗試透過代理更新，以免形成循環依賴。
-
選擇伺服器
從更新後的清單選擇一項，使用右鍵選單中的「設為作用中伺服器」或目前介面上的相應操作。查看紀錄，確認核心已成功啟動後再測試連線。訂閱更新成功只代表清單取得成功，不表示每台伺服器都能連線。
節點參數應由有效訂閱或服務提供者提供，不要自行猜測 VLESS 的公鑰、伺服器名稱或傳輸路徑。若清單空白，先檢查訂閱是否過期、群組篩選條件和更新紀錄；重複新增相同網址通常只會產生重複項目，無法解決連線失敗。
四、本機連接埠與系統代理：分開測試
系統代理會將遵循相關設定的應用程式導向本機監聽連接埠，不會自動代理所有流量。終端機、部分瀏覽器擴充功能，以及使用自有網路堆疊的程式，可能各自採用不同設定。先測試本機入口，再啟用系統代理，比一開始同時修改多處設定更容易找出問題。
這裡的 10808 僅為指令範例，不保證是你使用版本的預設值。請先確認該連接埠提供 SOCKS 或相容的混合入口。Windows PowerShell 請使用 curl.exe，避免命令別名造成差異；macOS「終端機」請使用 curl。以下兩條指令分別在對應系統執行，無須連續執行。
# Windows PowerShell
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/
# macOS 終端機
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/socks5h 代表目標網域交由代理端解析。若收到正常的 HTTP 回應，表示這次明確指定代理的請求已成功；不代表所有網站或應用程式都已透過代理連線。若無法連線至本機連接埠，先確認核心是否正在執行、連接埠是否一致；若本機入口已連線，但遠端交握逾時，再檢查伺服器與傳輸參數。
- 啟用系統代理：在 v2rayN 主介面底部或系統匣選單中開啟「系統代理」→「自動設定系統代理」。不同介面的選項位置可能不同。
- Windows 檢查：前往「設定」→「網路和網際網路」→「Proxy」，確認手動代理指向本機，且連接埠與用戶端的 HTTP 或混合入口一致。
- macOS 檢查：前往「系統設定」→「網路」→目前使用的網路服務→「詳細資訊」→「代理伺服器」。使用 Wi-Fi 或有線網路時，請確認選取的是目前正在使用的網路服務。
- 瀏覽器測試：暫時停用會覆寫代理設定的擴充功能，使用同一個網站測試；若要確認對外 IP，請比較啟用代理前後的結果，並向服務提供者交叉確認。
五、路由、TUN 與開機啟動：連線正常後再設定
系統代理負責將應用程式流量導向何處；路由規則則決定核心收到流量後使用哪個出口，兩者屬於不同層級。選擇類似「繞過中國大陸」的規則後，存取中國大陸網站仍可能直接連線，這是規則預期的結果，不應只根據單一中國大陸網站的出口判斷代理失效。
| 設定項目 | 初次設定建議 | 調整時機 |
|---|---|---|
| 路由規則 | 先使用安裝包內可用的預設規則，並記下目前模式 | 確認基本連線正常後，再針對網域與 IP 新增規則 |
| TUN | 先保持關閉，減少權限與路由變數 | 需要接管不遵循系統代理的應用程式時，再評估是否啟用 |
| 區域網路存取 | 保持關閉，只監聽本機 | 確定要提供其他裝置使用，並設定存取控管後再啟用 |
| 開機啟動 | 先各自測試一次手動啟動與結束程式 | 程式目錄與代理策略穩定後再啟用 |
TUN 涉及虛擬網路介面、路由和 DNS，並不等於「速度更快的系統代理」。請依目前平台與安裝包說明處理權限；啟用後若網路異常，先關閉 TUN 並還原原本的代理狀態，不要同時修改 DNS、路由和訂閱。每次只變更一項，才能找出問題來源。
檢查開機啟動的順序
- Windows 請在「設定」→「參數設定」尋找「開機時自動啟動」；若沒有此選項，可使用系統提供的啟動應用程式設定，不要重複建立多個啟動項目。
- macOS 請前往「系統設定」→「一般」→「登入項目與延伸功能」，檢查登入時開啟的應用程式；不同系統版本可能只顯示「登入項目」。
- 確認啟動後是否會自動啟用系統代理，以及結束程式時是否會清除代理。重新登入一次，確認核心先正常執行，再檢查瀏覽器。
- 正常結束程式前，先選擇「系統代理」→「清除系統代理」，再結束用戶端。若程式異常結束後無法連網，優先檢查系統是否仍指向已關閉的本機連接埠。
六、初次安裝常見問題
視窗能開啟，為什麼仍提示核心啟動失敗？
先查看紀錄中的第一則啟動錯誤。介面與核心是不同的程序，問題可能來自解壓縮不完整、執行檔遭隔離，或連接埠被其他程序占用。先關閉另一個 v2rayN，再完整解壓縮並檢查檔案；不要只憑視窗已開啟就認定代理正在運作。
Windows 提示本機連接埠被占用，該怎麼查？
在終端機執行下方的連接埠查詢指令，查看最後一欄的程序編號，再到工作管理員確認程式名稱。若確實需要更換連接埠，也要同步更新系統代理與手動設定的應用程式；不要任意結束來路不明的系統程序。
訂閱更新成功，為什麼瀏覽器還是無法開啟網頁？
先確認已設為作用中伺服器，再執行明確指定代理的請求。若該請求成功但瀏覽器仍無法連線，優先檢查系統代理、瀏覽器擴充功能及獨立代理設定；若請求也失敗，繼續查看核心紀錄，不要反覆切換開機啟動選項。
結束用戶端後，一般網站也無法開啟？
重新開啟用戶端，選擇「系統代理」→「清除系統代理」。若程式無法啟動，請到系統網路設定中停用先前指向本機連接埠的手動代理；若網路由組織政策管理，請先確認原有設定，不要覆寫組織要求。
# Windows：將連接埠替換為實際監聽值
netstat -ano | findstr :10808
# macOS：查看此 TCP 連接埠的監聽程序
lsof -nP -iTCP:10808 -sTCP:LISTEN排查時只需保留錯誤發生時間、系統架構、安裝包類型和紀錄中的錯誤描述。截圖或分享紀錄前，請遮蔽訂閱網址、存取憑證、使用者識別資訊及伺服器敏感參數。基本連線穩定後，再依實際需求逐項新增分流規則和自動化設定，避免多項設定互相影響，讓原本容易重現的小問題變得難以排查。