適合第一次在 Windows 或 macOS 使用 v2rayN 的讀者。依序完成安裝套件與處理器架構確認、節點匯入、本機監聽、系統代理設定及退出後恢復；以 127.0.0.1:10808 為例檢查連線入口，分辨用戶端未啟動、核心未監聽與遠端連線失敗，最後再設定開機啟動。
一、先確認系統架構與執行方式
v2rayN 是用來管理節點、訂閱與代理設定的桌面用戶端，實際連線則由選用的核心處理。視窗能開啟，不代表核心已啟動；核心正常監聽，也不代表所有應用程式都會自動使用代理。初次安裝時，請分開確認這三件事。
先到安裝套件頁面選擇 Windows 或 macOS，再依處理器架構下載對應套件。Windows 可在「設定」→「系統」→「系統資訊」查看系統類型；macOS 則在蘋果選單→「關於這台 Mac」查看晶片或處理器。Apple 晶片對應 ARM64，Intel Mac 通常對應 x64，請勿混用兩種套件。
| 檢查項目 | Windows | macOS |
|---|---|---|
| 安裝位置 | 完整解壓縮至目前使用者可寫入的固定資料夾 | 以套件形式解壓縮，或將應用程式移至「應用程式」資料夾 |
| 啟動方式 | 解壓縮資料夾中的 v2rayN.exe | 套件內提供的應用程式入口 |
| 保留檔案 | 保留主程式、核心資料夾與相關檔案 | 保留應用程式套件結構及相關檔案 |
| 首次授權 | 先以一般使用者權限執行 | 先完成系統對應用程式來源的確認 |
Windows 請勿直接在壓縮檔預覽視窗中雙擊執行，也不要只複製單一執行檔。若啟動時提示缺少 .NET 執行階段，請依提示安裝對應版本與架構的執行階段；若套件需要 Windows Desktop Runtime，僅安裝一般 .NET Runtime 並無法解決。相依需求會隨發行套件變動，請勿照搬舊教學，固定安裝某個大版本。
二、首次啟動：匯入訂閱並選取節點
以下使用常見桌面介面的選單名稱。不同發行版本可能調整按鈕位置；請先在「說明」→「關於」記下用戶端版本，再依照相同版本的介面尋找設定項目。訂閱網址用來取得節點，不是本機代理網址，也不能直接填入系統的 HTTP 代理欄位。
-
完整啟動
從固定資料夾啟動用戶端，暫時不要啟用 TUN。確認主視窗與記錄區域都能開啟，並避免同時啟動另一個 v2rayN 執行個體。
-
新增訂閱
開啟「訂閱群組」→「訂閱群組設定」，新增群組，填入備註與訂閱網址後儲存。若介面提供「新增」或「+」按鈕，請用來新增同類項目。
-
更新節點
在「訂閱群組」選單中執行「更新所有訂閱（不透過代理）」。若目前網路無法連上訂閱來源，再使用現有可用節點搭配「透過代理」方式更新。
-
設為目前使用
選取匯入的節點，在右鍵選單中選擇「設為目前使用的伺服器」，並查看記錄是否開始載入對應核心。節點出現在清單中，不代表它已啟用。
-
查看啟動記錄
先排除設定解析錯誤、核心檔案缺失與監聽失敗，再測試遠端連線。發生錯誤時，先保留具體錯誤訊息，不要馬上反覆切換所有設定。
三、本機連接埠：先確認監聽，再設定系統代理
在「設定」→「參數設定」中檢查本機監聽相關項目，記下位址、連接埠與協定。部分版本使用混合連接埠，有些介面則分別列出 SOCKS 與 HTTP 入口。以下的 10808、10809 僅供疑難排解參考，請以目前介面與記錄顯示的實際值為準，不能因此認定本機一定開啟了兩個連接埠。
混合監聽範例
- 監聽位址
127.0.0.1- 本機連接埠
10808- 入口協定
- HTTP 與 SOCKS，需由核心設定支援
- 區域網路連線
- 初次設定時保持關閉
混合連接埠可供不同協定使用，但呼叫端仍須選擇正確的代理類型。
分離監聽範例
- 監聽位址
127.0.0.1- SOCKS 入口
10808- HTTP 入口
10809- 系統代理指向
- 實際啟用的 HTTP 入口
只有在記錄確實顯示兩個入口都已監聽時，才使用這組連接埠對應設定。
初次設定只供本機使用，維持回送位址即可。允許區域網路連線會擴大可存取範圍，並非修復本機網頁無法開啟的通用方法。變更連接埠後，應用程式內的手動設定、系統代理與終端機環境變數也要一併修改。
使用系統指令確認連接埠占用狀況
以下兩個指令分別適用於 Windows PowerShell 和 macOS 終端機，只會查詢監聽狀態。沒有結果表示該連接埠目前未監聽；若有結果，請繼續確認所屬程序，不能只憑連接埠存在就判定節點連線正常。
# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
# macOS 終端機
lsof -nP -iTCP:10808 -sTCP:LISTEN四、如何選擇系統代理、PAC 與 TUN
系統代理會決定哪些遵循系統設定的應用程式將請求交給本機入口；用戶端路由則決定這些請求進入核心後使用哪個出站。兩者並非同一個開關。「自動設定系統代理」中的「自動」，通常是指自動寫入代理設定，不代表已啟用 PAC，也不代表所有程式都會被導向代理。
系統代理
建議初次使用時，先在主畫面或系統匣選單的「系統代理」中選擇「自動設定系統代理」。確認瀏覽器遵循系統設定後，再檢查用戶端路由模式。若應用程式有獨立的代理設定，也要另外確認。
適用情境：初次設定、瀏覽器與遵循系統代理的桌面應用程式。
PAC 自動代理指令碼
由指令碼決定符合條件的請求是否交由代理處理，前提是目前版本提供相應選項，且應用程式支援 PAC。指令碼未涵蓋的網址可能會直接連線，不能據此判定遠端節點失效。
適用情境：已有明確 PAC 規則，且希望由應用程式端選擇請求路徑的環境。
TUN 虛擬網卡
透過虛擬網路介面接管流量，通常需要額外權限，並涉及路由與 DNS。請先確認一般代理連線正常，再考慮啟用；切換時也要檢查其他虛擬網卡軟體是否造成衝突。
適用情境：需要接管不遵循系統代理的應用程式，且能處理權限與路由問題的環境。
Windows 可在「設定」→「網路和網際網路」→「Proxy」檢查寫入結果。macOS 可在「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理」確認；有線與無線網路可能是不同服務。若要手動填寫，請檢查 HTTP 和 HTTPS 對應欄位，並使用實際的 HTTP 或混合監聽連接埠。
五、連線驗證：分別檢查入口、節點與 DNS
速度測試或連線檢查只能作為參考，不能取代實際請求。先確認目前使用的節點與核心都已成功啟動，再用明確指定代理的請求驗證連線，最後才檢查瀏覽器。如此可避免把瀏覽器擴充功能或殘留的系統代理設定誤判為節點故障。
- 本機入口：記錄中應顯示監聽成功，不應出現
address already in use或bind失敗。 - 節點設定：檢查伺服器位址、連接埠、協定與傳輸參數。訂閱匯入的 TLS、SNI、WebSocket 路徑等欄位，請勿任意改成其他節點的值。
- 實際請求：使用指定 HTTP 代理的指令進行測試，再比較瀏覽器是否得到相近結果。
- DNS 與路由：若只有部分網域連線失敗，請確認錯誤發生在名稱解析、直連出站還是代理出站，不要立刻更改所有 DNS 設定。
# Windows：範例入口須替換為實際 HTTP 或混合連接埠
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/
# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/此處的 10 代表連線階段的逾時秒數，不是速度指標。收到 HTTP 回應表示這次請求已取得遠端回應；若用戶端路由將目標設為直連，仍不能單憑這點證明遠端代理出站可用，還要同時查看記錄中的出站選擇。若出現 TLS 錯誤，請檢查系統時間、憑證網域與 SNI，而不是直接停用憑證驗證。
六、開機啟動與退出後恢復代理設定
完成一次正常瀏覽後，再到「設定」→「參數設定」尋找開機啟動選項；選項名稱與所在子頁會隨版本而異。Windows 也可在「設定」→「應用程式」→「啟動」檢查現有啟動項目；macOS 則在「系統設定」→「一般」→「登入項目」或「登入項目與延伸功能」檢查。只保留一種啟動方式，避免多個執行個體同時搶占連接埠。
- 先將程式放在長期保留的位置，再設定開機啟動，以免移動資料夾後捷徑失效。
- 重新啟動後，先查看系統匣或選單列是否已有用戶端，再檢查核心記錄與本機連接埠；視窗隱藏不代表程式沒有啟動。
- 退出前，先在「系統代理」中選擇「清除系統代理」，再從用戶端選單正常結束程式。
- 模擬一次退出後的瀏覽器連線。若用戶端已關閉，但代理仍指向
127.0.0.1的舊連接埠，請到系統代理設定中清除該項目。
七、初次安裝常見問題
雙擊後沒有視窗，是不是沒安裝執行階段？
先查看工作管理員或活動監視器，確認是否已有背景執行個體。若提示視窗明確要求安裝執行階段，請依照要求補齊版本與架構；若記錄顯示核心檔案不存在，請重新完整解壓縮適用於該系統的套件。視窗無法開啟與核心缺失是不同問題。
提示 10808 已被占用，該改哪裡？
先使用上方指令查詢監聽程序，並排除重複啟動。不要結束來源不明的系統程序；也可以在「設定」→「參數設定」將本機監聽連接埠改成未占用的連接埠，例如 10818，儲存並重新啟動核心，再同步更新系統代理與應用程式中的舊連接埠。
已選取節點，瀏覽器還是無法開啟網頁？
先執行指定代理的 curl 指令。若指令成功但瀏覽器失敗，請檢查「系統代理」→「自動設定系統代理」、瀏覽器獨立代理設定及相關擴充功能；若指令也失敗，請回頭查看核心記錄中的監聽與遠端連線錯誤。
macOS 一直要求確認權限，需要每次都允許嗎？
先分辨這是首次開啟應用程式的確認、修改系統代理的授權，還是 TUN 網路權限。請將應用程式放在固定資料夾，避免每次都從暫存解壓縮資料夾啟動。若每次修改代理都要求授權，請查閱目前版本的權限設定說明；不要反覆輸入密碼，卻不確認授權請求的來源。
訂閱更新逾時，需要重新安裝嗎？
先確認訂閱網址是否完整且仍有效。若已有可用節點，可嘗試使用「訂閱群組」中的透過代理更新方式；若沒有可用連線，應先處理連往訂閱來源的問題。重新安裝無法修復過期網址，也不會自動補回遭截斷的存取憑證。
初次設定完成的標準是：用戶端能正常啟動、目前使用的節點成功載入、本機入口確實在監聽、應用程式請求依預期進入核心，且退出後系統網路恢復正常。若要進一步調整分流，請閱讀設定參考中的路由與 DNS 說明；日常操作步驟可參閱使用文件。