初次設定 v2rayN，建議依序完成「確認系統架構 → 安置程式與設定檔 → 匯入節點 → 確認核心 → 設定系統代理」。本文適合初次使用的 Windows 與 macOS 使用者，特別說明程式能啟動、核心能執行，以及應用程式流量確實經過代理是三件不同的事。先用瀏覽器測試連線，再考慮 TUN 與複雜的分流設定。
一、下載前確認平台、架構與執行環境
v2rayN 是用來管理節點、訂閱與路由規則的桌面用戶端，真正建立代理連線的是核心。下載並開啟圖形介面，不代表已有可用節點；介面能開啟，也不代表隨附的核心已正常啟動。首次安裝時，請先確認作業系統與處理器架構相符，再查看所選安裝包是否包含執行環境與核心。
Windows 與 macOS 安裝前檢查
Windows
- 前往「設定」→「系統」→「系統資訊」查看「系統類型」，確認是 x64 還是 ARM64。
- 請先完整解壓縮，再啟動主程式；不要直接從壓縮軟體的預覽視窗執行。
- 若系統提示缺少 .NET 執行環境，請依目前版本的發行說明確認所需元件與架構，不要只憑舊教學安裝任意版本。
macOS
- 在蘋果選單的「關於這台 Mac」查看晶片資訊，確認使用 Apple 晶片或 Intel 處理器。
- 依安裝包說明解壓縮，或將應用程式移至「應用程式」資料夾；不要長期從暫存的掛載位置執行。
- 若系統阻止開啟，請先確認下載來源與安裝包是否相符，再查看「系統設定」→「隱私權與安全性」中的具體提示。
兩種平台都應符合各自安裝包的系統需求；執行環境是否隨安裝包提供，請以目前的下載說明為準。
Windows 可將免安裝版資料夾放在目前使用者可寫入的位置，例如 D:\Tools\v2rayN；這只是路徑範例，不代表一定要有 D 槽。請避免放在需要額外權限才能寫入的系統資料夾，也不要頻繁移動正在使用的程式資料夾。macOS 則要留意應用程式本體與使用者設定檔的位置，兩者不一定在同一個資料夾。
二、首次啟動：先匯入節點，再建立連線
第一次開啟 v2rayN 時，先保留預設路由與 DNS 設定，不必同時調整監聽連接埠、啟用虛擬網卡或更換核心。每次只處理一個環節，發生錯誤時才容易判斷問題出在訂閱、節點還是本機設定。以下依常見的中文介面列出操作路徑；不同版本的按鈕位置可能不同，請以實際選單與欄位用途為準。
-
確認資料夾位置
完成解壓縮或放置應用程式後，啟動 v2rayN。確認設定可以儲存，關閉後重新開啟仍然保留；若無法寫入，請先處理資料夾權限。
-
新增訂閱
開啟「訂閱群組」→「訂閱群組設定」，新增群組並填寫備註與完整訂閱網址，然後儲存。沒有訂閱時，可使用「伺服器」→「從剪貼簿匯入分享連結」，但不要把訂閱網址當成單一節點連結匯入。
-
更新清單
在「訂閱群組」選單中，選擇對應的更新訂閱操作。首次尚無可用代理時，先嘗試不透過代理更新；若清單為空，請檢查取得結果與解析提示，不要重複新增相同群組。
-
選擇節點
選取一個節點，從右鍵選單選擇「設為活動伺服器」。查看活動標記與記錄，確認核心啟動時沒有錯誤；只反白某一列，不一定代表已切換活動節點。
-
設定代理
在底部狀態列或系統匣選單的「系統代理」中，選擇「自動設定系統代理」。接著用會遵循系統代理設定的瀏覽器開啟已知可連線的 HTTPS 網頁，並搭配記錄確認請求是否進入核心。
訂閱網址通常包含存取憑證，應如同帳戶資訊妥善保護。排查問題時可以提供狀態碼、錯誤訊息與協定類型，但不要在公開討論區張貼完整訂閱網址、節點密碼或 UUID。如需更多匯入說明，請參閱v2rayN 匯入教學。
三、選擇核心：依協定與安全層搭配
V2Ray、V2Fly 與 Xray 並不是 v2rayN 介面的不同外觀。用戶端會將節點參數轉換為核心設定，而核心則決定支援哪些協定、傳輸方式與安全層組合。Project V、V2Fly 與 Xray 的技術文件有助於理解這些欄位，但實際是否可用，仍須視本機核心版本與用戶端的相容情況而定。
| 節點類型或狀況 | 優先檢查項目 | 注意區分 |
|---|---|---|
| VMess 節點 | UUID、傳輸類型、TLS、路徑，以及系統時間是否正確 | 支援 VMess 不代表所有傳輸組合都能自動相容 |
| VLESS + REALITY | 使用支援該組合的 Xray 核心，並核對 publicKey、shortId、serverName 等伺服器端要求的欄位 | REALITY 是安全層機制，不是獨立的出站協定 |
| 出現未知欄位提示 | 檢查訂閱格式、用戶端轉換結果，以及核心是否支援該欄位 | 更新訂閱不會自動補上核心缺少的功能 |
| 核心立即結束 | 先檢查設定解析、可執行檔路徑、權限與監聽連接埠錯誤 | 核心尚未啟動時，切換系統代理模式無法修復連線 |
需要確認時，可先開啟「設定」→「參數設定」，尋找目前版本提供的核心選擇項目。部分版本會將「Core 類型」放在獨立頁面，或依協定個別設定；並非所有版本都有統一的全域切換開關。不要只看舊版介面截圖，硬找已移動的欄位。
- 已有明確的設定說明：優先依照節點提供者標示的核心與參數需求設定。
- 匯入後欄位遺失：先確認目前用戶端能否識別分享連結與訂閱格式，不要只修改協定名稱。
- 剛更換核心：重新啟動連線並查看記錄，確認載入的是新檔案，而不是仍在執行的舊程序。
四、系統代理、路由分流與 TUN 的適用範圍
「已開啟系統代理」只代表作業系統的代理設定已變更，不保證每個程式都會使用代理。瀏覽器通常會遵循系統設定，但某些命令列工具、遊戲或自行管理網路連線的程式不會。初次設定時，先用會遵循系統代理的應用程式測試，再判斷其他程式是否需要個別指定代理位址。
| 設定項目 | 用途 | 首次設定建議 |
|---|---|---|
| 自動設定系統代理 | 讓遵循系統代理的程式連線至本機代理入口 | 先透過此入口測試瀏覽器連線 |
| 路由分流 | 決定已進入核心的請求要經過代理、直接連線或封鎖 | 先使用預設規則，確認連線正常後再逐項調整 |
| TUN 模式 | 透過虛擬網卡與系統路由接管更多流量 | 基本連線正常後，再檢查權限、路由與 DNS 設定 |
不要把「全域代理」當成單一通用的技術開關。路由規則中的「全部走代理」，通常只會影響已進入核心的流量，無法強迫未使用系統代理的程式自動接入。TUN 的接管範圍較廣，但也會受到路由排除項目與平台實作方式影響，不建議列為首次啟動的必要設定。
五、本機連接埠：分清監聽位址與伺服器連接埠
本機監聽連接埠是瀏覽器或其他程式連接 v2rayN 的入口；伺服器連接埠則屬於遠端節點。修改本機連接埠無法修復遠端拒絕連線的問題。請查看「設定」→「參數設定」中的本機監聽設定，並核對主畫面顯示的連接埠；不要將教學範例視為目前版本固定的預設值。
假設目前的 HTTP 或混合代理入口確實監聽在 127.0.0.1:10808，應用程式的 HTTP 代理位址才可填入此位址。若該連接埠只提供 SOCKS 服務，必須在應用程式中選擇 SOCKS 類型。部分版本提供混合入口，其他設定則會分開監聽，請以實際的入站類型為準。
- 連接埠已被占用：若記錄出現
address already in use或繫結失敗，請先確認是否重複執行 v2rayN，再檢查其他程式是否占用了相同的監聽位址與連接埠。 - 僅供本機使用：通常保留迴圈位址監聽較合適。
127.0.0.1指向目前裝置，若在手機上填入此位址，只會連線到手機本身。 - 區域網路存取：允許區域網路連線會擴大對外暴露範圍，也須考量防火牆與存取控制；首次安裝不建議為了方便測試而直接開放。
- 變更連接埠後：重新啟動連線，並同步更新手動設定代理的應用程式。也應重新套用系統代理入口，避免繼續使用舊連接埠。
六、常見問題：依啟動、訂閱與連線階段排查
排查問題時，先記下故障發生在哪個階段：程式無法開啟、無法取得訂閱、核心無法啟動，還是只有某個應用程式無法連線。保留目前的節點與設定，每次只變更一項。測速結果僅供參考，不能取代實際請求與記錄；節點顯示名稱或出現在清單中，也不代表伺服器目前可用。
視窗剛出現就關閉，需要先重新安裝嗎？
先檢查下載包的平台與架構是否相符、是否已完整解壓縮，以及啟動時出現的系統錯誤提示。Windows 若明確提示缺少執行環境，請依發行說明補上相應元件；macOS 則先查看應用程式安全性提示。若尚未備份設定，請勿反覆覆蓋資料夾。
訂閱更新逾時，該勾選「透過代理」嗎？
只有在已有可用節點時，透過代理更新才可能有助於連線至訂閱網址。首次使用時清單為空且沒有可用連線，啟用此選項仍可能逾時。請先確認網址完整且訂閱仍有效，再判斷是網路請求失敗還是內容解析失敗。
已選取節點，瀏覽器還是無法開啟網頁？
確認節點已設為活動伺服器，且記錄中沒有核心結束或連接埠繫結錯誤；接著重新套用「自動設定系統代理」。若記錄中沒有瀏覽器請求，請優先檢查代理入口；若已有請求但連線失敗，再核對節點參數、遠端連線狀況與 DNS 錯誤。
瀏覽器可以連線，其他程式為什麼不行？
先確認該程式是否會遵循系統代理。支援手動設定代理的程式，可填入實際的本機位址、連接埠與協定類型；確實需要接管其他流量時，再考慮使用 TUN。不要直接關閉防火牆，因為未經代理的請求不一定與防火牆有關。
結束程式後，一般網頁也無法開啟？
重新開啟 v2rayN，在「系統代理」中選擇「清除系統代理」，再正常結束程式。Windows 可查看「設定」→「網路和網際網路」→「Proxy」；macOS 可查看「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」。由組織管理的裝置，請勿擅自刪除組織設定。
七、初始設定完成後的檢查清單
基本連線穩定後，再加入自訂路由、DNS 策略與 TUN。之後每新增一項功能，都重新檢查瀏覽器、常用程式，以及結束程式後網路能否恢復。升級前請備份訂閱群組與自訂規則；備份可能包含憑證，應存放在受保護的位置，不要當作截圖附件公開分享。
- 程式與核心都能正常啟動，重新啟動用戶端後設定仍保留。
- 活動節點清楚，協定、傳輸方式與安全層參數均符合伺服器需求。
- 至少有一個會遵循系統代理的瀏覽器，已完成實際網頁連線測試。
- 已核對本機監聽位址、連接埠與入站類型，且未在無意間開放區域網路入口。
- 知道如何清除系統代理，結束程式後一般網路連線可以恢復。
若要從頭確認設定流程，請先參閱用戶端設定教學；遇到訂閱格式問題，可查看訂閱轉換與相容性說明。先找出故障所在的階段，再決定是否更換設定，通常比一次重設所有選項更容易釐清原因。