Windows
初次安裝可從 v2rayN 桌面版開始;熟悉傳統介面的使用者則可選擇 WPF 版。兩者主要是介面實作不同,選單名稱與位置可能不一樣。閱讀教學時先確認介面版本,再找出訂閱、路由與系統代理的相應選項。
若只是從舊版移轉,請先保留原有設定與訂閱資訊,再用新版用戶端測試一個曾經可用的節點。遇到異常時,才能先判斷是介面變更、匯入問題,還是連線問題。
前往下載 →先確認作業系統,再核對處理器架構與安裝套件格式。同一款用戶端可能提供多種安裝套件;套件不同,不代表可用節點也不同。
初次安裝可從 v2rayN 桌面版開始;熟悉傳統介面的使用者則可選擇 WPF 版。兩者主要是介面實作不同,選單名稱與位置可能不一樣。閱讀教學時先確認介面版本,再找出訂閱、路由與系統代理的相應選項。
若只是從舊版移轉,請先保留原有設定與訂閱資訊,再用新版用戶端測試一個曾經可用的節點。遇到異常時,才能先判斷是介面變更、匯入問題,還是連線問題。
前往下載 →在系統資訊中查看晶片或處理器:Apple Silicon 選 arm64,Intel 選 x64。不要只憑電腦外觀、系列名稱或購買時間判斷;同一產品系列可能有不同架構的機型。
應用程式能開啟,只代表安裝已完成。首次連線時,請分別確認訂閱清單能否更新、是否已選取節點,以及用於測試的應用程式是否使用目前的系統代理設定。
前往下載 →v2rayNG 使用 Xray 核心;需要 V2Fly 核心時,可選擇 v2flyNG。確認系統支援 arm64 後,選擇相應的安裝套件;無法判斷時,可參考下載頁的通用版說明。先選能處理目標設定的用戶端,再比較檔案大小與安裝格式。
首次啟動連線時,系統可能會顯示 VPN 連線授權提示。授權後,開啟測試用的應用程式,確認流量是否經過用戶端;若裝置上已有其他 VPN 服務在執行,請先確認是否占用了系統 VPN 連線。
前往下載 →桌面環境可使用 v2rayN。Debian、Ubuntu 系通常選 deb,Fedora 系通常選 rpm;確認套件格式後,還要核對處理器架構,不能把發行版名稱當成處理器類型。若安裝失敗,先查看套件管理器的錯誤訊息,判斷是架構、相依套件還是權限問題。
安裝成功後,還要另外確認應用程式是否能連線:各桌面環境的系統代理實作不盡相同,有些應用程式也會使用自己的網路設定。若瀏覽器正常但另一個應用程式無法連線,請先檢查該應用程式的代理設定。
前往下載 →用戶端先取得節點設定;應用程式流量進入後,核心才會解析連線目標並依規則選擇出站。排查時,沿著這條路徑找出最先發生異常的環節。
看得到節點清單,表示至少已取得一份設定;能連上節點,表示該節點在目前條件下可用;目標應用程式能連線,則還必須確認它的流量確實進入用戶端,並符合預期規則。這三種結果不能互相取代。
初次設定時,先用一個節點和一個應用程式建立可重複的測試。記錄連線模式、目標位址與測試結果,再新增路由規則或調整 DNS。保留這份紀錄,之後才能判斷異常是新設定造成,還是網路環境有所變化。
需要讓同一台裝置上的不同目標走不同出口時,就會用到路由規則。系統代理主要決定哪些應用程式將要求交給用戶端;路由則決定已進入核心的流量要往哪裡走。編輯規則前,先寫清楚比對條件與目標出站,再把範圍較窄的例外規則放在可能涵蓋它的一般規則之前。測試時,各選一個應該符合與不應符合條件的目標,並查看用戶端提供的連線記錄,確認實際出站。規則有生效但結果不符時,先檢查規則順序,再檢查節點。
網域解析異常與連線逾時,有時會顯示相同的錯誤訊息。先確認是應用程式自行解析、由系統解析,還是交由核心處理查詢,再決定要調整哪一層。用戶端的 DNS 設定不一定會影響應用程式內建的解析器,也不是只要換成另一個 DNS 伺服器,就能讓所有分流規則生效。請確認規則比對的是網域還是 IP 位址,並檢查查詢所走的網路路徑,再用同一個網域重複測試。若測試結果前後不一致,也要考慮是否仍在使用舊的快取資料。
單一節點分享連結描述一組連線設定;訂閱網址則用來取得並更新一組設定。兩者不能只看連結外觀來區分,也不應隨意填入同一個欄位。匯入前,依來源為群組命名;更新後先確認節點是否出現在對應群組,再測試連線。使用關鍵字篩選時,請分清楚篩選後的畫面與訂閱實際回傳的內容。更新後找不到節點,先清除篩選條件並確認群組,不必立刻刪除訂閱或重新安裝用戶端。
用戶端能辨識分享連結,不代表目前的核心能執行連結所描述的完整設定。選擇核心時,應分別確認協定、傳輸方式與安全設定,不要只看節點名稱或協定縮寫。桌面用戶端支援的核心組合,也不一定與行動用戶端相同。切換核心後若無法啟動,先用原本可用的設定確認變更,再檢查記錄指出的是欄位解析錯誤、連接埠遭占用,還是出站連線失敗。不同階段的問題,不能用同一種方式處理。
辨別專案、核心與圖形化用戶端這三類名稱,有助於理解為什麼同一份教學不能直接套用到每個應用程式,也能縮小排查問題的範圍。
Project V 是相關代理工具所屬的專案體系,V2Ray 則是其中負責處理連線的核心元件。後來,V2Fly 社群延續 V2Ray 的開發,Xray 則從這個程式碼家族分支出來並獨立發展。兩者共用一些基本概念:入站負責接收流量,路由判斷流量該走哪條路,出站則負責將連線交給下一站,或依設定拒絕連線。首頁顯示的四種出站名稱只是示意標籤,實際名稱與行為由設定決定。
以瀏覽器為例,只有在使用本機代理設定時,要求才會到達相應的入站;接著核心會根據可取得的目標資訊比對規則。若瀏覽器繞過代理,即使核心正在執行,也不會替它進行分流。理解這個界線,比記住某個版本的按鈕位置更實用:設定介面會變,但流量必須先進入核心這項前提不變。
V2Fly 與 Xray 各自維護協定實作與設定功能。兩者的文件可能都會出現入站、出站等欄位,但欄位名稱相同,不代表每個選項都能互換。VMess、VLESS 等名稱描述協定的一部分;連線也會受到傳輸方式、安全設定與雙方實作影響。伺服器設定決定用戶端必須符合哪些條件,不能根據節點備註中的地區或線路名稱推斷。
移轉時先保留舊環境,再將同一份已知可用的設定單獨匯入新環境。若介面辨識到節點,但核心無法啟動,先查看啟動錯誤;若核心已啟動,只有該節點無法連線,再檢查節點參數與網路可達性。依照這個順序排查,可避免將傳輸參數不符誤判為訂閱過期,也能避免一開始就修改整套路由規則。
這三款用戶端都公開原始碼。v2rayN 是桌面用戶端,提供訂閱、節點與路由設定的管理介面;v2rayNG 使用 Xray 作為核心;v2flyNG 則提供以 V2Fly 為核心的行動版選擇。用戶端與核心屬於不同層級的專案,訂閱清單的呈現方式、介面選單的配置及系統權限的申請流程,都不能用來判斷核心是否屬於同一個分支。
開源授權規範程式碼的使用、修改與再散布,不能取代對第三方訂閱服務的評估。免費使用用戶端與付費購買線路是兩回事。若設定中包含訂閱網址或節點憑證,不要將整份檔案貼到公開討論區。回報問題時,通常只需提供作業系統、用戶端與核心名稱、故障發生階段,以及移除敏感欄位後的錯誤摘要。
用戶端更新可能改變介面與系統連線方式;核心更新可能影響新功能的支援範圍或設定解析方式;訂閱更新則會重新取得節點清單。安裝套件有時會附帶核心,因此一次升級可能同時影響前兩層;但更新訂閱不會升級應用程式,也不會自動修正本機路由錯誤。排查更新後的故障,第一步是釐清這次實際變更了哪些內容。
保留舊設定後,可使用固定網路、固定節點與固定測試目標進行前後比較。先確認應用程式能啟動,再確認節點仍可使用,最後檢查原有規則是否命中。若只有規則結果改變,也要確認網域與位址資料是否隨更新一併變更。將各項操作分開進行,能保留明確的還原點,也能提供維護者更有用的重現步驟。
入門時先依照匯入訂閱教學建立可用的連線,再考慮更複雜的規則。清單未更新時,重點檢查訂閱來源與取得過程;清單正常但所有節點都無法連線時,先確認目前網路、連線模式與核心啟動狀態;若只有特定應用程式無法連線,則檢查該應用程式是否使用系統代理、是否有獨立的 DNS 設定,以及目標符合哪一條規則。
比較連線品質時,不要用單次延遲結果代替實際使用體驗。網頁的短連線請求著重回應時間,檔案傳輸則更能反映持續吞吐量,兩者受不同因素影響。請在相同網路與測試目標下重複比較,並分別記錄網路切換、節點更換與設定變更。若還原設定後連線仍不穩定,應重新檢查節點與線路,而不是繼續疊加本機規則。
從單機連線到區域網路部署,這三篇文章分別探討連線範圍、節點取捨與規則優先順序。依照目前遇到的問題選讀即可。
/ 部署實務
概覽在主路由與旁路由上直接執行 Xray 核心的幾種方式,比較效能需求、透明代理接管方式與維護成本,協助判斷是否值得部署。
如果只有一台電腦需要特別設定,單機部署通常更容易測試與還原。將設定放到閘道器之前,先釐清哪些裝置會受到影響、故障時由誰負責恢復網路,以及如何確認區域網路服務仍能互通。部署的難處通常不在於啟動核心,而在於確認流量接管範圍符合預期。
/ 入門指南
訂閱中有數十個節點時,從延遲測試、流量倍率、地區用途,到 VMess、VLESS、Trojan 協定差異,整理入門選擇方向。
先依用途排除不合適的地區或計費方式,再於相同網路環境下比較候選節點。綜合評估回應速度與穩定性,不要只看單次測速排名。
/ 路由分流
逐一解析 domain、full、regexp、ip、geosite 與 geoip 的寫法,說明規則由上而下比對的順序,以及常見衝突的處理方式。
一次只修改一條規則,再同時檢查原本應直連的目標與應走代理的目標,就能更快確認規則的比對範圍是否超出預期。