v2rayN 全平台設定
與 Android 訂閱匯入
依照作業系統完成安裝,再確認訂閱、流量接管與路由設定。首次連線可先閱讀快速入門教學;需要處理架構、權限、背景執行及設定範圍時,請依本頁目錄查閱。
通用準備與設定範圍
分清客戶端、核心與訂閱
先確認目前要設定的是哪一層。v2rayN 是桌面圖形介面客戶端,負責儲存伺服器、管理訂閱分組、產生執行設定並控制核心;實際連線則由選用的核心負責。Android 優先使用 v2rayNG,採用 Xray 核心;只有需要 V2Fly 核心時再考慮 v2flyNG。訂閱是服務提供者提供的網址或內容,並不等同於客戶端帳號。安裝軟體不會自動取得可用伺服器,也不能把任意網頁網址當成訂閱使用。請先準備有效訂閱,再前往對應平台章節。
確認訂閱服務提供者說明的格式、協定與使用限制。常見訂閱可能包含分享連結、編碼後的連結集合,或特定客戶端的設定內容;能否辨識取決於客戶端實際支援的格式。不要只看副檔名判斷是否相容,也不要將完整執行設定直接貼進「可選地址 Url」。若收到的是單一伺服器分享連結,請使用從剪貼簿匯入伺服器的功能;若收到的是訂閱網址,則建立訂閱分組。兩種匯入方式對應不同資料來源,後續更新方法也不同。
確認架構、時間與網路狀況
前往下載中心前,先在系統資訊中確認處理器架構與系統類型。桌面版安裝檔須符合處理器與發行版需求,不能只看電腦品牌選擇。Windows 的系統類型、macOS 的晶片資訊、Linux 的機器架構,以及 Android 裝置的處理器能力,分別決定適用的安裝項目。安裝檔格式正確,不代表系統版本一定符合需求;若遇到執行階段、系統介面或安裝程式限制,請依安裝提示處理,不要反覆匯入訂閱,試圖掩蓋程式尚未正常啟動的問題。
開啟自動校時,並確認時區與目前時間正確。TLS 憑證驗證會依賴系統時間,時鐘明顯錯誤可能導致所有節點同時出現交握錯誤。接著確認目前網路可正常解析一般網域名稱,必要時先完成網路登入。公共 Wi-Fi 尚未登入、入口網站攔截或本機 DNS 故障,都可能造成訂閱請求逾時。準備階段只確認基本網路,不必急著啟用 TUN 或複雜分流;先用最少設定建立可重現的連線,再逐步加入其他功能。
備份資料並安排驗證順序
修改前記下目前的系統代理狀態、本機監聽埠與訂閱分組名稱。移轉舊客戶端時,先關閉舊程式,避免它仍占用監聽埠或持續修改系統代理。備份設定時,請將訂閱網址視為敏感資料:其中的 token 可能代表存取權限,公開截圖時應遮住完整網址、使用者識別資訊及伺服器憑證。本文的範例網址僅用來說明輸入位置,不能用於實際更新訂閱,也不應取代已確認有效的網址。
依照「程式啟動、更新訂閱、測試節點、接管流量、驗證出口」的順序操作。每完成一個階段就記錄結果,再進行下一步;不要一次修改核心、DNS、路由與代理模式,否則出問題時很難判斷是哪項設定造成。初次使用可依快速入門流程完成連線,再回到本頁處理平台細節。若尚未完成安裝,優先排除安裝問題;若客戶端內測試成功但瀏覽器無法連線,請檢查該應用是否使用代理,不必立刻更換所有節點。
Windows 安裝與系統代理
選擇桌面版或經典 WPF 版
開啟Windows 下載項目,選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面,經典 WPF 版則沿用 Windows 桌面介面;兩者的選單配置可能不同,不要照著另一版本的截圖尋找固定位置。依系統類型選擇目前清單提供的安裝項目,並閱讀安裝提示中的環境需求。本文依設定名稱說明操作,不假設所有發行版本的安裝方式都相同,也不對特定系統版本是否可用作出保證。
安裝完成後,以一般使用者權限啟動,先確認主視窗、伺服器清單與日誌區都能正常開啟。若使用需要解壓縮的版本,請完整解壓至可寫入的資料夾,不要直接在壓縮檔預覽視窗中執行,也不要只移動主程式而漏掉同目錄的其他元件。應用程式安裝目錄與實際設定目錄未必相同,移轉前請使用客戶端提供的備份或設定管理功能確認資料位置。若無法寫入檔案,先檢查資料夾權限與安全軟體記錄,不要將所有問題都歸咎於訂閱。
匯入訂閱並測試伺服器
開啟「訂閱分組設定」,新增分組並填入方便辨識的名稱,再將完整網址貼到「可選地址 Url」。確認已啟用並儲存,接著從「訂閱分組」選單執行「更新全部訂閱(不通過代理)」。更新完成後選取對應分組,查看伺服器是否出現;若清單仍是空的,先清除搜尋與篩選條件,再查看日誌中的更新結果。分組更新成功不代表節點已可連線,不能只因選單沒有顯示錯誤,就認定連線已建立。
選取一台伺服器執行「真連線延遲」測試,再將測試通過的伺服器設為使用中的伺服器。TCPing 比較接近檢查遠端埠是否可連通,無法證明協定交握、驗證及目標請求都成功。「真連線延遲」也會受測試網址影響,因此還需要進一步驗證瀏覽器請求。不要同時測試大量伺服器後,就根據單次結果下結論;先固定一台伺服器與一個測試目標,觀察日誌能否建立對外連線,再切換其他伺服器比較。
設定系統代理與處理退出狀態
確認核心已在執行後,在 v2rayN 的系統代理選單中選擇「自動配置系統代理」。接著檢查 Windows 設定中的代理狀態,確認位址指向本機,且埠號與客戶端監聽設定一致。系統代理只對採用該設定的應用程式生效,部分命令列工具、遊戲或獨立網路程式不會自動使用代理。若瀏覽器有代理擴充功能或獨立設定,請先統一代理來源,避免擴充功能的直連規則蓋過系統設定。瀏覽器能開啟一般網頁,不代表請求一定經由目前的伺服器。
完成出口驗證後,再決定是否使用 TUN。需要啟用 TUN 時,依客戶端提示授予必要權限;一般系統代理連線不應為了排錯而長期以系統管理員身分執行。若啟動時顯示埠號已被占用,先退出舊程式並檢查其他監聽程序;若更換埠號,也要同步更新手動設定的應用程式。退出前請清除系統代理,再關閉客戶端,否則應用程式可能繼續連線至已停止的本機埠。休眠喚醒、切換網路或更新後無法連線時,先確認系統代理與核心狀態,不要直接刪除所有訂閱。
macOS 安裝與權限處理
依晶片選擇安裝項目
在「關於這台 Mac」中查看晶片或處理器資訊,再前往macOS 下載項目。Apple Silicon 請選擇對應的 arm64 安裝項目,Intel 則選擇 x64。優先使用符合電腦規格的原生版本,不要預設以相容執行方式安裝。開啟下載的磁碟映像檔後,依套件內的說明將 v2rayN 移至「應用程式」資料夾,再從該資料夾啟動。不要長期直接從已掛載的磁碟映像檔執行,否則更新、路徑存取與退出後重新啟動都容易混淆。
首次開啟時,先閱讀系統提示。若系統因下載來源限制而阻止啟動,確認檔案來源後,使用系統提供的「隱私權與安全性」介面處理相關提示,不要為了啟動單一應用程式而關閉整台電腦的安全機制。若出現檔案損毀、架構不符或無法載入元件等明確提示,請重新確認下載項目、系統需求與安裝步驟,不要使用任意終端機指令強行略過限制。客戶端視窗開啟後,還要確認核心能正常啟動;介面成功執行不代表核心也正在運作。
建立分組並確認目前網路服務
在「訂閱分組設定」中填入名稱與「可選地址 Url」,儲存後執行更新訂閱。首次更新優先選擇不透過代理;若網址必須透過既有連線存取,請先確認該連線可用,再選擇透過代理更新。若出現登入頁面,不要將網頁內容存成訂閱檔案。更新後選取使用中的伺服器並執行真連線延遲測試,確認日誌沒有持續出現驗證或交握錯誤。介面語言與選單位置可能因版本而異,但訂閱網址、分組與更新方式之間的關係不變。
需要使用系統代理時,先讓客戶端自動設定代理,再到系統設定確認目前使用的網路服務。Wi-Fi、有線網路與其他網路服務可能各自有代理設定;切換網路後,請確認實際使用的服務仍指向正確的本機監聽埠。若客戶端無法自動寫入,依提示處理授權;或在確認埠號類型後手動設定。HTTP 代理埠與 SOCKS 埠不能只憑名稱互換;請先在客戶端設定中確認監聽類型,再填入系統的對應欄位。
分清應用程式代理、權限與網路恢復
某個應用程式沒有使用系統代理時,先檢查它是否有獨立的網路設定。命令列程式也可能讀取環境變數,而非系統圖形介面設定,因此終端機與瀏覽器的請求結果不同,不一定表示節點失效。不要一邊讓瀏覽器擴充功能指定另一個埠號,一邊用系統代理驗證同一連線。先讓測試應用程式只使用單一代理來源,再比較直連與代理結果。驗證出口時,使用相同目標與相同請求方式,避免網頁快取或不同位址家族造成誤判。
啟用 TUN 前,先退出其他網路接管程式,並依目前客戶端的提示處理權限與元件需求。不要以為桌面介面提供開關,就代表所有執行條件都已符合。睡眠喚醒後若連線異常,先停止再重新啟動連線,觀察預設路由與 DNS 是否恢復;切換網路後重新測試使用中的伺服器。解除安裝或移動應用程式前,先關閉 TUN、清除系統代理並正常退出。若程式已刪除但網路仍異常,請在系統設定中移除殘留代理項目,再檢查其他網路服務,不要貿然重設整台電腦的網路。
Linux 安裝與桌面環境差異
選擇符合架構與套件格式的版本
先確認發行版使用的套件管理系統,再前往Linux 下載項目選擇 v2rayN。deb 與 rpm 分別對應不同的套件管理系統;x64 與 arm64 則代表不同的處理器架構,兩者都必須符合需求。可下載不代表一定能安裝,也不能只把檔案改名,就當成另一種格式。使用發行版的圖形化軟體安裝程式開啟下載檔案,並閱讀相依套件與權限提示;若安裝程式指出缺少相依套件,請透過發行版的套件來源補齊,不要從不明來源拼湊執行元件。
可在終端機執行下列唯讀指令,確認機器架構與系統識別資訊。常見的 x86_64 對應 x64,aarch64 通常對應 arm64,但仍應以套件說明與發行版支援情況為準。安裝完成後,從應用程式選單啟動,先留意是否出現顯示環境、執行階段或執行權限相關錯誤。遠端終端機、純命令列伺服器與一般桌面工作階段的執行環境並不相同;本頁介紹的是桌面圖形客戶端,不適用於將圖形應用程式部署為無桌面服務。
uname -m
cat /etc/os-release
匯入訂閱並檢查桌面代理
開啟「訂閱分組設定」,新增分組並儲存訂閱網址,執行更新訂閱後選定使用中的伺服器。先進行真連線延遲測試,確認核心可完成實際請求,再設定桌面代理。若更新失敗,請區分是應用程式無法連網、訂閱網址無法連線,還是回傳內容無法辨識。系統軟體安裝程式能連網,不代表客戶端使用相同的代理路徑;兩者可能採用不同的環境變數與網路設定。沒有錯誤依據時,不要反覆切換套件格式。
Linux 沒有統一的全域系統代理開關,不同桌面環境與應用程式讀取代理設定的方式也不同。客戶端自動設定系統代理後,請在目前桌面環境的網路設定中確認狀態。若應用程式不讀取桌面代理,請使用其自身設定或暫時設定代理環境;先確認客戶端實際監聽的埠號與協定。以下以本機範例埠示範明確指定 HTTP 代理的請求,執行前請將埠號改成客戶端顯示的值。這項測試用來隔離應用程式設定,不會永久修改系統代理。
curl --proxy http://127.0.0.1:10809 --head https://example.com/
處理權限、容器與退出後的網路恢復
一般桌面連線盡量使用一般使用者工作階段。TUN 需要存取虛擬網路裝置並修改路由,實際授權流程取決於客戶端與系統,請依介面說明操作;不要為了省事而長期以高權限啟動整個圖形程式。若核心日誌顯示裝置不存在、權限不足或新增路由失敗,先處理對應的系統條件,再測試節點。若埠號已被占用,請找出占用來源,或更換監聽埠並同步修改應用程式設定,不要只是不斷重新啟動核心。
容器、沙箱應用程式與遠端工作階段中的 127.0.0.1,可能不會指向桌面客戶端所在的網路環境。明確指定代理的請求失敗時,先確認程式與客戶端是否共用網路命名空間,不要立刻將監聽位址改成所有網路介面。若確實需要區域網路存取,還須考量防火牆、驗證與可存取範圍。登出、休眠或切換桌面後,請檢查是否有殘留代理;正常退出前清除桌面代理並停止 TUN。更新應用程式時先備份設定,安裝完成後重新確認權限,不要預設舊的授權仍然有效。
Android 安裝與背景連線
選擇 v2rayNG 或 v2flyNG
前往Android 下載項目,一般優先選擇使用 Xray 核心的 v2rayNG;只有明確需要 V2Fly 核心,且已確認協定相容時,才選用 v2flyNG。兩者並非同一程式換了外觀,匯入結果與支援的協定能力也不完全相同。主流 arm64 裝置優先選擇對應的安裝項目;無法確認架構時再考慮通用版,並核對系統需求。不要因通用版檔案較大,就認定它包含更多代理功能;架構封裝方式與協定能力是不同面向。
安裝時依系統提示允許從目前來源安裝應用程式,完成後可撤銷該來源的安裝權限。更新前請保留訂閱網址與必要設定;若遇到簽章不符等安裝衝突,先閱讀提示,不要直接解除安裝而造成本機資料遺失。安裝完成後開啟客戶端,先匯入資料,再建立連線。客戶端顯示伺服器清單,不代表已取得網路接管權限;首次連線仍須處理系統的 VPN 授權提示。若拒絕授權,請重新點選連線並依提示確認。
匯入分組並建立 VPN 連線
在 v2rayNG 中開啟訂閱分組相關功能,新增名稱與訂閱網址,儲存後執行更新訂閱。不同版本可能將更新功能放在選單中,可依「訂閱分組」與「更新訂閱」等名稱尋找。若只有單一分享連結,請使用從剪貼簿匯入設定的功能,不要貼進訂閱網址欄位。v2flyNG 的選單名稱與版面可能不同,請使用該程式實際提供的訂閱管理功能,不要預期另一款客戶端的截圖位置完全相同。
選擇要使用的伺服器,點選連線並接受系統 VPN 授權。顯示 VPN 狀態圖示,只代表系統已建立由應用程式提供的網路接管通道,不代表遠端驗證一定成功。連線後可使用客戶端提供的真連線測試,或在瀏覽器開啟固定的測試目標,並查看日誌。Android 的 VPN 接管方式與桌面系統代理不同,通常不需要另外設定 Wi-Fi 手動代理;若仍保留舊的 Wi-Fi 代理,請先確認它是否指向不存在的本機埠,避免多重設定干擾判斷。
處理分應用代理、背景執行與網路切換
啟用分應用代理前,先確認目前清單的意思是「僅代理所選應用程式」還是「略過所選應用程式」。兩種設定的含義相反,選錯後常會造成只有瀏覽器或特定應用程式無法連線。修改清單後,依客戶端要求重新連線,讓新設定套用至 VPN。排錯時先關閉複雜的分應用規則,驗證完整接管路徑後再逐項恢復。工作設定檔與主要使用者空間可能有各自的限制,不能只因主要空間中的客戶端顯示已連線,就認定另一個空間的應用程式也一定使用該通道。
若鎖定螢幕後連線中斷,請檢查應用程式的電池策略、背景活動限制及系統背景清理設定,依裝置實際選項允許必要的背景執行。不要一概關閉所有省電功能,先觀察中斷時間是否與鎖定螢幕或清理動作相符。Wi-Fi 與行動網路切換後,原有連線可能需要重新建立;先重新連線,再查看伺服器位址解析與交握結果。其他使用系統 VPN 通道的應用程式可能與目前連線衝突,請只保留一個網路接管來源。更換客戶端前,先停止舊連線,再於新客戶端建立分組,避免兩個應用程式反覆爭用通道。
訂閱分組與更新策略
依來源儲存欄位並選擇更新方式
將不同來源分別放入訂閱分組,名稱用來辨識即可,不必與遠端伺服器名稱相同。「可選地址 Url」請填入完整訂閱網址,保留查詢參數與大小寫,不要在結尾加上說明文字。複製時留意通訊軟體可能插入換行、空格或省略號;匯入前檢查網址首尾,不要手動重寫中間的 token。訂閱網址本身可能包含權限資訊,備份、截圖及回報問題時都應遮蔽敏感內容。客戶端本機分組名稱不能取代遠端帳戶權限,也不會改變服務期限。
「更新全部訂閱(不通過代理)」適用於目前網路可直接連上訂閱網址的情況;「更新全部訂閱(通過代理)」則需要現有的可用代理路徑。若所有既有節點都已失效,後者可能無法建立更新所需的連線,形成依賴循環。請依訂閱網址實際是否可連線來選擇,不要將其中一種設為永遠正確。更新失敗時先保留舊清單並查看錯誤,再決定是否更換連線方式;不要一開始就清除所有伺服器,以免失去可用於恢復的連線。
了解自動更新、篩選與請求識別資訊
「自動更新間隔(分鐘)」用來設定檢查更新的頻率,但實際是否觸發仍會受客戶端執行狀態、計時器與網路狀況影響,不代表服務端保證準時推送。先確認手動更新成功,再依服務提供者的限制設定間隔,不要用極短週期反覆送出請求。休眠或離線期間沒有執行更新,不一定是故障;網路恢復後可手動更新一次。停用分組通常會影響它是否參與更新;至於是否保留現有伺服器,請以客戶端實際行為為準,操作前先備份。
「過濾(正則)」用來篩選訂閱中的伺服器名稱。篩選表達式不會改變伺服器的有效性,也無法補上缺少的協定參數;條件過嚴時,可能出現更新成功但清單為空的情況。排錯時先清除篩選條件,確認原始訂閱是否包含可辨識內容,再逐步加入簡單條件。「User-Agent」僅在服務提供者明確要求或需要相容特定回應格式時調整;任意仿冒其他客戶端可能取得無法解析的內容。請記錄自訂值的來源,復原時先恢復預設請求方式。
| 設定項目 | 主要用途 | 排錯方式 |
|---|---|---|
| 可選地址 Url | 指定訂閱內容來源 | 確認網址完整且具備存取權限 |
| 自動更新間隔(分鐘) | 安排定期更新 | 先確認手動更新成功 |
| 過濾(正則) | 篩選伺服器名稱 | 暫時清除後重試 |
| User-Agent | 影響請求識別資訊與可能的回應格式 | 依服務提供者說明填寫 |
分清訂閱資料與執行設定
更新訂閱可能會重建伺服器資料;手動修改由訂閱產生的伺服器後,下次更新可能會覆蓋變更。若需保留例外設定,先確認客戶端是否提供獨立儲存或自訂設定的方式,不要將大量修改堆在可能被覆蓋的資料上。刪除分組前請閱讀確認提示,確認是否也會刪除相關伺服器。移轉時優先備份客戶端支援的資料格式,再另外儲存訂閱網址;複製目前使用的暫存執行設定,不一定能完整還原訂閱關聯、篩選條件與應用程式偏好設定。
以下是可獨立解析的 Xray JSON 範例,只設定本機 SOCKS 入站與直連出站,用來辨識執行設定的結構;它不提供遠端代理連線,也不是訂閱內容。不要用它取代客戶端自動產生的設定來「修復節點」。實際協定、傳輸方式、安全層與伺服器參數必須完整相符。若仍不清楚設定層次,可繼續閱讀Xray 與 V2Fly 核心差異,再確認客戶端與協定是否相容。
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
],
"outbounds": [
{
"protocol": "freedom",
"tag": "direct"
}
]
}
系統代理、TUN 與路由分流
先選擇流量入口,再設定對外連線規則
請分開理解系統代理、TUN 與路由。系統代理會告知願意讀取該設定的應用程式,將請求傳送至本機埠;TUN 透過虛擬網路裝置接管符合條件的流量;路由規則則決定已進入核心的請求使用哪個出站。三者位於不同層級。「全域」通常代表進入核心後的預設出站策略,不表示所有應用程式的流量都已被接管。因此,在系統代理下選擇全域模式後,部分獨立網路程式仍可能直接連線,這與路由設定本身並不矛盾。
若只需要讓瀏覽器及遵循系統代理的桌面應用程式連線,先使用系統代理,較容易觀察與復原。需要處理不讀取系統代理的程式時,再評估是否啟用 TUN。啟用前記下原有代理狀態、退出其他流量接管程式,並確認權限、虛擬裝置與相關元件都符合需求。不要同時啟用多個客戶端的 TUN,再試圖用修改路由規則解決衝突。啟用後若整台電腦無法連網,先關閉 TUN 恢復網路並查看日誌;基本網路尚未恢復前,不要繼續疊加 DNS 修改。
確認 DNS、網域策略與規則順序
路由比對取決於客戶端實際取得的目標資訊。HTTP、SOCKS、TUN 與不同應用程式可能提供網域名稱,也可能只提供 IP;不要假設所有請求都能符合網域規則。網域策略中的 AsIs 不會為路由比對額外解析網域;IPIfNonMatch 會在網域規則未符合時嘗試解析,以繼續比對 IP 規則;IPOnDemand 則在符合需要 IP 的規則時才依需求解析。策略變更會影響解析時機,但不會自動修復無法使用的 DNS 伺服器。
規則順序通常會影響實際結果,最先符合的規則決定處理方式。將私有位址的直連規則放在適當位置,可避免區域網路資源經由遠端連線;但仍應依應用程式用途確認存取範圍。geosite:cn 與 geoip:private 等寫法需要相應的規則資料與核心支援,出站標籤也必須與設定中既有的標籤一致。只複製「proxy」字串而沒有對應出站,不會自動建立連線。修改後請查看產生的設定或日誌,確認規則已載入,而非只儲存在介面中。
| 功能 | 解決的問題 | 不能據此判斷 |
|---|---|---|
| 系統代理 | 讓遵循設定的應用程式連線至本機代理 | 所有應用程式都已接管 |
| TUN | 透過虛擬網路裝置接管流量 | 遠端節點已通過驗證 |
| 路由分流 | 選擇已接管請求的出站 | 未接管的請求也會套用規則 |
| 真連線延遲 | 檢查指定路徑的實際請求 | 所有網站與協定都正常 |
確認接管效果並保留復原方式
驗證時先固定使用中的伺服器與測試目標,在客戶端執行真連線延遲測試,再讓瀏覽器請求同類型目標並檢查出口。命令列程式可明確指定代理作為對照:若明確指定代理時成功、預設請求卻失敗,應優先檢查應用程式的代理來源;兩者都失敗時,再檢查核心、節點與路由。IPv4 與 IPv6 可能使用不同路徑,出口結果不一致時先確認位址家族,不要直接認定所有流量都繞過代理。詳細驗證步驟請參閱系統代理設定與真連線延遲測試。
復原時依啟用順序的反向操作:停止 TUN、清除系統代理,再正常退出客戶端。若先前手動設定代理環境變數或應用程式專屬代理,也要分別還原;關閉客戶端不會自動修改每個應用程式儲存的設定。區域網路裝置、遠端桌面與公司網路可能對路由變更較敏感,調整前請保留本機存取方式。不要為了讓單一應用程式連線,就把監聽位址暴露至所有網路介面;若需共用代理,請另外評估存取控制與防火牆,不要直接將本機設定套用為區域網路服務。
常見設定問題與日誌排錯
依啟動、訂閱、連線逐層排查
從最早出錯的層級開始排查。介面無法開啟時,檢查安裝、架構與執行環境;介面正常但核心無法啟動時,檢查日誌中的埠號占用、設定解析與權限;核心啟動後訂閱失敗,再檢查網址、請求路徑與回應內容;訂閱成功但連線失敗,才進一步排查協定參數與伺服器可達性。不要用重新安裝取代所有判斷;重新安裝後可能仍保留原設定,或反而刪除有用的錯誤資訊。請先儲存錯誤原文與發生錯誤時的操作,再做最小幅度的修改。
閱讀日誌錯誤時,需搭配前後文判斷。address already in use 通常表示本機監聽埠已被占用,不代表遠端伺服器拒絕連線;JSON 解析失敗應檢查對應欄位、逗號與資料型別;未知協定或不支援的欄位則應確認目前核心是否支援該設定。客戶端自動產生的檔案可能會在重新啟動時被覆寫,因此應優先修正介面中的來源設定。可參閱核心啟動失敗與設定錯誤排查,分辨設定產生問題與執行環境問題。
分辨憑證、驗證與網路逾時
TLS 錯誤請先檢查系統時間,再確認伺服器位址、SNI 與憑證網域之間的關係。連線位址與憑證驗證名稱可以不同,但必須符合服務提供者的設定,不能任意改成常見網站網域名稱。不要把略過憑證驗證當成日常解法,這只會掩蓋名稱不符或信任鏈問題。使用 REALITY 等設定時,公鑰、短識別碼、伺服器名稱及其他參數應依服務提供者的設定一併匯入,不要參考其他節點拼湊欄位。相關背景請參閱時間同步與 SNI 錯誤說明。
逾時只表示某個等待階段未能在期限內完成,應確認問題發生在網域解析、建立連線、交握,還是請求目標階段。拒絕連線與逾時也不相同:前者可能表示目標埠沒有服務,後者則可能與網路路徑或遠端回應有關。先用另一台已知可用的伺服器比較,再測試不同網路,不要連續修改所有協定參數。若所有伺服器同時失敗,也應檢查本機殘留代理、DNS、公共網路登入狀態及核心是否仍在執行,不要立刻認定整份訂閱都已失效。
保留可重現資訊並逐步復原
回報問題時,請記錄作業系統、處理器架構、客戶端名稱、流量接管方式、失敗操作及已遮蔽敏感資訊的日誌片段。不要公開完整訂閱網址、驗證識別資訊或含有敏感參數的設定檔。說明是「更新訂閱失敗」還是「瀏覽器無法開啟」,比只說「不能用」更有助於排查。若問題只在鎖定螢幕後、切換網路後或特定應用程式中發生,也請註明觸發條件。復原後逐項重新加入篩選、分應用設定、DNS 與自訂路由,每次只驗證一項,避免問題再次出現。
更新訂閱成功,為什麼伺服器清單是空的?
先取消伺服器搜尋與分組篩選,再暫時清除「過濾(正則)」。檢查更新日誌是否確實辨識到伺服器,而不只是完成 HTTP 請求。登入頁面、錯誤頁面與不相容格式都可能回傳內容,卻無法產生有效伺服器;請向服務提供者確認訂閱格式後再試一次。
真連線延遲正常,為什麼瀏覽器還是無法開啟網頁?
確認使用中的伺服器與測試目標是否一致,再檢查系統代理位址、監聽埠及瀏覽器的獨立代理設定。客戶端測試使用的連線路徑不一定與瀏覽器相同。透過明確指定代理的請求進行比較,確認流量是否進入核心,再檢查目標網站對應的路由與 DNS。
更新訂閱後,手動修改的伺服器參數消失了,該怎麼辦?
先不要繼續修改同一筆訂閱記錄,並確認更新是否會覆蓋伺服器內容。需要保留的例外設定,請依客戶端支援的方式另外儲存,並請服務提供者修正原始訂閱參數。不要依賴每次更新後再手動補填,尤其是安全層與傳輸參數必須保持一致的設定。
需要依問題類型繼續查閱時,請前往常見問題;需要重新建立最基本的可用設定時,請回到訂閱匯入步驟。完成復原後,保留一份可用設定與測試記錄;下次遇到問題時先比對變更項目,不必從頭重做所有設定。