用戶端安裝手冊

V2Ray 安裝與設定指南

依平台查安裝方式,循序排查連線問題。涵蓋安裝套件選擇、匯入訂閱、系統代理與 TUN 模式。

第一次設定,建議先依照快速入門教學完成匯入、選擇模式和連線檢查。本頁是查閱手冊:不確定該選哪個安裝套件時,直接前往對應平台;節點已能連線,但應用程式沒有走代理時,從連線檢查或常見問題開始。

01通用準備

安裝前準備:用戶端、安裝套件與訂閱

分清用戶端、核心與節點

用戶端是日常操作的圖形介面,可用來管理訂閱、選擇節點及切換代理模式。核心在背景讀取設定、建立連線並執行路由規則。節點是遠端連線設定,通常包含伺服器位址、連接埠、驗證資訊和傳輸參數。下載並開啟用戶端,不代表已取得可用節點;成功匯入節點,也不代表目前的應用程式已透過代理連上網路。

Project V 是認識這套工具的起點。V2Fly 延續 V2Ray 的社群開發,Xray 則是從相關生態系發展出的另一個核心分支。同一種協定在不同核心上的傳輸方式或安全選項,支援情況不一定完全相同。移轉時,先確認原設定使用的核心與傳輸組合,再查看目標用戶端是否能辨識。別只因節點名稱相同,就認定兩份設定完全相同。

先確認作業系統,再選安裝套件

桌面平台首選 v2rayN。Android 優先選用 Xray 核心的 v2rayNG;若現有設定明確要求 V2Fly 核心,可考慮 v2flyNG。先在裝置上確認作業系統與處理器資訊,再前往下載頁面。外觀相近的兩台電腦可能採用不同架構;即使架構相同,不同作業系統或發行版也可能需要不同格式的安裝套件。

四個平台的套件選擇依據
平台下載頁用戶端確認項目
Windowsv2rayN系統架構;Desktop 或 WPF 介面
macOSv2rayNApple 晶片或 Intel 處理器
Linuxv2rayN發行版套件格式;x64 或 arm64
Androidv2rayNG;v2flyNG 為替代選項核心需求;arm64 或通用套件

架構標籤表示軟體套件可在哪類系統環境中執行,不代表速度等級。手機處理器即使支援 64 位元,系統也未必提供相應的執行環境。桌面平台還要分清安裝程式與免安裝壓縮檔:安裝程式通常會建立應用程式目錄和捷徑;免安裝版則需保留解壓後的目錄結構。更換套件前先確認原本的套件類型,別只把舊目錄中的執行檔複製到新目錄。

辨認訂閱網址與單一節點連結

訂閱網址通常是網頁格式的網址,用戶端會透過它取得節點清單。新增網址只是建立訂閱群組,手動更新後才會載入節點。以 vless:// 或 vmess:// 開頭的分享連結,通常只包含單一節點的資訊,應使用從剪貼簿匯入節點的功能。網頁網址也可能只是登入頁或說明頁;收到網址時,先確認用途,別只憑網址以外的線索就把網頁連結當成訂閱。

掃描 QR Code 時,也要先確認內容是單一節點還是訂閱。掃描後留意用戶端開啟的是新增訂閱表單,還是節點預覽。如果清單中已有同名項目,匯入後可依群組和節點類型確認新增項目,不必為了確認結果而清空清單。想了解不同連結的更新方式,請參閱分享連結與訂閱網址的差異。

保留可還原的初始設定

安裝前記下系統代理是否已啟用、是否另有 VPN,以及工作環境是否要求固定代理。原有設定若由公司或組織管理,請勿擅自覆寫。已安裝其他用戶端的話,先使用內建的備份或匯出功能保存設定。保留訂閱群組、手動新增的節點和自訂路由後,再考慮跨用戶端移轉。匯出的檔案仍應視為敏感資料;共用電腦上避免長期放在共用下載資料夾。

第一次使用時,建議採用最簡單的驗證流程:只匯入一個節點或一份訂閱,只選一個節點,只啟用一種流量接管方式,最後連線到預先選定的測試目標。先別同時調整網域解析、分流規則和開機啟動。確認連線正常後再加入其他設定;若一開始就失敗,因為變更項目較少,更容易判斷問題出在安裝、匯入、核心啟動,還是應用程式流量接管。

02桌面設定

Windows:安裝 v2rayN 與設定系統代理

選擇 Desktop 或 WPF 安裝套件

開啟系統設定中的「系統 → 關於」,查看系統類型,再前往Windows 下載區確認安裝套件標示。Desktop 使用跨平台介面,傳統 WPF 版則保留熟悉的 Windows 介面配置。選擇時應考量系統相容性和使用習慣,而非節點協定。下載區的 x64 套件適用於 x64 環境;若裝置採用其他架構,請先確認系統是否提供相容的執行方式,別把套件名稱中的位元數當成相容性說明。

先關閉舊用戶端,包括仍在系統匣執行的程式,再執行安裝程式。依安裝精靈完成安裝後,從新建立的捷徑啟動。若程式提示缺少執行環境,先記下提示中的元件名稱與架構,再依該套件的說明處理。遇到應用程式執行限制時,先確認安裝來源、系統提示和裝置管理政策;不要為了啟動程式而關閉整套系統防護,也不要將系統目錄當作設定存放位置。

匯入訂閱並選取目前使用的節點

從訂閱群組的相關選單新增群組,填入容易辨認的備註和完整訂閱網址,接著手動更新。電腦尚未有可用代理時,可以嘗試不透過代理更新;能否成功取決於目前網路是否可直接連上訂閱服務。若必須透過既有連線才能存取網址,請先確認該連線可用,再選擇透過代理更新。別只看見「更新成功」就認定節點可用,也要切換到對應群組確認節點確實出現在清單中。

若手上只有一個分享連結,請複製完整連結,再使用從剪貼簿匯入節點的功能。匯入後選取該項目,將它設為目前伺服器或使用中的節點,實際名稱依介面而異。清單中反白的項目不一定就是正在使用的節點。可從用戶端狀態或本次連線的記錄確認實際選取的節點,不必逐一測試多次匯入後的同名項目。

瀏覽器先使用系統代理,其他應用程式再視需要使用 TUN

先從系統匣選單將系統代理切換為「自動設定系統代理」或相同功能的選項,再用會讀取系統代理設定的瀏覽器發出新請求。系統代理會將本機代理位址提供給應用程式,但不會直接接管所有處理程序。有獨立網路設定的工具可能仍會直接連線;瀏覽器也可能受既有擴充功能、管理政策或獨立代理設定影響。只要目標應用程式允許手動指定代理,就能先單獨測試,不必立刻改變整台電腦的流量接管方式。

確實需要透過虛擬網卡接管流量的應用程式,再單獨測試 TUN。先記下原本的模式,關閉測試應用程式的手動代理,並依用戶端目前介面的提示處理權限。啟用後確認虛擬介面和相關路由已建立,再分別測試一般連線、區域網路連線,以及原本需要保留的工作連線。TUN 開關顯示已啟用,不代表路由一定設定成功;若失敗,先關閉該模式並查看啟動錯誤,別反覆授權或重新啟動。

檢查系統匣背景程式與連接埠占用

關閉主視窗後,v2rayN 可能仍在系統匣背景執行。升級或切換 Desktop、WPF 版本時,先從舊程式選擇退出,再開啟新版本。若記錄顯示本機連接埠無法繫結,先從設定查看錯誤所指的連接埠,並確認是否有舊用戶端或其他本機服務正在監聽。不要任意結束不認識的處理程序。若必須變更連接埠,也要同步更新瀏覽器或工具中儲存的手動代理位址。

用戶端已退出卻突然無法上網時,先查看系統代理設定是否仍指向本機位址,再確認該連接埠是否仍有程式監聽。這類故障看似整台電腦都斷網,實際上可能只是應用程式仍在嘗試連線到已關閉的本機代理。若只有某個程式無法恢復,重新開啟該程式再測一次;它可能仍沿用舊連線。確認本機設定已還原後,再判斷遠端節點或網路是否另有問題。

03桌面設定

macOS:依晶片選擇套件、安裝應用程式與設定代理

從「關於這台 Mac」選擇磁碟映像檔

從 Apple 選單開啟「關於這台 Mac」。裝置資訊若顯示 Apple 晶片,請前往macOS 下載區選擇適用於 Apple Silicon 的 arm64 套件;若顯示 Intel 處理器,則選擇 x64 套件。判斷晶片時優先參考系統資訊,不要依模擬環境中的終端機輸出判斷。若不確定,也別連續安裝兩個套件;兩個同名應用程式可能讓後續的啟動路徑和代理狀態更難辨認。

開啟下載的磁碟映像檔,依視窗指示將應用程式拖曳到「應用程式」資料夾,從該資料夾啟動後再退出磁碟映像檔。不要長期從映像檔視窗執行,也不要將兩份同名應用程式分別放在下載資料夾和「應用程式」資料夾。取代舊版前,先從選單列或應用程式選單完整退出舊程式。若系統拒絕開啟,先確認是架構不符、系統版本不符還是管理限制,不要一次取消所有應用程式保護。

使用群組管理訂閱,確認本機權限範圍

啟動 v2rayN 後,從訂閱功能新增群組,將完整網址貼到網址欄,為群組設定容易辨認的名稱,再手動更新。使用多個桌面空間或應用程式視窗時,先確認目前視窗顯示的是新群組,而非所有節點的總覽。只有一個分享連結時,使用剪貼簿匯入到明確的本機群組,方便日後區分自動更新的記錄和需要手動維護的項目。

要移轉舊電腦上的訂閱,優先使用原訂閱網址重新建立群組,再匯入少量確定需要保留的手動節點。避免直接取代整個應用程式設定資料夾:舊系統中的本機路徑、連接埠、權限和核心選項未必適用於新裝置。第一次啟動時若程式詢問是否允許某項操作,先確認涉及的是網路流量接管還是本機檔案存取,只授予目前需要的功能權限,並記下授權後的變更。

透過網路服務檢查系統代理

透過用戶端啟用系統代理後,可在「系統設定 → 網路」開啟目前使用的網路服務,並查看詳細資訊中的代理設定。切換 Wi-Fi 和有線網路時,請留意兩者可能使用不同的服務,代理狀態也不一定會沿用。若看到本機迴路位址,還要確認連接埠與用戶端目前公告的本機監聽連接埠一致;系統設定可能仍保留舊連接埠,但它無法替新的處理程序接收請求。

若只有某個應用程式連線失敗,先確認它是否讀取系統代理,再決定是否使用 TUN。若目前版本已提供並支援 TUN,請依介面流程啟用,先停用可能衝突的本機代理程式,再測試一般網頁、內部網路連線,以及電腦從睡眠喚醒後的狀態。如果用戶端顯示權限或路由設定失敗,先切回系統代理觀察基本連線,不要反覆切換開關來代替查明錯誤原因。

處理喚醒、網路切換與殘留代理設定

電腦進入睡眠時,網路設備可能已中斷舊連線;喚醒後,電腦也可能改用另一個網路服務。若網頁一直載入,先確認目前網路可正常連線,再透過用戶端重新建立連線,並發出新的請求。舊分頁、長時間下載和背景同步程序可能仍在使用舊連線,不能據此判斷新請求也失敗。若問題反覆發生,記下是否只在網路切換或喚醒後出現。

清除用戶端的系統代理後若仍無法存取區域網路,檢查目前網路服務是否設定代理指令碼、手動代理或特殊排除項目,並確認是否仍有其他網路工具正在執行。公司或學校設定的項目應予保留;只有本次安裝新增的設定,才依原紀錄撤回。還原後先測試本機服務,再測試網際網路;若本機服務仍無法連線,先檢查本機網路路徑,不要試圖更換遠端節點來修復。

04桌面設定

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

確認發行版與系統架構相符

前往Linux 下載區選擇 v2rayN。Debian 系發行版通常選 deb;Fedora 等採用相應套件管理系統的發行版則選 rpm。格式相符只是第一步,還要確認發行版版本、相依套件和桌面環境。不要只把兩種格式當成副檔名,也不要為了強行安裝而使用轉換工具改包。手邊只有終端機時,可用下列唯讀指令了解目前系統。

cat /etc/os-release
uname -m

/etc/os-release 提供發行版相關資訊,uname -m 顯示目前核心辨識到的機器架構。常見輸出 x86_64 對應 x64,aarch64 對應 arm64。若在容器、虛擬機或混合架構環境中操作,還要確認實際安裝目標所使用的套件管理器架構。例如 Debian 系統可執行 dpkg --print-architecture 查看,不要把主機的結果當成客體系統的結果。

從目前的桌面工作階段啟動,再匯入訂閱

使用系統軟體安裝程式開啟相符的本機套件,查看相依性提示後完成安裝。若安裝失敗,先確認缺少的套件名稱、架構衝突或發行版版本限制。若顯示「安裝完成」卻找不到視窗,從應用程式選單嘗試啟動,並確認目前使用的是可用的圖形工作階段。透過遠端終端機呼叫圖形應用程式,和在已登入使用者的桌面中啟動,顯示介面與代理設定不一定相同。

正常啟動後,從訂閱選單建立群組並更新,確認節點清單中已出現節點;單一分享連結則使用剪貼簿匯入。請以平常登入桌面的使用者執行應用程式。若只為了開啟介面而使用管理員身分啟動,設定可能會寫入不同的使用者目錄,之後以一般帳戶開啟時就像資料遺失。確實需要提升權限的網路功能,應使用用戶端支援的授權方式處理,不要長期以提升權限執行整個圖形介面程式。

測試桌面代理與終端機代理的差異

桌面環境中的系統代理是供應用程式讀取的設定,但不同桌面或程式不一定採用相同介面。瀏覽器可能遵循桌面設定,終端機中的指令則可能只接受自己的參數或環境變數。先確認用戶端的本機 HTTP 或混合代理已開始監聽,再透過單次指令明確指定代理;不要只為測試一次連線,就把代理寫入終端機啟動檔。下方範例會提示輸入用戶端設定中顯示的本機 HTTP 或混合代理連接埠。

printf '本機 HTTP 或混合代理連接埠:'
read -r proxy_port
curl --noproxy '' --proxy "http://127.0.0.1:${proxy_port}" \
  --max-time 15 --head https://example.com/

這個指令適用於本機代理透過迴路位址提供 HTTP 連線的情況。若設定顯示的是僅提供 SOCKS 的監聽埠,應選用相應協定的參數,而不是直接把連接埠代入這個指令。若明確指定代理的請求成功,但一般程式仍失敗,先檢查該程式的流量接管方式和自身代理設定。指令收到目標回應,只能證明這次請求有可用路徑;是否經過遠端節點,還要比對用戶端記錄中的分流結果。

啟用 TUN 前檢查權限、介面與舊設定

準備啟用 TUN 時,先確認執行環境支援虛擬網路介面,且目前版本支援此模式。容器與受管理環境即使能開啟用戶端,也不一定允許建立介面或修改路由。用戶端若回報權限或介面錯誤,先切回已確認可用的系統代理,再確認部署環境允許的權限。不要盲目複製會修改系統能力的指令,也不要把關閉防火牆當作第一個排查步驟。

若啟用成功,但個別終端機或服務仍異常,檢查它是否保留舊的代理環境變數,或是否在自己的網路命名空間中執行。關閉 TUN 後,分別使用新的終端機和瀏覽器視窗重新測試。若新工作階段可用、舊工作階段不行,問題可能出在處理程序繼承的環境;若同一桌面上的應用程式都無法使用,再確認目前介面、路由和解析設定是否已如預期還原。

05行動裝置設定

Android:安裝 v2rayNG 與 VPN 流量接管

依需求選擇用戶端與安裝套件

前往Android 下載區。一般情況優先選用 v2rayNG,它採用 Xray 核心;明確需要 V2Fly 核心的設定再考慮 v2flyNG。支援 arm64 應用程式的裝置選擇 arm64 套件;若不確定系統支援哪種應用程式架構,可考慮同一用戶端的通用套件。通用套件能支援更多架構,但不會解除系統版本限制,也無法解決既有應用程式的簽章衝突。

下載完成後,從檔案管理員或瀏覽器開啟安裝套件,依系統提示只授予本次安裝所需來源必要權限,之後可撤銷。更新時優先使用與現有應用程式相同發行來源的套件。若系統拒絕覆蓋安裝,先確認是簽章不同、版本不允許覆蓋、儲存空間不足,還是裝置管理政策所致。不要一開始就解除安裝舊版;解除安裝可能同時清除訂閱、手動節點和每個應用程式的設定,應先備份需要保留的資料。

新增訂閱或掃描單一節點 QR Code

開啟用戶端,在訂閱群組設定中新增項目,填入備註和網址,儲存後返回節點清單並更新訂閱。更新完成後,確認目前查看的是目標群組,避免被其他群組的舊節點誤導。第一次匯入時先保留預設設定,只選一個節點作為測試基準。若桌面上能更新網址,手機卻不行,記下手機目前使用 Wi-Fi 或行動數據,不要先刪除桌面上已成功的訂閱。

收到單一節點連結時,先複製再使用剪貼簿匯入;收到 QR Code 時,使用用戶端提供的掃描或圖片匯入功能。QR Code 和設定文字一樣可能包含憑證,不適合留在共用相簿中。若無法辨識,先檢查圖片是否遭裁切、壓縮或反光,再確認 QR Code 的用途。更新訂閱群組和掃描匯入是兩種不同操作;掃描單一節點不會自動建立訂閱關係。

了解系統 VPN 授權與應用程式範圍

選取節點後啟動連線,系統通常會顯示 VPN 連線確認畫面。這項授權會讓用戶端接管指定流量,和在電腦上填入系統代理位址不同。確認後先查看用戶端狀態和系統 VPN 標示,再用瀏覽器發出新請求。系統標示代表接管服務已建立,不代表遠端一定可用,也不能證明所有應用程式都已納入接管範圍。若標示一閃即消失,先確認服務是否被其他 VPN 或系統政策取代。

若用戶端提供按應用程式代理功能,請把它視為接管範圍設定,而非節點選擇。先確認介面採用的是「僅包含所選應用程式」還是「排除所選應用程式」,再進行設定。瀏覽器出現在清單中,不代表下載管理工具或以獨立處理程序執行的應用程式也在清單內。排錯時先回到明確的接管範圍,只用一個瀏覽器驗證;確認設定無誤後,再加入原有清單。永久 VPN 或禁止未經 VPN 連線的設定可能影響復原測試,調整前先記下原設定。

分辨網路切換、背景限制與裝置政策

若只在螢幕關閉後中斷,先確認再次喚醒後 VPN 服務是否仍在執行,再回想是否啟用了系統背景限制或省電政策。只有問題反覆發生並確實影響使用時,才依裝置設定為該用戶端調整相應權限。不必關閉整台裝置的省電保護。若已連線但無法切換到行動數據,先中斷舊連線並重新建立一次,再用新請求判斷問題出在連線復原還是目前網路本身無法連線。

在學校、公司或受管理的裝置上,系統可能限制應用程式安裝、背景啟動或 VPN 使用。這些限制與訂閱是否有效無關,應依裝置管理要求處理。若已切換 Wi-Fi 和行動數據,但兩種網路都只有特定應用程式無法使用,回頭檢查按應用程式設定的清單、應用程式本身的代理設定和路由規則;若連 VPN 服務都無法建立,先處理本機授權或衝突的 VPN,再檢查節點。

06設定驗證

連線檢查:從本機監聽到路由命中

將一次網路連線拆成四個檢查點

第一步是確認核心能否啟動。桌面端查看本機代理連接埠是否開始監聽;行動端則確認系統流量接管服務是否已建立。第二步是確認測試應用程式的請求是否進入用戶端:發出新請求並查看記錄,不要只看介面上的連線按鈕,也不要只看節點清單中的單次測試結果。用戶端未收到請求時,換遠端節點通常不會改變結果,應先修正應用程式的流量接管設定。

第三步是確認請求符合哪條路由,以及實際採用代理、直連還是攔截。第四步才是檢查目標是否有回應。單一網頁可能載入多個網域,主要文件、圖片、指令碼或登入介面套用的規則不一定相同。先選擇請求入口明確、不依賴多個第三方網站的目標進行驗證,再回到原本的應用程式。測試目標應貼近日常使用情境,但不必拿自己的帳戶頁面或實際訂閱網址當範例。

依據觀察結果縮小故障範圍
檢查層級可觀察到的狀況優先檢查項目
啟動核心已退出或介面尚未建立設定錯誤、連接埠、授權
流量接管測試應用程式沒有請求記錄記錄等級、代理模式、應用程式範圍
流量分流請求已進入用戶端,但走錯出口比對條件、規則順序、預設出口
出站連線出口符合預期,但沒有回應節點連線、解析、傳輸與安全設定

分清系統代理、全域路由與 TUN

「系統代理」描述應用程式如何找到本機代理;「全域」通常表示已進入用戶端的流量會採用哪種出口。兩者不是同一個開關。即使選擇全域路由,不讀取系統代理的處理程序也可能根本沒有進入用戶端。TUN 透過系統虛擬網路介面接收符合路由條件的流量,涵蓋範圍通常較廣,但仍可能受排除規則、系統能力和其他網路服務限制。

初次驗證時,別同時變更三種設定。先依照系統代理設定步驟測試一種確定會讀取代理的應用程式,再依實際需求決定是否改用 TUN。切換時先讓前一種流量接管方式恢復預期狀態,避免啟用虛擬介面後,應用程式仍手動連到舊連接埠。比較時維持相同節點、測試目標和網路,只改變流量接管方式,才能看出差異。

檢查規則順序、網域與位址

依介面提供的方式查看路由規則和預設出口。依序比對的規則清單通常採用第一個符合條件的項目;範圍較廣的條件若排在前面,可能會先攔截原本應交由後續精確規則處理的請求。某條規則選擇直連或代理,也取決於規則指定的出口。排查時不要先刪除所有項目,先用一個明確的測試請求確認命中條件,再調整真正影響該請求的規則。

網域規則適合依主機名稱分類流量,位址規則則針對特定位址或網段。能否取得網域名稱、是否先將網域解析為位址,都取決於應用程式提交的目標和核心策略。透過網域存取服務,與直接連線到該服務的位址,不一定會符合相同規則。若只有部分網站受到影響,先查看實際請求的目標,別只參考瀏覽器分頁標題。修改規則前可先匯出目前的路由設定,以便還原原有順序。

分開處理資料庫、名稱解析與節點更新

GeoSite 是網域分類資料,GeoIP 則是位址分類資料。使用這些分類時,規則會依賴核心實際載入的資料庫和現有項目。更新資料庫和更新訂閱互不取代:前者更新規則比對所用的資料,後者更新節點清單。若規則仍在但找不到分類項目,先確認是否使用正確的資料庫,以及目前核心是否能讀取;不要把更新後的資料檔隨意放進任何舊資料夾。

網域無法解析時,不必立刻更換所有解析設定。先判斷無法連線的是訂閱服務、節點伺服器,還是測試目標,再確認問題發生在應用程式、系統或核心端。有些應用程式使用自己的解析方式;系統解析正常,不代表該應用程式也正常。先記錄狀況,每次只調整一項再重新測試。若對路由資料格式有疑問,請參閱GeoIP 與 GeoSite 資料庫更新說明。

07故障排除

常見設定問題與復原方法

先確認最近一次變更

從最後一次正常使用的時間點開始回想:是否升級了用戶端、替換核心、修改訂閱、切換 Wi-Fi,或調整系統代理。分別記下最後一次變更和首次故障的時間。若能復原,優先撤回最近一項變更,再用原節點和原測試目標重新檢查。同時解除安裝、修改解析設定和重設路由,即使偶然恢復,也很難判斷下次遇到同類問題該如何處理。

依問題狀況選擇檢查方式

訂閱更新失敗,應先檢查網址還是節點?

先檢查訂閱網址和取得訂閱的連線路徑。確認原始網址是否完整,尤其留意複製時是否混入空格、換行或句尾標點。登入頁、錯誤頁和空白回應都可能看起來下載成功,卻無法解析成設定。依用戶端提供的錯誤資訊,區分請求未送達、伺服器拒絕存取和內容格式不符,再考慮更換更新路徑。

若舊群組中還有節點,先保留它們。舊節點仍能連線,不代表訂閱仍可更新;訂閱更新失敗,也不代表所有舊節點都已失效。只有目前網路能直接連上訂閱服務時,不透過代理更新才有用。若需要透過既有連線,先用保留的可用節點恢復代理,再嘗試更新。若兩種連線方式都遭拒,請確認網址是否仍有效及存取條件,不要反覆貼上或公開網址求助。

節點已匯入,為什麼仍無法連線?

先確認已將該節點設為目前使用的節點,並且用戶端已開始連線。若核心一啟動就退出,根據錯誤訊息檢查設定欄位、檔案路徑或本機連接埠;若只有發出請求時逾時,再確認問題出在節點位址解析、遠端連接埠是否可連,還是交握失敗。清單中的節點測試和實際應用程式請求可能採用不同路徑,不要把測試圖示當成最終判斷依據。

若只有某個節點出現交握錯誤,請核對來源設定所指定的協定、傳輸方式、安全設定和伺服器名稱,並確認系統時間正確。只修改連接埠或啟用忽略憑證錯誤,無法確認原因,還可能讓問題更難排查。若同一訂閱中的另一個節點,在相同網路和模式下能正常運作,先保留這組對照,再檢查個別節點,不必重新安裝用戶端。

為什麼瀏覽器能上網,其他應用程式卻不行?

先確認發生問題的應用程式是否使用系統代理,或是否設定了自己的代理。桌面軟體可能使用獨立網路設定,終端機也可能保留上一個工作階段寫入的環境變數。行動裝置還要確認該應用程式沒有被排除在流量接管清單之外。將應用程式完全結束後重新開啟並發出請求,同時查看用戶端是否收到相應請求。

若記錄中看得到請求,接著檢查命中的路由和目標回應;若沒有記錄,先確認記錄等級,再判斷流量接管範圍。若應用程式可單獨設定代理,先使用本機位址進行可還原的測試。確有需要時才切換到 TUN,並保留可隨時還原的舊設定。單一應用程式失敗不代表系統代理設定有誤,也不必將正常運作的應用程式一起切換到其他模式。

升級或更換裝置後,如何還原群組和路由?

先開啟備份並區分三類內容:可透過訂閱重新取得的節點、另外儲存的手動連結,以及與本機相關的入站和路由設定。新裝置先用最精簡的設定完成連線檢查,再逐步移轉。訂閱群組可用原網址重建;手動節點逐一匯入;涉及本機連接埠、虛擬介面或特定核心的路由,則應依新裝置重新設定。

不要將整份舊設定直接覆蓋到另一種用戶端。即使兩邊都能辨識部分節點,對預設出口、按應用程式設定的清單和資料檔路徑也可能有不同預期。若有多個訂閱並存,可先依來源整理,再參閱訂閱群組與節點篩選指南移除重複項目。確認設定可正常使用後,保留一份能正常啟動的備份,再移除舊設定。

退出後無法上網:還原本機設定

用戶端已退出,但所有瀏覽器都無法上網時,先確認代理是否仍指向本機連接埠。只撤回本次新增的代理設定,並還原原本的手動代理、自動設定指令碼或直接連線狀態。使用過 TUN 的裝置,還要確認虛擬介面是否仍被舊處理程序占用。手機則檢查系統 VPN 是否仍顯示已連線、是否啟用禁止未經 VPN 連線的選項,以及這些設定是否由裝置管理員控制。

還原後使用兩個不同目標測試:一個平時可連線的本機服務,再加上一個穩定的網際網路目標。先確認網路已恢復,再考慮重新開啟用戶端。若不同平台在同一網路下都無法連線,但改用另一個正常網路後就能使用,請記錄切換網路前後的結果,別先懷疑每台裝置的安裝套件。尋求協助時,提供平台與架構、用戶端及介面類型、流量接管方式、錯誤類型和已完成的對照測試,避免貼出完整記錄。

下載用戶端