適合第一次在 Windows 或 macOS 使用 v2rayN 的使用者。先依作業系統與處理器選擇安裝檔，再準備執行環境、匯入訂閱並設定使用中的伺服器，最後確認本機監聽、系統代理與路由。初次測試先使用系統代理，暫時不要啟用 TUN；遇到問題時，依「程式啟動—核心執行—代理連線—流量分流」的順序逐步排查。
選擇安裝檔：桌面版、WPF 與處理器架構
v2rayN 是桌面用戶端，可管理伺服器設定、呼叫代理核心，並提供系統代理等功能。用戶端本身不會附贈可用伺服器。開始前，請先準備有效的訂閱網址或伺服器分享連結；只開啟主視窗，不代表已建立可用連線。
Windows：前往「設定」→「系統」→「關於」，查看「系統類型」；macOS：打開 Apple 選單→「關於這台 Mac」，查看「晶片」或「處理器」。Apple 晶片選 ARM64，Intel 處理器選 x64。Windows ARM 裝置也應核對發行檔說明，別只憑副檔名判斷能否執行。
桌面版
推薦採用跨平台介面。Windows 與 macOS 請分別下載對應系統的版本；設定方式大致相同，但系統權限與代理設定位置不同。本文主要說明這種使用方式。
適合：初次使用，或希望在兩種桌面作業系統間沿用相同操作習慣的使用者。
Windows WPF 版
保留傳統 Windows 介面，僅適用於 Windows。這不是 macOS 安裝檔；介面框架不同，也不代表伺服器協定不同。是否支援某項設定，仍取決於實際呼叫的核心。
適合：熟悉傳統 Windows 介面，並希望繼續使用該介面的使用者。
安裝檔請以下載頁上的最新說明為準。安裝程式、壓縮檔與磁碟映像的處理方式各不相同，不能一概當成「解壓縮後直接執行」。初次使用時，請勿同時啟動兩種介面版本，以免搶用本機連接埠。
Windows 初次啟動：完整資料夾與執行環境
壓縮檔中可能同時包含主程式、核心資料夾與其他相依檔案。若只把主程式拖到桌面，可能會出現視窗能開啟、核心卻無法啟動的情況。使用壓縮檔時，請先完整解壓縮到目前使用者可寫入的固定資料夾，例如 C:\Users\Public\Tools\v2rayN，並確認該資料夾的存取權限符合你的使用需求。
-
解壓縮安裝檔
使用壓縮檔時，先在檔案總管選擇「全部解壓縮」，再開啟解壓後的資料夾；使用安裝程式則依安裝精靈完成操作。請勿直接從壓縮軟體的預覽視窗執行程式。
-
安裝所需執行環境
若啟動時提示缺少 .NET，請記下所需的執行階段類型、主要版本與架構，再透過 Microsoft 官方管道安裝。WPF 版需要相符的 .NET Desktop Runtime；只安裝 SDK 或不同架構的執行階段，未必能解決問題。
-
初次以一般權限啟動
以一般使用者權限開啟主程式，先測試基本代理功能。不要把「以系統管理員身分執行」當成所有錯誤的通用解法；TUN 等功能需要的額外權限，等基本連線正常後再個別處理。
-
確認具有寫入權限
開啟設定並儲存一次，接著正常結束程式，再重新啟動。如果語言或其他選項恢復原狀，請確認設定檔的儲存位置是否可寫入，以及是否不小心啟動了另一份程式。
macOS 初次啟動：應用程式位置與安全性提示
若下載的是 .dmg，開啟磁碟映像後，依照其中說明將應用程式拖到「應用程式」資料夾；若下載的是壓縮檔，請先解壓縮，再將應用程式移至固定位置。安裝完成後，退出磁碟映像並從「應用程式」啟動，避免長期執行映像中的暫存副本。
- 架構不相符：重新查看「關於這台 Mac」中的晶片資訊，再選擇 ARM64 或 x64 版本。啟動失敗時，請勿第一時間修改系統安全性設定。
- 提示開發者無法驗證：請先確認檔案來源。若系統提供「系統設定」→「隱私權與安全性」→「仍要打開」，請確認來源可信後，再依提示授權；不同系統版本的提示位置可能不同。
- 提示應用程式已損毀：不能直接認定只是權限問題。請重新下載符合處理器架構的完整版本，並確認發行說明與系統相容需求；不要批次清除其他應用程式的安全屬性。
- 變更代理設定需要授權：只有在主動變更系統代理時，才確認相關系統提示。程式視窗成功啟動，不代表系統代理也已設定成功；後者還需要確認目前使用的網路服務。
macOS 系統代理是依網路服務設定。切換 Wi-Fi 與有線網路後，請前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理」，查看實際狀態。舊版系統的路徑可能是「系統偏好設定」→「網路」→「進階」。
初次設定：語言、訂閱與使用中的伺服器
介面語言不會影響伺服器協定。若要變更語言，請前往「設定」→「參數設定」尋找語言選項，儲存後依畫面提示重新啟動。不同版本可能將語言選項放在設定選單中；本文使用中文選單名稱，實際操作時請依目前介面尋找名稱相近的選項。
-
新增訂閱群組
開啟「訂閱群組」→「訂閱群組設定」，新增群組並填寫備註與訂閱網址。網址前後不要留空格，並確認複製的是訂閱連結，而不是網站登入網址。
-
更新訂閱
返回「訂閱群組」，執行相應的更新操作。初次設定時若還沒有可用代理，先嘗試不經代理更新；只有在已有可用連線，且直接連線更新失敗時，才改用代理更新。
-
確認匯入結果
確認清單中已出現伺服器，並檢查協定、位址與連接埠是否都有內容。如果收到的是網頁或登入提示，請停止重複匯入，並向服務提供者確認訂閱網址與存取條件。
-
設為使用中的伺服器
在目標伺服器上按右鍵，選擇「設為活動伺服器」，再查看核心記錄檔是否正常啟動。只選取清單中的項目，不一定會切換目前實際使用的伺服器。
若只有一條 vmess:// 或 vless:// 連結，可複製完整內容，再從「伺服器」選單使用「從剪貼簿匯入」。分享連結與訂閱網址是不同的輸入方式：前者通常匯入單一伺服器，後者則用來依群組取得並更新設定。
系統代理與路由：分別完成初次設定
系統代理決定遵循系統代理設定的應用程式如何連上本機監聽；路由規則則決定流量接入後要經由代理、直接連線或封鎖。兩者不能互相取代。初次測試請先使用系統代理並關閉 TUN，以減少權限、虛擬網卡與 DNS 接管帶來的變因。
以下的 10808 是方便對照的示例連接埠，不保證所有版本都以此為預設值。請先前往「設定」→「參數設定」，確認實際的本機監聽類型與連接埠，再核對系統設定。若目前介面分別提供 HTTP 與 SOCKS 連接埠，應依協定分別填寫，不要直接照抄混合監聽的寫法。
確認本機監聽設定
- 監聽位址
127.0.0.1，本機連線範例- 監聽類型
- HTTP/SOCKS 混合監聽，請以目前設定為準
- 示例連接埠
10808- 區域網路連線
- 初次設定時保持關閉
先確認核心確實在該連接埠監聽，再設定要使用它的應用程式；排查問題時不要直接開放所有網路介面。
確認代理連線設定
- 系統代理
- 選擇「自動設定系統代理」
- HTTP 位址
127.0.0.1- HTTP 連接埠
- 須與實際 HTTP 或混合監聽設定一致
- TUN 模式
- 基本測試階段請關閉
系統代理不會接管整台裝置的所有流量；自行直接連線或使用獨立代理設定的應用程式，可能不會遵循系統代理。
Windows 可前往「設定」→「網路和網際網路」→「Proxy」檢查設定是否寫入；macOS 則檢查目前網路服務的代理選項。初次設定時，不要同時啟用手動代理、自動設定指令碼與其他代理程式，以免無法判斷實際生效的是哪一組設定。
- 日常分流：在 v2rayN 的路由選單中選擇符合需求的規則，並前往「設定」→「路由設定」確認詳細規則。模式名稱不能取代規則內容。
- 暫時測試：若懷疑規則讓目標流量直接連線，可暫時切換成將已接入流量交由代理處理的規則，再測試同一目標；完成後請恢復日常分流設定。
- 規則適用範圍：全域代理路由仍只會處理已進入核心的流量，不會自動讓所有應用程式遵循系統代理。
- 調整 DNS：先保留目前合理的設定。只有在記錄檔指出解析失敗，或解析路徑不符合預期時，才依實際使用的核心設定排查 DNS，避免一次修改多個變因。
連線測試：連接埠可用不代表網頁可瀏覽
測試時由近而遠：先確認用戶端主視窗與核心都在執行，再檢查本機連接埠，最後測試代理請求。以下命令假設已確認 HTTP 或混合連接埠為 10808；若實際連接埠不同，請先替換數字。命令中的目標網址僅用來示範請求方式。
Windows：先檢查監聽，再送出請求
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/macOS：明確指定代理
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/明確指定代理參數可避開終端機是否讀取系統代理設定的差異，但仍會受到核心路由規則影響。Windows 的連接埠測試成功，只代表本機有程序接受連線；HTTP 請求收到回應，也只代表該目標依目前規則可連線，不能據此推論所有網站或應用程式都正常。
| 測試結果 | 優先檢查項目 | 下一步 |
|---|---|---|
| 本機連線遭拒 | 核心是否已啟動、連接埠是否一致 | 查看核心記錄檔，確認沒有啟動失敗或連接埠遭占用 |
| 本機連線成功，但請求逾時 | 使用中的伺服器、遠端連線與路由 | 查看同一筆請求對應的記錄，避免只看過去的錯誤訊息 |
| 命令可用，但瀏覽器無法連線 | 瀏覽器是否使用系統代理 | 檢查瀏覽器的個別代理設定，並重新建立連線 |
| 部分網域連線失敗 | 分流規則、DNS 與目標服務狀態 | 使用相同目標重複測試，每次只調整一項設定 |
初次使用常見問題
視窗已開啟，為什麼還是無法上網？
依序確認伺服器已匯入並設為使用中的伺服器，核心也已成功啟動；接著查看「系統代理」是否已選擇「自動設定系統代理」。若明確指定代理的命令可以連線，但瀏覽器不行，請先檢查瀏覽器的連線方式，不要立刻更換伺服器協定。
提示連接埠遭占用，需要全部更換嗎？
先結束另一個 v2rayN 或仍在執行的核心程序。Windows 可執行 netstat -ano | findstr :10808 查看監聽狀況，再到工作管理員確認對應的 PID；不要結束不熟悉的系統程序。若確實需要更改連接埠，也要同步更新使用代理的應用程式設定。
訂閱第一次更新就逾時，該怎麼辦？
先檢查網址是否完整、訂閱是否仍有效，以及系統日期與時間是否正確。尚無可用代理時，不要反覆選擇「透過代理更新」；已有可用伺服器且直接連線失敗時，再嘗試此方式。其他情況請參閱訂閱更新疑難排解。
結束用戶端後，網頁反而無法開啟？
先重新開啟用戶端，在「系統代理」中選擇「清除系統代理」，再正常結束程式。若程式異常結束，請前往系統代理設定頁面，清除這次設定留下的本機位址；若公司網路原本就有代理或指令碼，請先記錄設定，不要任意刪除。
一開始就需要啟用 TUN 嗎？
不需要。先用瀏覽器與明確指定代理的命令確認基本連線。只有在應用程式不遵循系統代理，且確實需要接管流量時，才另外設定 TUN，並檢查權限、路由與 DNS。啟用後，請重新測試原本可用的請求；TUN 不是連線失敗時必須採用的修復方式。
完成初次設定後的收尾步驟
初次設定完成與否，不是看圖示有沒有變色，而是確認使用中的伺服器正確、核心沒有啟動錯誤、目標請求依預期路由，而且正常結束程式後本機網路能恢復。先保留這組最精簡可用的設定，再逐步加入開機啟動、更多規則或 TUN 功能；若發生問題，也比較容易還原。