通用準備:平台、訂閱與設定備份
先分清用戶端、核心與節點
v2rayN 負責桌面端的節點清單、訂閱管理、代理入口與核心執行;v2rayNG 與 v2flyNG 則提供 Android 端的圖形操作介面。核心負責解析協定、執行路由與建立連線,節點則是一組遠端服務參數。安裝用戶端不會自動取得可用節點。開始前請準備有效的訂閱網址、分享連結或完整設定,並確認資料來自有權使用的服務。
桌面平台建議優先選用 v2rayN。Android 端可先從採用 Xray 核心的 v2rayNG 開始;若已有 V2Fly 設定需求,再考慮 v2flyNG。協定名稱相同,不代表所有擴充欄位都能互通;傳輸方式、安全層參數與核心支援能力都必須相符。匯入成功卻無法連線時,先確認設定要求使用哪種核心,不要反覆安裝不同用戶端。
安裝檔也必須符合處理器架構。本頁的 Windows 說明適用下載頁提供的 x64 桌面版與 WPF 版;macOS 須區分 Apple Silicon 與 Intel;Linux 須同時確認架構和套件格式;Android 則有 arm64 與通用版可選。作業系統、處理器架構和應用程式介面類型是不同條件,不能只因檔名出現自己的系統名稱就認定適用。
檢查訂閱資料與本機環境
訂閱網址通常含有存取憑證,請比照帳號密碼妥善保管。複製時確認網址前後沒有空白、換行或通訊軟體自動附加的標點;分享截圖時,請遮住網址、使用者識別資訊與節點認證欄位。訂閱更新失敗也可能只是網址過期或伺服器回傳網頁,不能只憑狀態列的失敗提示就判定軟體損壞。記下錯誤摘要即可,請勿將完整私人網址貼到公開討論區。
開始連線前,確認系統日期、時間與時區正確,並啟用系統的自動校時。憑證驗證和部分協定交握都依賴正確時間,時間偏差過大可能導致安全連線失敗。接著確認基礎網路可正常連線至本地服務、是否需要先完成網路登入,以及系統中是否已有其他代理或虛擬網卡程式在執行。首次測試只保留一種流量接管方式,方便確認請求實際經過的路徑。
訂閱、分享連結與原生 JSON 是不同的輸入格式。訂閱通常用於批次更新節點;分享連結通常描述單一節點;原生 JSON 則可能包含完整的入站、出站、路由與 DNS 結構。請使用用戶端對應的匯入功能,不能把完整設定當成訂閱網址來更新。格式差異可參閱訂閱格式與分享連結比較。
| 平台 | 用戶端與選擇安裝檔的重點 | 流量接管方式 |
|---|---|---|
| Windows | v2rayN,x64 桌面版或 WPF 版 | 系統代理;支援時可設定 TUN |
| macOS | v2rayN,依晶片選擇 DMG | 系統代理;支援時可設定 TUN |
| Linux | v2rayN,確認架構與 deb / rpm 格式 | 桌面代理設定或支援的 TUN |
| Android | v2rayNG / v2flyNG,arm64 或通用版 | 系統 VPN 授權 |
建立可還原的最簡設定
首次設定只需一個有效節點、一種流量接管方式,以及明確的路由模式。先不要加入自訂 DNS、複雜規則或應用程式分流。分別確認訂閱更新、節點連線和瀏覽器存取正常,再逐項增加設定。如此每次變更都有前後比較,遇到問題時也能還原至先前可用的狀態,避免多個選項同時變動而無從排查。
升級或搬移設定前,請使用用戶端提供的備份或匯出功能儲存設定;若需手動備份,先完全結束用戶端,再複製實際使用的設定目錄。不同安裝方式的資料位置可能不同,請從介面或日誌確認,不要依照網路上的舊路徑覆蓋檔案。備份應包含訂閱群組、路由設定及必要的自訂設定,並限制備份檔案的存取權限,避免節點憑證外洩。
Windows:安裝 v2rayN 與設定系統代理
選擇桌面版或傳統 WPF 版
請從Windows 安裝檔下載入口選擇 v2rayN。桌面版採用新一代跨平台介面,WPF 版則保留傳統桌面操作方式;兩者並不代表不同的節點服務。熟悉哪種介面就選哪種,首次安裝可先試用桌面版。下載頁提供 x64 版本,安裝前請在系統資訊中確認處理器架構,並確認目前系統符合該版本的執行需求。
執行安裝程式後,依介面指示選擇安裝位置。若下載的是需解壓縮後執行的版本,請先完整解壓縮至固定資料夾,再啟動主程式;不要直接從壓縮檔預覽中執行。盡量不要將資料夾放在暫存下載位置,也不要只複製主程式而漏掉隨附資源。缺少核心、規則資料或執行相依元件時,介面可能仍可開啟,但開始連線時仍會失敗。
一般系統代理測試一開始不需要長期使用系統管理員權限。請先以一般使用者身分啟動,確認日誌能否建立監聽連接埠、讀取設定並啟動核心。如果系統安全提示封鎖某個元件,先確認提示中的檔案和操作來源,不要直接關閉整套安全功能。TUN 操作若確實需要較高權限,請個別處理,不要用提高權限來掩蓋路徑錯誤或連接埠衝突。
匯入訂閱並建立首次連線
在訂閱管理區新增群組,填入容易辨識的備註與完整網址,儲存後再更新該群組。不同介面的選單名稱可能略有差異,但新增項目和取得節點通常是兩個步驟。更新完成後,確認群組內是否出現節點,並查看日誌有沒有認證失敗、解析失敗或回傳格式不符等訊息。不要把空白群組誤認為已完成訂閱匯入。
從新群組選擇節點,設為目前使用的設定後進行實際連線測試。延遲測試只代表探測路徑有回應,不等於協定交握、目標網站存取與 DNS 都正常。優先使用測試可完成的節點,並記下名稱與協定類型。如果整個群組都失敗,請檢查訂閱是否有效及系統時間;若只有單一節點失敗,先改測同群組的其他節點,不要直接重設全域設定。
啟動核心後開啟系統代理,讓遵循系統設定的應用程式將流量送至本機監聽位址。代理模式的實際名稱依目前介面為準,重點是確認代理已套用至系統,且用戶端仍在執行。接著用瀏覽器開啟已知可用的測試頁面,搭配出口位址檢查和用戶端日誌,確認請求是否經過預期的出站。詳細驗證方式請參閱首次連線與代理生效驗證。
系統代理的限制與 TUN 故障排除
系統代理不會強制接管所有程式。部分命令列工具、遊戲或獨立網路元件需要另外設定代理;瀏覽器擴充功能也可能覆蓋系統設定。若瀏覽器可用但某個應用程式連線失敗,先確認該程式是否讀取系統代理、使用哪種傳輸方式,以及是否有自己的網路設定。不要因為單一應用程式未使用代理,就判定目前節點完全無法使用。
若確實需要接管更多流量,再確認目前的 v2rayN、所選核心與系統環境是否支援 TUN。啟用前記下系統代理狀態和原有網路設定,依提示完成必要的權限或元件設定。先停用其他虛擬網卡接管程式,再測試區域網路、網域解析與目標連線。TUN 是流量進入用戶端的方式,最後採用直連或代理仍由路由設定決定。
結束程式後若網路異常,先檢查 Windows 手動代理是否仍指向已關閉的本機連接埠;還原原本設定後再測試。若連接埠遭占用,請從日誌找出實際連接埠,關閉重複執行的用戶端或調整本機監聽設定,不要修改遠端伺服器連接埠。升級後規則遺失、啟動路徑變更和開機自動啟動失效,也應分別檢查,不要一概當成節點故障。
macOS:依晶片選擇安裝檔與網路權限
依晶片安裝 v2rayN
開啟系統的「關於這台 Mac」查看晶片資訊,再前往macOS 安裝檔下載入口選擇相符的 v2rayN。Apple Silicon 使用 arm64 版本,Intel 使用 x64 版本;不要依電腦外觀、購買年份或裝置名稱猜測架構。架構選錯可能導致無法啟動、需要相容執行環境或元件異常。遇到這些狀況,先確認下載的版本,不要急著修改訂閱。
開啟 DMG 後,依安裝介面指示將應用程式移至「應用程式」資料夾,再從固定位置啟動。不要長期從已掛載的安裝映像執行,否則退出映像、清除下載檔或重新登入後,原本的啟動路徑可能失效。首次啟動若出現系統安全提示,先確認應用程式來源與檔案是否相符,再依系統提供的流程允許開啟,不必關閉全域安全性設定。
應用程式能顯示視窗,不代表所有網路權限都已設定完成。修改系統代理、執行背景元件及啟用 TUN 接管,可能要等到實際啟用時才會要求授權。請先閱讀權限提示的範圍,再依目前功能逐項授權;若先前曾拒絕請求,請到系統設定檢查相關項目。不要反覆點選啟動來取代授權,也別把權限對話框中的錯誤誤判為遠端節點無法連線。
訂閱、系統代理與連線驗證
進入訂閱管理新增群組並儲存網址,接著更新群組,確認節點清單確實已更新。跨裝置複製網址時,請留意剪貼簿內容是否帶有換行或空格;若同一網址在其他裝置可用,本機卻沒有節點,先檢查更新日誌與目前網路的存取條件。匯入分享連結時請使用對應入口;完整原生設定則須透過用戶端支援的自訂設定流程處理。
選擇節點並啟動核心,先確認連線測試成功,再開啟系統代理。macOS 的代理設定會依網路服務而異,Wi-Fi、有線網路及其他服務可能各自保存設定。切換網路後行為有變,請檢查目前實際使用的網路服務,不要只看其他介面的代理開關。用戶端顯示已啟用,也應與系統目前使用的網路設定交叉確認。
瀏覽器是否使用系統代理,也取決於瀏覽器本身的設定。測試時暫時停用會接管代理的擴充功能,保留一條明確的流量入口,再開啟已知可連線的頁面並查看日誌。網頁載入成功不代表所有流量都經過接管,因為頁面可能是透過直連成功載入。需要使用代理的目標,應搭配路由日誌與出口資訊判斷,不必要求所有網站都顯示相同出口。
TUN、休眠與網路服務切換
若應用程式不遵循系統代理,可依目前用戶端與系統支援的範圍考慮使用 TUN。啟用前先檢查是否已有其他網路過濾器、虛擬網卡或通道功能占用接管路徑,避免同時接管預設路由。完成授權後,先測試基本網域解析,再確認目標連線與區域網路存取。啟用後若整台電腦都無法上網,先關閉 TUN,還原至系統代理的基準狀態,再檢查路由與 DNS 設定。
電腦從休眠喚醒,或從有線網路切換至無線網路後,原有連線可能失效,但本機監聽仍在運作。此時先確認基礎網路已恢復,再重新啟動目前連線或核心,不必立刻刪除訂閱。若只有解析失敗,查看系統 DNS 與用戶端 DNS 實際使用的路徑;若所有連線都逾時,再檢查節點是否可連線、網路是否已登入,以及是否有失效的路由接管設定殘留。
搬移設定時,優先使用用戶端的匯出與匯入功能,不要直接用另一台裝置的整個執行目錄覆蓋本機應用程式。不同架構的可執行元件無法互換,設定中的絕對路徑也可能失效。升級前保留訂閱、路由與自訂設定的副本;升級後依序檢查核心啟動、系統代理及必要權限。完全結束用戶端時,也要確認代理已還原,避免系統繼續連線至已停止的本機服務。
Linux:套件格式、桌面代理與權限
確認發行版套件格式與架構
請從Linux 安裝檔下載入口選擇 v2rayN。採用 deb 套件體系的發行版請選擇對應 deb 套件,採用 rpm 套件體系的發行版則選擇對應 rpm 套件,並確認是 x64 還是 arm64。桌面環境名稱無法決定套件格式,處理器品牌也不能取代架構確認。請先從系統資訊確認發行版與架構;若需透過命令列輔助,可使用下列唯讀命令,不會變更系統設定。
uname -m
cat /etc/os-release
x86_64 通常對應下載頁的 x64,aarch64 通常對應 arm64。確認後,使用圖形化軟體安裝程式開啟下載的套件,依提示處理相依套件並完成安裝。套件格式正確仍可能受系統程式庫版本限制,請仔細查看安裝程式顯示的相依套件錯誤。不要為了消除提示而強制忽略相依性,也不要將其他架構的套件當成目前系統的替代品。
安裝完成後,從應用程式選單啟動 v2rayN,先確認圖形介面、設定寫入與核心啟動都正常。不同桌面工作階段的系統匣支援可能不同;關閉主視窗後,應透過程序與日誌確認程式狀態,不能只看有沒有系統匣圖示。若介面無法啟動,先處理執行相依元件或圖形工作階段問題;這類故障發生在讀取節點之前,與訂閱內容無直接關係。
匯入訂閱與桌面代理的限制
新增訂閱群組、儲存網址並執行更新,確認取得節點後再選擇目前使用的設定。Linux 上尤其要分清圖形用戶端和終端機所處的網路環境:終端機可連線至訂閱網址,不代表圖形應用程式也會沿用相同的代理環境變數。更新失敗時,請查看用戶端日誌,確認它實際採用直連、系統代理或其他已設定的入口,避免形成依賴自身監聽連接埠的循環。
啟用系統代理後,請在桌面網路設定中檢查實際寫入的主機、連接埠與略過清單。不同桌面環境的系統代理實作方式不盡相同,部分應用程式只讀取自身設定或啟動時繼承的環境變數。瀏覽器可用但終端工具無法連線時,應檢查終端工具支援代理的方式;反過來,終端機已設定代理也不代表整個桌面工作階段都已接管。
本機 HTTP 與 SOCKS 入口請依用戶端實際顯示的連接埠設定,不要照抄他人的連接埠號碼。應用程式要求 SOCKS 時,不能直接填入 HTTP 位址;採用遠端解析或本機解析,也取決於應用程式使用的協定與設定。首次驗證只測試一個應用程式和一種入口,確認請求出現在日誌後再擴大範圍,避免同時修改桌面代理、終端機環境變數與用戶端路由。
TUN 權限與多網路介面
TUN 通常需要建立虛擬介面並修改路由的權限,能否使用取決於目前的 v2rayN、核心與系統環境。優先依照用戶端提供的權限設定流程操作,不要長期以高權限執行整個圖形程式。權限不足、裝置節點無法使用與路由衝突是不同故障,請根據日誌所示的具體階段判斷。容器、受限工作階段或客製系統的網路能力也可能與一般桌面環境不同。
同時使用有線、無線、容器網路或虛擬機器時,請確認是否有必須直連的區域網路位址。接管預設路由後,原本的區域網路存取路徑可能改變;如有需要,應在路由中為相關私有網段設定明確策略,不要直接停用整個系統防火牆。DNS 也可能由系統解析服務、網路管理員或其他元件管理;手動修改設定前,先確認目前由哪個服務負責管理。
停止用戶端後,若命令列仍無法連線,請檢查終端機工作階段是否殘留指向本機連接埠的代理環境變數;若只有桌面應用程式失效,則檢查桌面代理是否仍啟用。升級後優先重新確認安裝相依元件、設定目錄權限與規則資料路徑。搬移設定時不要複製舊架構的核心檔案;解除安裝前也要先還原網路接管設定,避免刪除程式後留下無法使用的代理入口。
Android:匯入訂閱與 VPN 流量接管
選擇 v2rayNG 或 v2flyNG
請從Android 安裝檔下載入口選擇用戶端。v2rayNG 採用 Xray 核心,是本頁優先推薦的 Android 用戶端;v2flyNG 採用 V2Fly 核心,適合已有相應設定需求的情況。兩者的設定介面與核心支援能力並不完全相同,尤其是含有特定擴充欄位的設定,請先確認目標核心能否解析這些欄位。分享連結可以匯入,不代表一定能成功連線。
主流 arm64 裝置建議優先選擇 arm64 套件;若不確定處理器或系統架構,先查看系統資訊,再考慮通用版。處理器支援某種架構,不代表系統使用者空間也採用相同架構。安裝程式若顯示解析失敗,先確認套件是否適用於裝置、系統需求是否符合,以及下載是否完整,再嘗試通用版。請勿將安裝階段的問題與遠端伺服器故障混為一談。
安裝時,依系統提示授予目前下載工具或檔案管理員安裝權限;安裝完成後,可視需要撤銷權限。若覆蓋安裝時出現簽章不符的提示,先確認現有應用程式的來源並備份訂閱與設定,再決定如何搬移;直接解除安裝可能會遺失群組與自訂規則。更新前也請記下目前可用的節點與路由模式,方便更新後以相同條件重新測試。
匯入節點並完成系統授權
複製訂閱網址後,在訂閱設定中新增項目,填寫備註並儲存,再執行更新。分享連結應透過剪貼簿匯入等對應入口處理;若使用 QR Code,也要確認其中編碼的是節點還是訂閱網址。更新後沒有節點,先查看日誌與群組篩選狀態;匯入後只有一個節點也不一定代表失敗,輸入內容可能原本就是單一節點分享連結,而非批次訂閱。
在節點清單中選擇目前使用的節點,啟動連線時,系統會要求 VPN 授權。這裡的 VPN 介面是將裝置流量交給本機用戶端,並不代表遠端節點已確認可連線,也不是桌面系統代理的同名功能。授權後查看用戶端狀態與日誌,再開啟目標頁面驗證。系統狀態列出現連線圖示,只能表示介面已建立,不能取代協定交握與實際存取測試。
一般使用 Android VPN 通常不需要額外取得系統層級的控制權限,但同一使用者環境通常無法同時由兩個一般 VPN 應用程式接管流量。啟動本用戶端前,先確認是否有其他網路工具正在使用該介面。如果連線按鈕可以啟動,但系統介面很快被其他程式取代,先處理接管衝突,不要在兩個用戶端之間反覆切換節點和 DNS,以免失去穩定的測試條件。
應用程式分流、背景限制與網路切換
需要依應用程式接管流量時,先確認清單選項代表「只代理所選應用程式」還是「略過所選應用程式」。兩種模式正好相反,選取同一個應用程式會有不同結果。修改後依用戶端要求重新建立連線,再於目標應用程式中測試;既有長連線可能仍沿用修改前的路徑。也要確認測試用的瀏覽器是否在清單內,否則瀏覽器直連成功或失敗都無法反映節點的實際狀態。
部分裝置會在螢幕關閉或長時間於背景執行後限制應用程式。若螢幕亮起時可用、熄屏後斷線,先查看系統的電池最佳化、背景執行與自動啟動設定,再確認用戶端是否持續維持連線。系統常駐通知與 VPN 圖示可供判斷狀態,但仍須搭配日誌確認。若啟用「永遠開啟 VPN」或「封鎖未經 VPN 的連線」,節點失效時整台裝置可能無法上網,請先了解這些選項的作用再使用。
從 Wi-Fi 切換至行動網路後,舊連線可能需要重新建立,訂閱更新路徑和 DNS 存取條件也可能改變。先確認目前網路可連線至基本服務,再使用同一節點重新連線;若只有某個應用程式失效,請檢查應用程式分流與自身快取。v2rayNG 和 v2flyNG 的設定匯出檔也應分開保存;搬移時核對協定、安全層與路由欄位,不要因介面相似就認定設定完全相容。
路由與 DNS:從流量入口到出站
先確認接管範圍,再決定出站方式
系統代理、TUN 與 Android VPN 介面決定請求能否進入用戶端;路由規則則決定流量進入後使用哪個出站。啟用 TUN 不代表所有流量都必須走代理,選擇全域代理也無法自動接管未進入用戶端的應用程式。排查時先確認請求是否出現在核心日誌,再檢查符合的規則與出站,避免把入口問題誤認為規則問題。
路由通常依規則順序比對,實際處理方式由所選核心決定。精確的網域例外應排在範圍較廣的集合之前;區域網路規則則應符合實際需求,最後保留明確的預設策略。多條規則涵蓋同一目標時,不要只憑規則名稱推測結果,應檢查比對欄位、先後順序與最後採用的出站。修改規則後也要重新建立測試連線,避免舊連線影響判斷。
以下是 Xray 設定中局部路由的範例,用來說明私有位址直連。這不是完整設定,還需要已有名為 direct 的出站,以及可用的 GeoIP 資料。圖形用戶端可能會自動產生相同設定,建議優先使用內建的路由編輯功能,避免同時修改產生的檔案。若自訂檔案在下次啟動時遭覆寫,請回到負責產生該檔案的設定來源修改。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
網域規則、IP 規則與解析路徑
geosite 用於指定網域集合,geoip 用於指定 IP 位址集合,兩者不是可互換的關鍵字。集合名稱必須存在於目前載入的資料檔中,並符合核心支援的格式。只設定網域規則時,直接以 IP 位址連線的流量未必會符合規則;只設定 IP 規則時,解析結果則可能受 DNS 路徑影響。請依明確需求組合這兩類規則,不要一味堆疊。
DNS 至少要區分應用程式發出的解析、系統解析,以及核心為路由或連線進行的解析。使用系統代理時,應用程式可能先在本機解析網域,再將位址交給用戶端;也可能把網域交由代理端解析,實際方式取決於應用程式與代理協定。啟用某項 DNS 設定不會自動統一所有解析路徑,尤其要確認目標應用程式是否自行使用加密 DNS,或快取了舊結果。
以下展示 Xray 內建 DNS 的局部結構。localhost 代表使用系統解析,queryStrategy 用來限制查詢的位址類型;此範例僅用於說明欄位,並非適用所有網路的通用方案。只查詢 IPv4 可能避開部分位址家族問題,但也會放棄可用的 IPv6 路徑。修改前請確認節點、目標網站與本地網路需要使用哪種位址家族。
{
"dns": {
"servers": ["localhost"],
"queryStrategy": "UseIPv4"
}
}
依存取目標規劃 DNS,不要一味堆疊伺服器
若要依網域類別採用不同解析方式,先明確列出哪些網域應使用本地解析、哪些應經由其他解析路徑,再確認 DNS 請求本身如何出站。將遠端解析位址加入清單,不代表連至該位址的流量已經走代理。若節點伺服器本身使用網域名稱,還要確保連線建立前就能解析該名稱,避免陷入「必須先連上代理才能解析代理位址」的循環。
規則資料更新與訂閱更新的用途不同。訂閱更新節點參數,規則資料則更新網站或位址集合;其中一項更新成功,不會自動修復另一項。若某類網站的分流異常,先測試單一明確網域,確認規則名稱存在、順序正確,以及核心確實載入資料檔。完整操作情境請參閱geosite 與 geoip 路由實戰。
排查 DNS 故障時應依症狀區分:網域解析失敗但已知 IP 路徑正常,優先檢查解析;已取得位址但交握失敗,接著檢查安全層與連線;只有特定網域走錯出站,則檢查規則比對與快取。更換 DNS 後請重新建立連線,並依系統方式清除快取;不要靠停用憑證驗證來維持連線。欄位詳解請參閱Xray DNS 分流解析設定。
常見設定問題:日誌與還原順序
先保留現況,再縮小故障範圍
排錯紀錄至少應包含作業系統、用戶端名稱、所選核心、流量接管方式,以及故障發生的步驟。日誌只截取啟動至故障附近的必要內容,並遮住訂閱網址、認證資訊與私人伺服器資料。先保存目前設定,再一次只調整一個變數;若同時更換節點、重設 DNS、啟用 TUN 並更新規則,即使連線恢復,也很難找出原因,之後還可能再次發生。
查看日誌時,從最早出現的明確錯誤開始,不要只看最後一行的結束提示。設定讀取失敗會導致後續監聽與連線都無法進行;連接埠遭占用會使核心無法啟動;交握錯誤則表示程式已進入後續的連線階段。先將故障歸類為設定、監聽、解析、交握或路由問題,再決定下一步;通常比反覆安裝更能保留有效線索。
下表用來判斷檢查方向,不要把某段錯誤訊息一概對應至單一原因。同樣的逾時狀況,可能來自基礎網路、遠端無法連線、DNS 或流量接管循環。請搭配實際現象查看日誌:其他節點能否連線、其他應用程式是否正常、關閉接管後基礎網路是否恢復。這些比較條件比單一錯誤字詞更有助於判斷。
| 現象 | 優先檢查 | 接著比對 |
|---|---|---|
| 核心啟動後立即結束 | 設定語法、連接埠、資源路徑 | 查看第一個啟動錯誤 |
| 有節點但全部逾時 | 基礎網路、訂閱有效性、系統時間 | 改測同群組節點 |
| 瀏覽器正常,其他應用程式失敗 | 應用程式代理支援與接管範圍 | 確認請求是否出現在日誌中 |
| 關閉用戶端後無法連線 | 殘留系統代理或流量接管設定 | 還原原本的網路設定 |
分開處理安裝、訂閱與核心錯誤
安裝失敗時,先確認平台、架構、套件格式、系統需求與寫入權限。執行時若缺少元件,應檢查完整安裝結果,不要只替換主程式。升級後若無法啟動,可在備份基礎上使用最簡設定重新測試,判斷是應用程式執行環境變更,還是舊設定不相容。若要看懂具體啟動錯誤,請參閱核心啟動失敗日誌排查。
訂閱更新失敗時,先區分網址無法連線、認證遭拒、回傳內容無法解析,以及更新後清單遭篩選隱藏等狀況。重新複製網址可排除輸入錯誤,但無法修復已過期的服務;反覆刪除群組還可能遺失本機備註。更新成功後,節點名稱也可能改變,影響手動選取。請重新確認目前使用的節點,不能只看舊節點仍留在清單中,就認定它仍是有效設定。
交握失敗時,請核對伺服器位址、連接埠、協定、傳輸方式、安全層,以及伺服器要求的名稱欄位。訂閱提供的參數通常應整組使用,不要只修改其中一項來求得暫時連線成功。若出現憑證錯誤,還要檢查系統時間與名稱是否相符;略過驗證會改變安全性,不應當成通用的排錯方式。只有確認欄位確實有誤時,才依服務端資料修正並重新測試。
常見問答與還原基準設定
測速有結果,為什麼網頁仍然打不開?
測速與網頁存取不一定走相同路徑。先確認瀏覽器有讀取系統代理,或已由 TUN、Android VPN 介面接管,再檢查 DNS 與路由比對結果。實際連線測試比單純的延遲探測更接近實際存取,但仍不能取代目標應用程式測試。若日誌中完全沒有對應請求,請優先修正流量入口,不必先更換所有節點。
訂閱更新後,自訂修改為什麼不見了?
訂閱節點通常會依更新結果重新產生,直接修改由訂閱管理的節點,可能在下次更新時被覆蓋。請先確認用戶端是否提供獨立複製、覆寫設定或自訂設定入口,再將長期修改放在適當位置。不要為保留單次修改而永久停用所有更新;應區分由服務端管理的連線參數,以及由本機管理的路由、備註與應用程式接管策略。
關閉用戶端後無法上網,如何恢復?
桌面端先檢查系統代理是否仍指向已停止的本機連接埠,再確認 TUN 或其他網路接管方式是否正常關閉。Android 端請檢查是否設定為封鎖未經 VPN 的連線,並確認目前由哪個應用程式接管。依照原本的網路狀態逐項還原後測試基本連線,不要先清除所有系統網路設定,也不要在不了解用途時刪除系統介面。
還原基準設定時,請保留備份、停用新增的自訂規則與 DNS、選擇一個已知可用的節點,並只啟用一種流量接管方式。依照準備章節的順序重新驗證,找出最後一個成功的環節。確認連線穩定後,再逐步恢復分流與應用程式例外,並記錄每次變更。若只需重新完成首次連線,可回到快速入門教學;若要調整安裝檔或更換平台,請回到安裝檔下載頁確認下載入口。