Windows
桌面版與經典 WPF 版都叫 v2rayN。第一次安裝可先試用桌面版;如果手邊的教學使用經典介面,或你已熟悉舊版選單,再選擇 WPF 版。選擇安裝檔前,請到系統的「關於」頁面確認系統類型,不要只憑作業系統名稱判斷架構。
如果下載的是壓縮檔,請先完整解壓縮至目前帳戶可寫入的資料夾,再從該資料夾啟動。在壓縮軟體的預覽畫面直接執行,可能只啟動主程式,卻缺少其他必要檔案。已有設定時,請先備份,再換個資料夾測試;確認訂閱與路由都還在後,才清理舊資料夾。
前往下載開源用戶端 · 中文設定指南
從用戶端選擇到訂閱匯入與路由分流,依作業系統找到安裝入口,再依相同步驟確認流量走向。
01 設定項目
訂閱提供設定,系統代理或 TUN 決定流量如何進入用戶端,路由則決定流量要前往何處。以下依各項設定分別說明。
訂閱網址由服務提供者提供,用來取得及更新一組設定;單一分享連結通常只包含一筆連線設定。在 v2rayN 中,先替訂閱分組取個容易辨識的名稱,儲存網址後再更新該分組。比起逐筆貼上,透過分組更新更容易辨認各項設定的來源,也能避免把臨時測試用的連線和常用清單混在一起。更新後先確認清單中是否出現項目,再選擇一筆連線;匯入成功不代表連線正常。
https://example.invalid/list
如果收到的是以 vmess:// 或 vless:// 開頭的單一連結,請使用分享連結匯入功能。
路由處理的是連線進入核心後要交由哪個出站。規則會依序檢查,優先採用第一個符合的規則;若將涵蓋範圍較大的規則排在前面,後續例外規則可能永遠不會符合。相較於讓所有要求都經過同一個出站,依規則分流可為本機網段與其他目的位址指定不同路徑。新增規則時,先確認出站標籤確實存在,再分別以預期直連及預期代理的目標測試,避免只驗證其中一種路徑。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
這是一條規則,不是完整設定;需搭配相應的地理資料,以及名為 direct 的出站。
用戶端支援多種協定,不代表這些協定可以互換。伺服器端提供哪種協定,就使用相應的連線類型;傳輸方式、安全層與伺服器名稱也必須依提供的參數填寫。相較於只能辨識單一分享格式的用戶端,多協定用戶端可將不同來源的設定放在同一份清單中,但仍須由相容的核心處理每筆設定。若項目匯入正常、連線時卻失敗,請優先核對原始參數,不要擅自更改協定名稱來嘗試連線。
實際可用的組合取決於核心實作與伺服器端設定。
系統代理會將本機代理位址寫入系統設定,只有會讀取這項設定的應用程式才會使用;終端機工具通常需要另外指定代理位址。TUN 則透過虛擬網路介面接收流量,涵蓋更多不讀取代理設定的應用程式,但也會涉及權限、網段與路由。請先在一種模式下完成驗證,再視需要切換。瀏覽器可以連線、終端機卻不行時,先檢查終端機的代理設定,不要直接認定伺服器端失效。
「不變更」會保留現有設定,不代表清除設定。
用戶端介面負責整理項目、儲存設定並啟動核心;實際解析協定與處理連線的是核心。相較於將核心固定在應用程式中的做法,桌面用戶端可依可用選項,為不同設定選擇相應的實作。切換前先確認協定、傳輸方式與安全層是否受支援;切換後查看啟動記錄,再用原本的目標重新測試。若新核心無法啟動,先還原已記錄的設定;不要同時更換訂閱、修改路由並調整系統代理。
02 安裝檔選擇
先確認作業系統,再確認處理器或套件格式。即使應用程式名稱相同,不同裝置也不一定能使用同一個安裝檔。
桌面版與經典 WPF 版都叫 v2rayN。第一次安裝可先試用桌面版;如果手邊的教學使用經典介面,或你已熟悉舊版選單,再選擇 WPF 版。選擇安裝檔前,請到系統的「關於」頁面確認系統類型,不要只憑作業系統名稱判斷架構。
如果下載的是壓縮檔,請先完整解壓縮至目前帳戶可寫入的資料夾,再從該資料夾啟動。在壓縮軟體的預覽畫面直接執行,可能只啟動主程式,卻缺少其他必要檔案。已有設定時,請先備份,再換個資料夾測試;確認訂閱與路由都還在後,才清理舊資料夾。
前往下載從 Apple 選單開啟「關於這台 Mac」。顯示 Apple 晶片就選 Apple Silicon 套件;顯示 Intel 處理器就選 Intel 套件。下載 v2rayN 後,依映像檔中的指示安裝,再從「應用程式」資料夾開啟;不要將掛載中的映像檔當成長期執行位置。
如果系統阻止程式啟動,先確認提示內容是關於系統相容性、來源還是權限,不要為了單一應用程式關閉整台裝置的保護功能。在系統匣看到應用程式,也不代表系統代理已生效;從用戶端切換設定後,請用一款會遵循系統代理設定的應用程式測試,再決定是否需要另外設定終端機。
前往下載需要 Xray 核心時選擇 v2rayNG;明確依賴 V2Fly 實作時,再考慮 v2flyNG。多數近期裝置可選 arm64;不確定裝置支援哪種架構時,可選通用套件。通用套件能解決安裝架構問題,但無法讓其他核心支援原本不支援的協定組合。
從瀏覽器或檔案管理工具開啟安裝檔時,系統通常只會將安裝權限授予目前來源,安裝完成後即可收回。首次連線時,系統可能會要求授予 VPN 權限;若有其他應用程式正在使用該連線,請先中斷連線再測試。匯入時也要分清楚整組訂閱與單一分享連結。
前往下載選擇 v2rayN 時,先依發行版常用的套件格式挑選:Debian、Ubuntu 系統通常選 deb,Fedora 系統通常選 rpm;接著再確認 x64 或 arm64。兩項都符合再安裝,別把架構不相容與缺少執行相依套件當成同一種問題。
桌面環境的代理設定不一定會套用到終端機或背景服務。若瀏覽器正常、命令列卻逾時,請先確認本機監聽位址與連接埠、命令列工具支援的代理類型,以及代理環境變數是否傳入目前的程序。確認這一層後,再檢查用戶端的路由與出站設定。
前往下載03 專案與核心
教學談的是用戶端、核心還是伺服器端?先釐清這三個層次,再判斷操作建議是否適用於目前的裝置。
Project V 是理解這套工具的起點。早期的 V2Ray 著重將入站、出站與路由拆分成可組合的設定:入站負責接收連線,出站負責傳送連線,路由則負責在多個出站之間做選擇。因此,發起連線的應用程式、轉送流量的核心,以及處理設定的圖形介面,不必寫在同一個程式中。社群後來推出的桌面與行動用戶端,正是以這樣的分工為基礎,提供更方便的操作入口。
了解這段歷史背景有助於排查問題。例如,用戶端中看得到訂閱項目,只能表示介面有資料可用;要確認設定能否載入,必須查看核心的啟動結果;要確認某個應用程式的流量是否經過核心,則要檢查它的流量入口。混淆這三件事,最容易在網路異常時反覆匯入訂閱,卻沒發現應用程式根本沒有使用代理。
V2Fly 社群延續 V2Ray 核心的開發與維護。Xray 從這套程式碼分支出去,之後各自發展。兩者的設定概念相近,有些協定與欄位看起來也相同,但共同來源不代表一定相容。尤其是涉及新式傳輸或安全層選項時,其中一方能讀取的參數組合,另一方未必會以相同方式處理。判斷時,請優先確認伺服器端的明確要求,再查目前用戶端使用哪個核心。
更換裝置時,也別預設要把原本整份設定搬過去。單一連線的必要參數、用戶端儲存的訂閱分組,以及本機監聽連接埠和系統代理設定,本來就屬於不同層次。可以先移轉連線項目,在新裝置上測試一筆連線,再逐項補回分流規則。即使連線失敗,也更容易判斷是參數不相容,還是新裝置的本機設定尚未完成。
VMess、VLESS 描述通訊雙方如何交換資料;開源授權則規範程式碼可以如何使用、修改與再散布。這兩類文件處理的是完全不同的問題。V2Fly 核心採用 MIT 授權,Xray-core 採用 Mozilla Public License 2.0。前者再散布的條件較少,但仍須保留相關著作權與授權聲明;後者的義務主要適用於授權涵蓋的檔案,散布這些檔案的修改版本時,須依條款提供相應的原始碼。
各元件分別維護,授權條款也應分開查看。圖形用戶端、隨附核心與其他元件,不能只憑安裝檔名稱就認定適用同一套條款。一般使用者不必讀完所有授權文字才能設定用戶端;但若打算重新封裝、修改或發布衍生版本,就應逐一閱讀相關元件附帶的授權條款。代理服務本身的帳號、方案與使用條件則由服務提供者決定,不屬於開源授權的一部分。
v2rayN 是開源桌面用戶端,可在同一個介面管理訂閱分組、選擇連線、設定路由與系統代理,適合需要管理多組設定,或分別排查不同應用程式的情況。v2rayNG 是使用 Xray 的開源 Android 用戶端;v2flyNG 也採開源方式,使用 V2Fly 核心。手機上不必因為兩款應用程式名稱相似就全部安裝;請先依伺服器端參數與用戶端支援範圍選擇一款,完成基本連線後,再比較設定差異。
向他人說明問題時,交代應用程式名稱、核心與錯誤發生的步驟,比只貼一張寫著「連線失敗」的截圖更有幫助。例如,是更新訂閱時取不到資料、選取項目後核心回報錯誤,還是只有某個終端機工具沒有經過代理?這三種情況需要檢查的位置都不同。分享記錄時,請保留時間、操作步驟與錯誤類型,並遮住訂閱網址、帳號資訊及不宜公開的伺服器端參數。
用戶端更新可能改變選單配置、安裝方式或設定儲存位置;核心更新可能改變支援的欄位與啟動行為;訂閱更新則只是向提供者取得最新項目,三者不能互相取代。更新前先記下目前選取的項目、核心、路由模式與本機監聽連接埠;需要保留的自訂規則請另外備份。每次只調整一個層次,並使用相同的應用程式與目標重新測試,才能確認是哪項變更造成影響。
更新後若所有應用程式都同時失效,先確認核心是否啟動、入站是否正在監聽;若只有某一個應用程式失效,先檢查該應用程式本身的入口設定。訂閱更新後項目變少,也要先確認更新的是哪個分組,以及來源是否真的刪除了項目,不要立刻覆蓋本機手動設定。需要逐步操作時,請接著查看全平台指南;若已能連線但流量走向不如預期,可先查看說明中心中的路由與代理問題。
04 技術筆記
依實際狀況找到檢查入口:終端機未接入、流量進入後走錯出站,以及多個訂閱分組難以整理,是三種不同問題。
分開排查瀏覽器與終端機:先確認系統代理是否已設定、瀏覽器擴充功能是否接管,再檢查終端機環境變數與本機連接埠,找出 v2rayN 系統代理失效的真正原因。
先別重新安裝用戶端。瀏覽器擴充功能、系統代理與終端機參數可能分別指向不同入口;確認工具實際連到哪個連接埠後,才需要檢查轉送。如果確認某筆連線沒有進入用戶端,修改出站或路由就無法解決這筆連線的問題。
說明系統代理開關與路由模式是兩個不同層次的設定,比較全域模式、略過中國大陸與自訂規則各自的流量走向,並提供日常瀏覽、開發除錯等情境的選擇建議。
同時匯入多個訂閱時,如何依來源分組、使用關鍵字篩選伺服器、清理重複與失效項目,並設定更新週期,讓伺服器清單維持整齊、方便查找。