V2Ray 全平台安裝與設定指南

準備工作與設定層次

先確認系統、架構與用戶端

安裝前先確認作業系統與處理器架構，再選擇下載項目。Windows 可在「設定 → 系統 → 系統資訊」查看系統類型；macOS 可從蘋果選單的「關於這台 Mac」查看晶片資訊；Linux 請查看系統設定中的裝置資訊；Android 則在裝置資訊中確認系統版本，並參考裝置規格判斷架構。不要根據安裝檔大小推測是否適用，也別因作業系統名稱相同，就認定架構相同。

桌面平台建議優先使用 v2rayN。三種桌面系統的設定概念相近，但權限、系統代理及安裝檔格式各有差異。Android 可優先考慮採用 Xray 核心的 v2rayNG；若現有設定明確依賴 V2Fly 的行為，再考慮 v2flyNG。圖形介面用戶端負責管理伺服器、訂閱及系統流量入口，核心則負責處理連線；介面能啟動，不代表核心已成功執行。

準備訂閱網址與還原紀錄

用戶端本身不提供伺服器。開始設定前，請準備有權使用的訂閱網址或單一分享連結，確認服務仍在有效期限內，並了解服務提供者要求的協定與傳輸參數。訂閱網址通常包含存取憑證，應視同密碼妥善保管。分享截圖、日誌或求助內容時，務必隱藏完整網址，尤其不要只遮住開頭而留下查詢參數。

若已有用戶端設定，請先記下目前使用的伺服器、訂閱群組、本機監聽連接埠、路由模式與 DNS 設定。需要移轉時，使用用戶端提供的匯出或備份功能，並將備份存放在受控目錄。也應記錄作業系統代理設定的原始值：裝置可能原本就設有公司網路代理，直接清除可能影響原有工作環境。

釐清四個容易混淆的環節

第一層是取得訂閱：用戶端能否從訂閱網址讀取伺服器資料。第二層是核心啟動：本機連接埠是否成功監聽。第三層是流量進入：應用程式是否將要求交給系統代理、手動代理或 TUN。第四層是選擇出站：進入核心的連線依路由規則直連、代理或封鎖。排查時請逐層檢查，不要把所有異常都歸咎於伺服器失效。

系統代理主要影響遵循作業系統代理設定的應用程式；有些程式使用獨立網路堆疊，需要另外填寫代理網址。TUN 透過虛擬網路介面接收更多流量，但需要權限、路由與 DNS 相互配合。路由中的「全域代理」通常只會改變已進入用戶端的流量如何出站，不會自動讓略過系統代理的程式改用代理連線。

初次設定建議只啟用一種流量入口，先使用系統代理測試瀏覽器連線，再考慮啟用 TUN。暫時關閉其他會修改代理、虛擬網卡或網路路由的軟體，避免多個工具同時寫入系統設定。每次只修改一項設定，並保留修改前後的日誌；確認正常後，再新增自動更新、應用程式分流等功能。

操作前也請確認系統時間正確、磁碟可寫入，且安裝目錄有足夠空間。憑證驗證需要正確時間，儲存設定需要目錄權限，核心啟動則需要執行檔完整解壓。先處理這些基本條件，比安裝後反覆切換協定更有效。若想依最短流程操作，請前往入門指南；若要了解各平台的限制，請繼續閱讀以下章節。

Windows：v2rayN 安裝與代理設定

選擇桌面版或傳統 WPF 版

在Windows 下載頁面選擇 v2rayN。桌面版採用跨平台介面，傳統 WPF 版則使用 Windows 桌面介面；兩者的選單配置可能不同，但設定目標一致。請依下載頁標示的作業系統與架構需求選擇，不要因為名稱都有 v2rayN，就將兩套檔案解壓到同一個目錄，也不要混用各自產生的程式元件。

使用安裝程式時，依照安裝精靈完成安裝，再從開始選單啟動。若使用壓縮檔，請先完整解壓到可長期保存且目前帳戶可寫入的目錄，再執行主程式。不要直接從壓縮檔預覽視窗啟動，也不要只抽出主程式而漏掉旁邊的相依檔案。路徑盡量簡短，避開同步磁碟、暫存下載目錄及需要額外授權的系統目錄。

初次啟動若提示缺少執行環境，請依提示確認所需元件與架構，再透過系統認可的管道安裝。若視窗閃退，先查看安全軟體的隔離紀錄、系統事件與用戶端日誌，不要直接關閉所有安全防護。一般系統代理通常不需要系統管理員權限；只有啟用需要系統層級操作的功能時，才依用戶端提示提高權限。

建立訂閱群組並啟動伺服器

開啟「訂閱群組設定」，新增群組並填寫容易辨識的名稱，將完整訂閱連結填入「網址（url）」，儲存後執行該群組的「更新訂閱」。初次設定時沒有可用代理，通常先選擇不透過代理更新；若網址必須透過既有連線存取，請先確認該連線可用，再選擇透過代理更新，以免形成啟動依賴循環。

更新後先確認清單屬於剛才建立的群組，再選擇一個伺服器並設為目前使用項目。查看日誌是否出現設定解析、核心啟動或連接埠占用錯誤。延遲測試只能輔助篩選：測試方式可能與實際應用程式的連線方式不同，最後仍應透過瀏覽器和日誌確認。不要因一次測試失敗，就認定訂閱匯入失敗。

設定系統代理，並視需要啟用 TUN

在工作列通知區域開啟 v2rayN 選單，找到「系統代理」，選擇「自動設定系統代理」等會寫入系統代理設定的選項。若通知區域沒有顯示圖示，請查看隱藏圖示區域。接著開啟 Windows「設定 → 網路和網際網路 → Proxy」，核對用戶端寫入的本機網址與連接埠。設定名稱可能隨系統介面調整，核對網址和連接埠才是重點。

「清除系統代理」會撤銷用戶端設定；「不變更系統代理」則表示不主動修改目前值，兩者並不相同。使用手動代理的應用程式，必須填寫用戶端實際監聽的協定與連接埠，不能把遠端伺服器的連接埠填入本機代理欄位。瀏覽器擴充功能可能覆蓋系統代理；測試時請暫時讓瀏覽器改用系統設定。

建議先確認一般代理正常，再啟用 TUN。依介面提示處理系統管理員權限或服務需求，接著檢查虛擬介面與核心日誌。啟用後若所有連線中斷，先關閉 TUN 並確認網路恢復，再檢查是否與其他虛擬網卡、公司網路用戶端或安全政策衝突。不要同時更換伺服器、修改 DNS 和重新安裝驅動程式，否則難以判斷真正原因。

結束執行、升級與 Windows 特有問題

關閉視窗可能只是縮到通知區域，不代表程式已結束。升級前，請從系統匣選單確實結束程式，並確認核心程序已關閉，再使用用戶端支援的更新方式或安裝新版。保留原有設定備份，不要將舊程式元件直接覆蓋到新目錄。若系統提示檔案仍在使用，先正常結束工作階段，不要反覆強制刪除仍被占用的檔案。

異常結束後若瀏覽器無法上網，先查看系統代理是否仍指向已停止的本機連接埠，必要時還原安裝前記錄的代理設定。若視窗能開啟卻無法儲存設定，請檢查安裝目錄的寫入權限；若開機啟動後連線失敗，確認網路是否已就緒。待手動操作流程穩定後再啟用開機啟動與自動連線，避免誤將啟動順序問題當成長期連線故障。

首次安裝所需元件、解壓位置與啟動檢查，也可參考v2rayN 首次安裝與初始設定。若只有特定應用程式未使用代理，先檢查該應用程式的網路入口，不必立刻重新安裝整個用戶端。

macOS：晶片選擇與網路權限

依晶片選擇版本並完成首次啟動

先開啟蘋果選單中的「關於這台 Mac」：顯示 Apple 系列晶片時，選擇 Apple Silicon 安裝檔；顯示 Intel 處理器時，選擇 Intel 安裝檔。請前往macOS 用戶端下載頁面。選擇架構時以裝置資訊為準，不要只看購買年份；同一產品系列可能採用不同處理器，安裝檔名稱也不能取代系統顯示的實際資訊。

開啟下載的磁碟映像檔，依視窗說明將應用程式拖放至「應用程式」資料夾，再從該資料夾啟動。不要長期從掛載中的磁碟映像檔執行，也不要在多個位置保留同名副本後輪流啟動。完成安裝後可退出磁碟映像檔，並確認執行的是「應用程式」資料夾內的副本，避免更新時改到另一份程式。

初次開啟若受到系統安全檢查限制，請先確認檔案來源與裝置架構，再查看「系統設定 → 隱私權與安全性」中的相關提示。只對確認來源的應用程式，依系統提供的流程允許開啟；不要為了啟動用戶端而全面關閉安全檢查。若提示檔案已損毀、架構不支援或缺少元件，應分別排查，不要把所有提示都視為同一種權限問題。

匯入訂閱並確認目前使用的伺服器

開啟 v2rayN 的訂閱管理入口，在「訂閱群組設定」新增群組，填入名稱與完整網址，儲存後更新該群組。貼上時請留意從通訊軟體複製的內容是否混入說明文字、換行或全形標點。網址中的大小寫、編碼字元與查詢參數都應保留，不要為了讓網址看起來整齊而手動刪改。

更新完成後選擇伺服器，確認它已成為目前使用項目，再查看核心日誌。選單列圖示與主視窗可能顯示不同層級的狀態：視窗存在只代表介面正在執行，核心仍可能因連接埠或設定問題而啟動失敗。驗證連線時，先選擇明確的測試目標，並記下當時使用的伺服器、入口與路由模式，之後比較才有依據。

依網路服務檢查系統代理

在用戶端選擇自動設定系統代理後，前往「系統設定 → 網路」，選擇目前使用的網路服務，並在詳細資訊中查看「代理」。無線與有線網路屬於不同服務，切換連線方式後應重新檢查。不要只檢查未連線的網路服務，也不要因某個服務顯示設定正確，就認為所有網路介面都套用了相同設定。

系統代理必須與用戶端目前監聽的本機網址和連接埠一致。有些應用程式有自己的代理選項，另一些只會在啟動時讀取系統代理；修改設定後，可先完全結束測試應用程式再重新開啟。瀏覽器代理擴充功能、工作設定描述檔與其他網路工具也可能覆蓋設定，請先確認目前要求實際由哪一層控制。

啟用 TUN 時，依用戶端提示授予必要權限，並確認日誌顯示介面與路由已成功建立。不同安裝方式的權限處理流程可能不同，不要照抄其他版本的終端機授權指令。若需要重複授權，請先確認應用程式是否曾移動、是否啟動了另一份副本，以及設定目錄是否仍屬於目前帳戶。

從睡眠喚醒、切換網路與升級

筆記型電腦從睡眠喚醒後，原有連線可能已失效，尤其是在無線網路、手機熱點與有線網路之間切換時。先確認系統已連上可用網路，再重新啟動用戶端連線。若一般系統代理正常但 TUN 異常，應優先檢查喚醒後的路由與 DNS，不必一開始就刪除訂閱。透過重複測試，區分短暫斷線與設定錯誤。

升級前請確實結束選單列中的用戶端，保留設定備份，再替換應用程式。若程式關閉後仍無法上網，請檢查目前網路服務是否殘留本機代理。還原時依據原始紀錄操作：家用網路可能適合關閉手動代理，工作網路則可能需要恢復原代理網址。不要一律清除所有代理選項，當成通用修復方式。

若安裝後無法儲存訂閱，請檢查應用程式設定目錄的權限與可用空間；若只在特定網路環境下失敗，保持伺服器與設定不變，換個網路重新測試。每次只變更一個條件，才能分辨裝置權限、區域網路限制與伺服器連線問題，避免把可用設定改成無法還原的混合狀態。

Linux：套件格式、桌面代理與 TUN

依發行版與架構選擇安裝檔

在Linux 下載頁面選擇 v2rayN。使用 Debian 套件管理的發行版請選 deb，使用 RPM 套件管理的發行版請選 rpm；也要確認處理器是常見的 x64 或 arm64。套件格式與處理器架構是兩項獨立條件，兩者都必須符合。衍生發行版另請依其軟體安裝說明與相依套件需求操作。

可使用圖形化軟體安裝程式開啟安裝檔，由系統處理相依套件並完成安裝。若缺少相依套件，先查看安裝程式列出的元件名稱與系統支援範圍，不要將其他發行版的程式庫檔案複製到系統目錄。用戶端是圖形介面程式，正常使用仍需要可用的桌面工作階段；純命令列伺服器環境不在本章範圍內。

若不確定架構，可開啟終端機執行以下唯讀指令。常見輸出中，x86_64通常對應 x64，aarch64通常對應 arm64。若輸出不同，先確認裝置與安裝檔的支援情形，不要強制安裝來跳過套件管理程式的架構檢查。指令輸出僅用於辨識環境，不會修改網路設定。

uname -m
cat /etc/os-release

以一般使用者身分啟動並匯入訂閱

安裝後，從桌面應用程式選單啟動 v2rayN，先以目前登入的帳戶執行，不要長期以管理員權限執行整個圖形介面程式。用戶端的設定、快取與日誌通常屬於使用者環境；若交替以不同權限啟動，可能造成目錄擁有者變更，導致設定無法儲存、重新啟動後群組消失或更新設定失敗。

在「訂閱群組設定」新增群組、填入網址並儲存，再執行更新。初次更新失敗時，請查看日誌中的網路錯誤與解析錯誤：前者應檢查目前網路、DNS 與更新路徑；後者應確認收到的內容是否為用戶端可辨識的格式。匯入成功後設定目前使用的伺服器，再查看核心啟動結果，不要直接跳到 TUN 設定。

桌面系統代理與應用程式的獨立入口

Linux 各桌面環境的代理設定位置並不一致。GNOME 通常在系統設定的網路代理中管理，其他桌面環境可能有專屬模組；用戶端自動設定的範圍也取決於目前的桌面工作階段。即使圖形介面顯示已設定代理，部分應用程式仍可能不讀取該設定。請先用確定會遵循桌面代理的應用程式測試，再判斷系統代理是否正常。

終端機環境變數與桌面代理是不同的入口。瀏覽器可以連線，不代表終端機程式已取得代理設定；反過來也一樣。若要為某個應用程式手動設定，請先確認用戶端本機監聽的協定與連接埠，再填入該應用程式支援的代理類型。不要長期設定來源不明的全域環境變數，也不要把訂閱網址當成代理伺服器網址。

可透過用戶端日誌或系統監聽資訊確認本機連接埠是否衝突。以下指令會列出目前的 TCP 監聽連接埠，輸出內容視帳戶權限而異；重點是核對用戶端設定中的實際連接埠，不必與其他教學使用相同數字。若連接埠已被占用，先確認程序用途，再決定關閉衝突程序或修改用戶端連接埠。

ss -ltnp

TUN 權限、路由與桌面整合

TUN 需要系統網路權限，處理方式依用戶端安裝形式而異。請優先使用介面提供的權限設定與啟動流程，不要隨意替整個安裝目錄授予過於寬鬆的權限，也不要盲目執行網路上的能力授權指令。啟用後先確認介面已建立，再檢查流量路由；日誌中的權限不足與遠端連線逾時是不同問題。

啟用 TUN 後若無法存取區域網路服務，請檢查是否有接管區域網路流量、排除 IP 位址範圍或路由優先順序等設定。若系統同時執行其他隧道或容器網路，先停用新增工具進行比對，並保留原始路由紀錄。不要直接刪除所有網路介面，否則可能中斷目前連線，也會失去可重現問題的檢查條件。

部分桌面環境預設不顯示系統匣圖示，關閉視窗後，背景程序可能仍在執行。升級、修改連接埠或重新啟動前，先確認舊執行個體是否仍在執行。套件升級應透過對應的套件管理流程完成，避免同時保留來自不同來源的程式副本。若程式正常啟動但無法寫入設定，請優先檢查使用者目錄權限，不要繼續提高執行權限。

Android：匯入訂閱與 VPN 介面

選擇 v2rayNG 或 v2flyNG

前往Android 下載頁面，優先查看採用 Xray 核心的 v2rayNG；若現有設定依賴 V2Fly，再查看 v2flyNG。多數較新的主流手機可選擇 arm64；若不確定裝置應用程式架構，可考慮通用版。處理器支援某種架構，不一定代表目前系統提供相同的應用程式環境，請依系統與安裝提示判斷。

安裝時，只授予負責執行安裝的檔案管理員或瀏覽器必要權限；完成後可撤銷其安裝未知應用程式的權限。若系統提示無法安裝，請分辨是架構不符、儲存空間不足、未符合系統需求，還是與已安裝的應用程式衝突。不要為了覆蓋安裝而先刪除現有用戶端；解除安裝可能同時移除訂閱與本機設定，請先備份。

從其他來源移轉應用程式時，系統可能因簽章不同而拒絕直接更新。反覆點選安裝無法解決這種情況。請先備份設定、確認目標用戶端與來源，再決定移轉方式。v2rayNG 與 v2flyNG 是不同應用程式，介面相似不代表資料庫可直接互換；跨應用程式移轉時，優先使用雙方都支援的訂閱或分享格式。

新增訂閱群組並選擇設定

在用戶端側邊選單中尋找「訂閱群組設定」或相應的訂閱管理入口，新增群組並填入備註與訂閱網址，然後儲存。返回主畫面後執行「更新訂閱」。若複製的是單一分享連結，請使用從剪貼簿匯入設定的入口，不要將它當成遠端訂閱網址。兩種入口用途不同，混用可能導致無法取得內容或格式錯誤。

更新後點選一項設定，讓它成為目前選取項目，再使用連線按鈕啟動。若服務提供者要求特定傳輸方式或安全參數，請依完整分享內容設定，不要為了簡化介面而任意關閉相關選項。測試時先保留預設設定，確認基本連線可用後，再調整個別應用程式代理、DNS 與路由規則。

了解 Android 的 VPN 授權

初次連線時，通常會出現系統 VPN 連線要求。這是授權用戶端透過系統介面接收裝置流量，並不代表用戶端已自動取得可用伺服器。允許後，仍須確認核心已啟動且遠端連線成功。系統通常不允許兩個一般 VPN 應用程式同時占用同一個介面；若已有同類連線執行，請先中斷再測試。

Android 端不必照搬桌面版的「自動設定系統代理」步驟。常見用法是由用戶端建立系統 VPN 介面，再依路由與個別應用程式設定處理流量。畫面顯示連線標示，只能證明介面狀態，不能單獨證明目標網站已透過遠端伺服器存取。請搭配應用程式的存取結果、用戶端日誌及必要的路由檢查驗證。

「個別應用程式代理」通常可設定只讓指定應用程式使用用戶端，或排除指定應用程式；實際選項依介面模式而定。設定後請同時檢查模式與清單：同一份清單在「僅代理」與「略過」模式下的含義相反。修改後可中斷再重新連線，並完全結束目標應用程式後再測試，避免舊連線繼續沿用先前的路徑。

背景限制、網路切換與斷線恢復

部分裝置會在鎖定螢幕後限制背景程序。若前景使用正常、鎖定後中斷，請檢查電池最佳化、背景活動及製造商的自動啟動管理，僅為用戶端解除必要限制，不必對所有應用程式關閉省電策略。先記錄斷線時間與發生情境，再判斷是程序遭終止、網路切換，還是遠端工作階段逾期。

從無線網路切換至行動網路後，原有連線可能需要重新建立。先確認裝置本身網路正常，再中斷並重新連線用戶端。若某個網路持續失敗、另一個網路正常，請保留相同設定進行比對，不要同時修改協定參數。使用私人 DNS、其他本機網路工具或熱點分享時，也請記錄這些因素，避免忽略系統層級的差異。

系統中的「一律使用 VPN」及「封鎖未使用 VPN 的連線」可能影響中斷後的網路行為。啟用封鎖後，用戶端停止時裝置無法正常上網，可能是預期結果，並非系統損壞。排查時若需要暫時中斷，請先了解這些選項再調整；受管理裝置的政策不應擅自變更。

訂閱、分享連結與更新管理

分辨網址與內容的差異

訂閱連結通常是遠端網址，用戶端存取後會取得多筆設定；單一分享連結則直接描述一筆伺服器設定。訂閱回應可能採用編碼文字或其他用戶端支援的格式，但網頁連結不一定就是訂閱連結。帳戶首頁、付款頁面與說明文件即使能正常開啟，也不能因此填入訂閱網址欄位。

桌面版通常透過「訂閱群組設定」儲存遠端網址，Android 版則透過訂閱管理選單儲存。剪貼簿匯入適用於用戶端支援的分享內容；從檔案匯入則適用於相應的設定檔。選擇入口前，先確認手上的資料類型，不要逐一嘗試所有匯入按鈕。錯誤入口有時會產生不完整紀錄，讓後續排查更加困難。

貼上網址後，請檢查前後空格、換行、跳脫字元與標點。部分通訊軟體會連同連結後的句號一起複製，有些網頁顯示的則是縮短文字，而非實際網址。請複製完整連結目標並保留查詢參數，不要手動將編碼符號替換成看起來較直觀的字元。範例網域不能用於實際連線。

群組更新與目前使用設定的關係

建議依來源或用途建立群組，並以清楚名稱標示，避免所有訂閱都放在無法辨識的清單中。更新時先選擇目前群組，確認回傳數量與日誌後，再考慮更新所有群組。若混用多個來源，其中一個來源失敗不一定會影響其他群組；逐一檢查可保留仍可用的設定，避免一次清除所有內容。

更新訂閱時可能會重建由訂閱管理的項目；手動修改這些項目的備註或參數後，下次更新不一定會保留。若需要長期自訂，請先確認用戶端是否支援複製為獨立項目或獨立群組，再進行修改。未備份前，不要把訂閱項目當成唯一一份手動參數的保存位置，也不要假設清單順序永遠不變。

更新成功後，還要確認目前使用的伺服器。原本使用的項目可能已遭刪除、重新命名或替換，用戶端也可能仍選用其他群組中的項目。請先確認選取項目所屬群組、協定與伺服器網址，再重新連線測試。訂閱管理與連線管理是兩個步驟，更新日誌顯示成功不能取代實際連線驗證。

更新路徑與自動更新間隔

不透過代理更新，表示訂閱要求直接使用目前網路；透過代理更新則需要已有可用代理。後者適用於已確認連線正常的情況，但若唯一可用的設定已失效，就可能無法透過它取得新設定。排查時先確認要求經由哪條路徑傳送，再檢查該路徑的網路狀況，不要只是不斷點選更新。

自動更新需要啟用「更新」等開關，並依介面指定的單位填寫間隔。若欄位標示分鐘，就不能直接填入小時數。更新間隔應參考服務提供者的說明、內容變動頻率與裝置使用習慣；設定得太頻繁只會增加要求次數。間隔設為 0 時的行為因實作而異，不要預設 0 代表持續更新。

裝置進入睡眠、用戶端結束執行或背景程序受系統限制時，自動更新不一定會準時進行。恢復使用後請查看最近一次更新結果，必要時手動更新。若每次自動更新都失敗，但手動更新正常，請比較兩者執行時的網路狀態、代理路徑與權限，不必先懷疑網址格式。詳細排查方式請參閱訂閱更新失敗排查。

依錯誤類型縮小排查範圍

逾時通常表示要求未能在指定時間內完成，應檢查網路路徑與網址是否可連線；拒絕存取可能與憑證、來源限制或服務狀態有關；若回傳內容無法解析，請確認收到的不是登入頁、錯誤頁或其他不支援的格式。不要公開完整回應內容，服務回傳資料也可能包含存取憑證與伺服器驗證資訊。

更換訂閱前，先保存仍可使用的設定，並確認新網址來自原本可信任的管道。若懷疑網址已外洩，請在服務提供者支援的情況下重設存取憑證；單純刪除本機群組無法讓舊網址失效。桌面版與 Android 版的入口逐項對照，請參閱訂閱連結匯入方法。

系統代理、TUN、路由與 DNS

先確認流量入口，再處理分流

系統代理、TUN 與路由規則各自解決不同問題。系統代理會告知遵循設定的應用程式將要求交給本機入口；TUN 透過系統網路介面接收範圍更廣的連線；路由規則則決定進入核心的要求使用哪個出站。必須先確認要求已進入用戶端，討論直連或代理規則才有意義；否則規則再正確，也不會影響略過用戶端的應用程式。

初次排查建議以一般系統代理作為基準，選擇確定會遵循系統設定的瀏覽器，並保持伺服器與路由不變。若瀏覽器正常但另一個應用程式異常，請檢查該應用程式是否設定了獨立代理、特殊傳輸方式或個別應用程式排除規則。若所有應用程式都有問題，再檢查核心、本機連接埠與遠端連線，不要先新增複雜的分流規則。

本機監聽網址通常使用迴路位址，只允許本機存取。啟用區域網路監聽會擴大可存取範圍，請確認用途並搭配防火牆限制。若要讓手機或其他裝置使用代理，迴路位址指的是該裝置本身，不是執行用戶端的電腦；必須填入電腦在區域網路中的網址，並確認兩端網路可互相連線且監聽範圍正確。

規則順序與出站標籤

路由規則通常依順序比對，排在前面的寬泛規則可能會遮蔽後續的精細規則。若要讓特定網域直連，請確認它是否已符合上方規則，而不只是檢查規則是否存在。出站標籤必須與目前設定中實際定義的標籤一致；介面上的「代理」「直連」只是顯示名稱，底層標籤不一定在所有設定中都相同。

以下是 Xray 路由物件的結構範例，僅用於說明規則，不是可直接匯入的完整用戶端設定。範例假設設定中已有名為 direct 的出站，且使用的核心具備相應的網域資料。若透過圖形介面用戶端管理，請優先在「路由設定」中建立相同規則，不要直接修改用戶端暫時產生的執行檔案。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

geosite表示依網域集合比對，geoip表示依 IP 位址集合比對，兩者不可互換。網域規則需要核心取得可供判斷的網域資訊；若應用程式只提供位址，結果可能不同。新增規則前，先確認輸入資訊、資料檔案與規則順序，再判斷是否需要網域嗅探等功能，不要為了符合單一規則而啟用所有選項。

DNS 解析路徑與連線路徑

DNS 負責將網域名稱解析為位址，代理連線則負責傳送要求，兩者的路徑可能不同。若網域無法開啟但位址可以存取，只能說明需要進一步檢查解析，不能直接判定是某個 DNS 服務故障。請先分辨系統解析、用戶端內部解析與應用程式自己的加密 DNS，再確認目前測試實際使用哪一種。

在系統代理模式下，應用程式可能自行解析網域，也可能將網域交給本機代理，視協定與應用程式實作而定。TUN 模式也可能接管 DNS 要求，處理方式與一般代理不同。切換入口後，請重新檢查 DNS 設定，不要假設瀏覽器行為維持不變。排查時每次只調整一個解析入口，避免多個來源互相覆蓋。

設定自訂 DNS 伺服器前，請確認目前網路可以連線到該伺服器，並了解 DNS 要求是否經由代理傳送。若無法連線到遠端伺服器，將所有解析也綁定到同一個失效代理，可能形成新的依賴問題。若遠端伺服器使用網域名稱，還要考慮建立代理連線前如何完成首次解析，不能只檢查連線建立後的查詢。

TUN 的區域網路與還原範圍

TUN 接管流量後，印表機、網路儲存裝置與區域網路管理頁面可能受到新路由影響。先檢查用戶端是否提供略過區域網路或排除路由的選項，再確認區域網路位址範圍與實際網路相符。不要只為了恢復單一裝置，就新增範圍過大的直連規則；範圍愈大，愈容易影響原本應走代理的目標。

「全域代理」適合用來暫時確認路由差異，但不代表系統的所有流量都已被接管。測試完成後，請恢復適合日常使用的規則，並確認內部網路仍可存取。若要逐一了解網域前綴、位址集合與優先順序，可閱讀v2rayN 自訂路由規則寫法，再依實際目標縮小規則範圍。

常見設定問題與還原順序

依照現象判斷故障範圍

先記錄「哪個應用程式、哪個目標、哪種網路、從何時開始」出現異常，再判斷問題發生在啟動、訂閱、入口或出站。視窗無法開啟與網站無法存取不是同一類問題；只有某個網站異常與所有應用程式都無法上網，也不能用相同方式處理。保留故障當下的設定與日誌後再修改，避免原始狀況被覆蓋。

若用戶端無法啟動，請檢查安裝方式、系統架構、執行環境、目錄權限與安全軟體紀錄。若用戶端能啟動但核心失敗，請查看第一筆相關錯誤，優先處理設定解析與連接埠監聽。後續大量連線錯誤可能只是前面的啟動失敗所造成，不必逐筆視為獨立故障，也不需要立刻刪除所有訂閱。

若訂閱更新成功但無法連線，請確認目前使用的伺服器屬於預期群組，並檢查核心是否正在執行。接著確認測試應用程式是否進入代理，再查看遠端連線日誌。訂閱只是取得設定的管道；伺服器是否可用仍取決於驗證參數、服務狀態與網路路徑。更新成功與實際連線之間，必須分別驗證。

以最少變更建立對照

選定一個伺服器、一個測試應用程式與一個目標，先在目前網路測試，再保持設定不變，切換到另一個可用網路。若只有一個伺服器失敗，可在同一群組選擇另一個比較；若所有伺服器都失敗，請回頭檢查本機入口與網路條件。比較時不要同時更換應用程式、路由、DNS 與伺服器，否則無法判斷是哪項變更造成影響。

連線遭拒、連線逾時、驗證失敗與憑證錯誤的意義各不相同。遭拒通常表示目標或本機連接埠未接受連線；逾時表示路徑未能在等待時間內完成；驗證失敗應核對設定與服務狀態；憑證錯誤則先檢查系統時間、網域名稱與必要的安全參數。不要把關閉憑證驗證當成長期修復方式，以免掩蓋真正的設定問題。

本機連接埠遭占用時，先確認占用程序。若是舊的用戶端執行個體，請正常結束後重新啟動；若是其他必要程式，請修改目前用戶端的連接埠，並同步修改手動設定代理的應用程式。只改用戶端而不改應用程式，會造成新的入口錯誤。切勿為了釋出連接埠而結束不明的系統程序。

中斷連線後恢復網路與備份

停止用戶端後若無法上網，桌面版請優先檢查系統代理是否仍指向本機監聽網址；使用 TUN 時則檢查介面與路由是否正常退出。Android 請確認是否啟用了封鎖未使用 VPN 連線的系統選項。還原時應依各平台的原始設定操作，不要一開始就清除所有網路設定，更不要在遠端工作階段中隨意重設網路。

升級後若出現異常，先與備份比對設定變化，並確認是否啟動了安裝在其他位置的副本。若確實需要回復舊版，請依用戶端支援的流程操作，並留意設定格式可能已改變。保留舊設定與目前設定的副本，不要反覆覆寫唯一一份資料。確認恢復正常後，再測試自動更新、啟動項目與分流設定。

日誌通常包含時間、目標網址、規則與錯誤原因；分享時只截取重現問題前後所需的範圍，並隱藏驗證資訊。暫時提高日誌層級後，排查結束時應恢復原設定，避免長期產生過多紀錄。向他人描述問題時，請附上系統、用戶端名稱、入口方式與已進行的對照測試，不要只提供一張「無法連線」的截圖。

常見問題快速查詢

恢復完成後，請分別測試瀏覽器、常用應用程式、區域網路服務，以及裝置從睡眠喚醒後的連線狀態，確認不只是單一測試目標恢復正常。將最後可用的入口、路由與 DNS 記錄在備份說明中；下次排查時就從這份基準開始。若要重新依序完成操作流程，請回到入門指南，不要一次啟用整份指南中的所有進階選項。