先選版本：桌面版、經典版與處理器架構
安裝 v2rayN 的第一步不是匯入訂閱，而是確認作業系統、處理器架構與介面版本。選錯安裝套件時，常見結果包括程式無法啟動、系統提示應用程式不相容，或核心程序啟動後立即退出。請先在系統資訊中確認裝置類型，再前往下載中心選擇相符的檔案。
Windows 如何選擇
近年生產的大多數 Windows 電腦使用 x64 架構，應選擇 Windows x64 安裝套件。使用 ARM 處理器的裝置請選擇 arm64。只有在明確執行 32 位元系統時才考慮 x86 套件；如果系統設定顯示「64 位元作業系統，基於 x64 的處理器」，就不要下載 x86 版本。
v2rayN 桌面版採用面向多平台的介面，Windows 與 macOS 的主要操作流程相近，適合需要在兩套桌面系統間維持相似使用方式的使用者。經典版主要面向 Windows，選單結構、系統匣操作與伺服器清單管理方式沿用已久，適合已熟悉原有操作流程的使用者。兩者都能完成訂閱匯入、節點選擇、系統代理與路由分流，但設定名稱與選單位置可能隨版本調整。
macOS 如何選擇
在 macOS 中開啟「關於這台 Mac」或「系統資訊」，先確認處理器類型。Apple 晶片裝置選擇 arm64，Intel 處理器裝置選擇 x64。架構不相符時，即使系統能透過相容機制嘗試執行，也可能增加核心呼叫、系統匣顯示與更新過程中的排查成本；首次安裝應直接使用原生架構套件。
從舊版遷移到新版時，建議重新匯入訂閱，不要直接覆蓋整套程式檔案。舊設定可能儲存了不同的核心路徑、本機連接埠、路由規則與介面欄位，整包覆蓋容易一併帶入失效設定。需要保留自訂規則時，可以先記錄規則內容、監聽連接埠與訂閱分組，再於新版本中逐項還原。
安裝前準備：檔案位置、執行權限與網路狀態
Windows 經典版可能以壓縮檔形式提供。解壓縮後再執行主程式，不要直接在壓縮檔預覽視窗中啟動。程式需要在自己的資料夾中讀取核心、設定與執行資料；從暫存預覽位置啟動，容易出現找不到核心檔案、設定無法儲存，或更新後檔案散落等問題。
程式資料夾應放在目前帳戶具備讀寫權限的位置。路徑可以使用英文或中文，但不宜放入會被頻繁清理的暫存資料夾。Windows 首次設定時通常不需要長期以系統管理員身分執行。只有啟用需要系統層級權限的網路功能，或系統安全性原則明確攔截寫入時，才依提示處理權限。
macOS 下載完成後，請將應用程式移至「應用程式」資料夾再啟動。系統首次開啟從網路取得的應用程式時，可能要求確認來源；可在系統設定的隱私權與安全性頁面查看目前遭攔截的原因。確認檔案來自本站下載中心後，依系統提供的允許步驟操作。不要反覆移動應用程式位置，否則系統可能重新記錄權限，導致開機啟動或網路權限需要再次確認。
首次啟動前還要檢查三項基本狀態：
- 系統日期、時間與時區保持正確。時間偏差會影響依賴 TLS 的連線。
- 目前網路可以正常存取區域網路與常用直連網站，避免將基本斷網誤判為節點故障。
- 退出目前占用本機代理連接埠的舊執行個體，尤其是先前執行過的 v2rayN 程序。
首次啟動：先檢查核心，再設定本機連接埠
v2rayN 是圖形化用戶端，真正處理 VMess、VLESS、Trojan 或 Shadowsocks 連線的是所選核心。常見設定會使用 Xray 核心，也可以依照版本提供的選項使用 V2Ray 核心。用戶端負責管理設定、呼叫核心、切換系統代理與顯示執行記錄。介面能開啟，不代表核心已成功執行。
首次啟動後，先進入設定頁面查看核心類型與核心路徑。如果版本提供核心檢查或版本資訊功能，應先執行一次。記錄中出現核心版本、監聽位址與啟動完成資訊，表示程式已進入可接收本機連線的狀態。如果記錄提示找不到可執行檔，請重新檢查安裝套件是否完整解壓縮、處理器架構是否正確，以及安全性設定是否阻止核心啟動。
接著確認本機監聽連接埠。不同版本可能提供 SOCKS、HTTP 或混合連接埠，介面預設值也可能不同。新手可以保留目前版本提供的預設設定，不必為了照搬舊教學而強行改成某個固定數字。真正需要記錄的是「目前實際連接埠」，因為瀏覽器手動代理、開發工具與連接埠排查指令都必須與它一致。
本機監聽位址通常保持為回送位址，僅供本機程式連線。除非明確需要讓區域網路中的其他裝置接入，否則不要開啟允許來自區域網路的連線。開放區域網路監聽後，還需要同時考慮系統防火牆、網路環境與存取控制，這不是首次安裝的必要步驟。
記錄中應注意哪些欄位
address already in use：本機連接埠已被其他程序占用。connection refused：目標位址拒絕連線，可能是伺服器未監聽或連接埠填寫錯誤。timeout：連線未能在規定時間內完成，需要區分本機網路、伺服器狀態與路由路徑。failed to parse：設定內容無法解析，常見於訂閱轉換異常或手動參數格式錯誤。- 憑證名稱或握手相關錯誤：重點核對伺服器位址、SNI、傳輸方式與安全性層參數。
不要只看伺服器清單中的延遲數字。延遲測試可能使用不同的探測方式，能回傳延遲不代表目標網站一定可以存取；反過來，某些伺服器不回應特定探測，但實際代理連線仍可能正常。判斷設定是否可用，應以核心記錄、實際連線測試與訂閱參數是否完整為準。
匯入訂閱：更新、分組與節點選擇
取得訂閱網址後，在訂閱分組管理中新增一筆記錄。名稱用於本機識別，可以填寫服務用途或線路類別；網址必須完整複製，避免前後混入空格或換行。儲存後執行訂閱更新，伺服器清單出現設定才算完成匯入。只儲存訂閱網址而不執行更新，不會自動產生節點。
訂閱更新失敗時，先檢查網址是否已過期、目前網路是否能存取訂閱伺服器，再查看更新記錄。不要連續建立多筆相同訂閱。重複分組會產生同名節點，使後續判斷目前設定來源變得困難。更新後的節點數量與服務端發布內容有關，不應透過反覆點擊更新來增加。
選擇節點時，應重點核對協議與參數是否完整。VMess 設定通常包括使用者識別碼、傳輸方式與安全性設定；VLESS 還可能依賴 TLS、Reality、SNI、指紋或流控參數；Trojan 需要正確的密碼與安全性層資訊；Shadowsocks 需要相符的加密方式與密碼。v2rayN 會依訂閱內容產生設定，一般使用者不應在不了解服務端設定的情況下任意修改這些欄位。
選取節點後，需要將它設為目前使用的伺服器。清單中反白某一列不一定代表已完成切換；應查看狀態列、系統匣選單或記錄中的目前伺服器資訊。切換後核心通常會重新載入設定，短時間內既有連線可能中斷，這是重新載入設定的正常結果。
系統代理模式：為什麼節點可用但瀏覽器沒有使用代理
核心啟動後，只是在本機開放代理入口。應用程式是否經過該入口，取決於系統代理、應用程式本身的代理設定或其他接管方式。首次安裝最常見的問題是伺服器測試正常、記錄也顯示核心正在執行，但瀏覽器仍然直連。原因通常不是協議錯誤，而是系統代理尚未啟用。
在 v2rayN 中選擇「設定系統代理」後，用戶端會將目前的本機代理位址寫入作業系統。大多數遵循系統代理的瀏覽器與桌面程式會讀取這項設定。設定完成後，請先關閉並重新開啟瀏覽器進行測試；部分已啟動的程式只會在啟動時讀取代理狀態，不會立即回應系統設定變更。
系統代理常見模式可以依照以下邏輯理解：
- 清除系統代理：移除 v2rayN 寫入的代理設定，應用程式恢復依照系統原有網路方式連線。
- 自動設定或規則模式：系統依據設定指令碼或規則，決定哪些請求交由本機代理處理。
- 全域代理：遵循系統代理的請求會統一進入 v2rayN，再由核心路由決定最終出口。
「系統代理規則」與「核心路由規則」不是同一層。系統代理決定流量是否進入 v2rayN，核心路由決定已進入的流量要走代理、直連還是阻擋。某個應用程式完全不讀取系統代理時，修改核心路由不會讓它自動進入代理。此時應先查看該應用程式是否提供獨立的 HTTP 或 SOCKS 代理設定。
macOS 可在系統網路設定的代理頁面核對目前服務是否寫入 HTTP、HTTPS 或 SOCKS 項目。Windows 可在系統代理設定中確認位址與連接埠。手動檢查時，連接埠必須與 v2rayN 目前的監聽值一致。若系統頁面仍保留舊連接埠，應先在 v2rayN 中清除系統代理，再重新設定。
路由分流：先使用預設，再處理自訂規則
路由分流用於決定進入核心後的連線出口。首次使用不建議立即堆疊大量自訂網域與 IP 規則。先選擇版本提供的基本預設，確認代理連線與直連都能正常運作，再依實際需求新增規則。如此一來發生異常時，便能明確判斷問題來自伺服器、系統代理還是路由規則。
規則通常會依序比對，前面的規則可能先於後面的規則生效。網域規則用於比對請求中的網域，IP 規則用於比對解析後的位址，程序規則則取決於用戶端與作業系統是否支援相應的識別方式。修改規則後應重新載入設定，並透過記錄確認實際命中了哪一條規則。
DNS 也會影響分流結果。如果規則依賴網域，但應用程式提前將網域解析為 IP，再把純 IP 連線交給代理，核心可能無法取得原始網域。反過來，DNS 請求與實際連線使用不同出口時，也可能取得不適合目前線路的位址。首次設定階段應保持 DNS 方案簡單，等基本連線穩定後，再設定中國大陸與境外網域分組、遠端解析或更細緻的防污染規則。
不要把「全域代理」理解為所有裝置的流量必然全部經過伺服器。只設定系統代理時，仍可能有應用程式繞過系統代理；區域網路中的其他裝置也不會自動接入。需要接管更多類型的流量時，可以研究用戶端提供的 TUN 功能，但這涉及虛擬網卡、系統權限、DNS 接管與路由表變更，不適合作為首次安裝的第一步。
常見故障一：系統代理未生效
系統代理未生效時，可以依固定順序排查，避免同時修改多個選項。
- 確認 v2rayN 主程式仍在執行，並可在系統匣中找到圖示。
- 查看核心記錄，確認本機監聽已成功建立。
- 確認目前伺服器已設為使用中的伺服器，而不是只在清單中被選取。
- 在系統設定中檢查代理位址是否為本機位址，連接埠是否與用戶端一致。
- 重新啟動要測試的瀏覽器或應用程式，排除舊程序快取代理設定的影響。
- 暫時使用基本路由預設，排除自訂規則將目標錯誤分配到直連或阻擋出口。
如果只有某一個應用程式未生效，而瀏覽器可以正常透過代理存取，應優先檢查該應用程式本身的網路設定。有些程式使用獨立代理，有些只支援 HTTP 代理，還有些完全忽略系統代理。此時將 v2rayN 的本機位址與對應協議連接埠複製到應用程式設定中，比反覆切換伺服器更有效。
如果所有應用程式都無法連線，但關閉系統代理後直連恢復，應查看核心是否已退出。系統代理只是將請求傳送到本機連接埠，本機沒有程序監聽時，通常會表現為網頁立即顯示連線失敗。重新啟動核心後仍然失敗，再檢查連接埠占用與設定解析錯誤。
常見故障二：連接埠占用與重複程序
連接埠占用常見於舊版 v2rayN 未完全退出、程式當機後核心程序仍在背景執行，或其他網路工具使用了相同連接埠。記錄中的 address already in use 是直接訊號。處理時不要連續啟動多個用戶端執行個體，應先找出正在監聽該連接埠的程序。
Windows 可以在 PowerShell 中檢查範例連接埠 10808。如果實際設定不是這個連接埠，請將指令中的數字改為目前值：
Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess取得程序編號後，可在工作管理員的「詳細資料」中核對程序名稱。確認是殘留的 v2rayN 或核心程序後，先從用戶端選單正常退出；只有在介面已無法操作時，才結束對應程序。不要在未核對名稱的情況下批次結束系統程序。
macOS 可以在終端機檢查同一個範例連接埠：
lsof -nP -iTCP:10808 -sTCP:LISTEN如果連接埠被另一項明確需要保留的服務占用，可以在 v2rayN 中更換本機監聽連接埠。修改後要同步檢查系統代理與使用手動代理的應用程式。只修改用戶端連接埠而不更新應用程式連接埠，會造成核心執行正常但應用程式無法連線。
重複程序也可能來自開機啟動。新版與舊版同時設定自動啟動時，登入系統後會先後搶占同一個連接埠。完成遷移後，只保留目前使用版本的開機啟動項目，並確認舊程式已退出。Windows 可檢查啟動應用程式清單，macOS 可檢查登入項目與背景延伸功能。
常見故障三：訂閱更新成功但節點無法連線
訂閱更新成功只代表用戶端取得並解析了訂閱內容，不代表每台伺服器都在線上。節點無法連線時，先切換同一訂閱中的另一筆設定。如果多筆設定同時逾時，再檢查本機網路、訂閱有效狀態與服務端通知；如果只有單筆失敗，應重點查看該節點的位址、連接埠與協議參數。
手動修改訂閱節點後，下次更新可能會被服務端內容覆蓋。需要臨時測試時，可以複製一份設定再修改，並保留原始訂閱節點作為對照。不要混用不同節點的 SNI、傳輸路徑、使用者識別碼或 Reality 參數，這些欄位必須與對應服務端保持一致。
協議選擇應依照訂閱內容。用戶端支援某種協議，不代表現有伺服器可以任意切換至該協議。VMess、VLESS、Trojan 與 Shadowsocks 的驗證及傳輸參數不同，不能只修改協議名稱完成轉換。一般使用者應直接使用訂閱下發的完整設定。
安裝完成後的穩定使用清單
完成首次設定後，建議保留一套可重現的基本狀態：一個能正常更新的訂閱分組、一台已驗證的伺服器、預設本機連接埠、基本路由預設，以及清楚的系統代理狀態。日後遇到問題時，先回到這套狀態，再逐項還原自訂設定。
- 更新用戶端前記錄目前版本、核心類型、本機連接埠與路由預設。
- 訂閱更新後確認目前使用的伺服器是否仍然存在。
- 切換網路後重新進行一次實際連線測試，不要只依賴舊的延遲結果。
- 退出用戶端時確認系統代理已還原至預期狀態。
- 遇到故障時先儲存相關時段的記錄，再重新啟動程式，避免關鍵錯誤訊息被覆蓋。
- 自訂規則一次只修改一組，修改後重新載入並驗證比對結果。
Windows 與 macOS 的介面位置不同，但排查邏輯相同：先確認用戶端程序，再確認核心程序；先確認本機連接埠，再確認系統代理；先驗證訂閱參數，再檢查路由與 DNS。依照這個順序操作，可以將「程式無法開啟」、「節點無法連線」與「瀏覽器未使用代理」拆分為獨立問題，避免在多個設定頁面之間反覆試錯。