01 基礎
核心概念:應用程式、入口、核心與出站
先釐清一次請求的傳遞路徑
網頁請求通常從瀏覽器發出。在桌面環境中,若瀏覽器使用系統代理,會先將請求交給用戶端的本機監聽埠;若未使用系統代理,瀏覽器可能直接連線至目標。請求進入監聽埠後,核心才有機會讀取目標位址、比對路由並選擇出站。選擇代理出站時,核心會另外連線至遠端服務,並透過相應協定轉送請求;選擇直連出站時,核心直接連線至目標;選擇阻擋出站時,請求則會在本機被攔截。瀏覽器連到的本機入口與核心連線的遠端入口是不同位址,也不一定使用相同類型的協定。
排除故障時,沿著這條傳遞路徑找出中斷點。設定視窗能開啟,只代表圖形介面正在執行,不代表核心已啟動;本機埠正在監聽,也不代表遠端交握成功;核心回報連線成功,仍不代表目標網頁已傳回可用內容。反過來說,網頁能開啟也不能證明代理成功:請求可能走直連,或只是顯示快取內容。驗證時,分別記錄「程序啟動」、「請求進入」、「命中出站」和「目標回應」,再針對失敗階段調整相關設定。
用戶端負責設定,核心負責處理連線
Project V 是理解這類工具生態背景的起點;V2Fly 與 Xray 則是相關的核心專案。本文所說的用戶端是圖形介面,負責儲存節點、管理訂閱、依照目前選項產生執行設定,以及啟停核心或介接系統網路。核心則負責監聽、轉送、協定處理與路由。介面上看得到某個節點,不代表目前使用的核心支援該節點採用的協定、傳輸方式與安全參數組合。若匯入正常但啟動報錯,先確認執行時使用哪個核心,再依據記錄檔判斷是欄位不支援、資源缺漏,還是連線階段失敗。
節點資料描述如何連線至遠端服務。協定決定通訊雙方如何解讀請求,傳輸方式決定資料如何承載,安全設定則涉及身分驗證與加密等要求。這三層設定不能互相取代。相同的伺服器位址,可能搭配不同埠號、傳輸路徑或服務名稱;只看節點名稱中帶有某個協定名稱,也無法推斷實際參數。正常設定應來自服務管理者提供的節點或訂閱。遇到身分驗證錯誤時,不要為了讓連線表面上可用而關閉憑證驗證。
訂閱、路由與 DNS 各司其職
訂閱是取得節點資料的來源;更新訂閱不等於測試所有節點,也不能自動證明目前選用的節點仍然有效。路由依據目標網域、目標位址、入站標籤等條件,決定使用哪個出站。網域名稱解析則負責將名稱轉換為位址,也可能影響路由比對。應用程式有時會直接傳送網域名稱,有時則先自行解析,再將位址交給入口;後一種情況下,核心未必看得到原始網域名稱。因此,同一網站在不同應用程式中的分流結果不一致時,應先確認應用程式交給核心的是什麼。
先確認是哪一層發生變化。訂閱清單有變,不代表目前使用的節點也變了;目前使用的節點變了,也不代表應用程式的流量已進入代理。
開始操作前,準備一個自己有權存取、回應容易辨認的測試頁面,並記下目前網路環境下的存取結果。之後都用同一個目標進行比對,不要拿不同網站的載入速度互相比較。尤其別把延遲數字當成連線路徑:本機埠的回應時間、節點測試耗時與網頁完整載入時間,衡量的是不同環節。將一次請求拆解成獨立環節,後續選擇用戶端、設定分流規則與回復故障,才有可驗證的依據。
02 選擇
選擇用戶端:平台、架構與核心
先依作業系統縮小選擇範圍
桌面平台優先考慮 v2rayN。Windows 可比較 Desktop 與傳統 WPF 版本;兩者主要差異在介面,不要根據介面形式推斷節點協定支援情況。macOS 與 Linux 也可使用 v2rayN 桌面版,選擇時請確認晶片架構或發行版套件格式。Android 優先使用 v2rayNG,該應用採用 Xray 核心;若有明確的 V2Fly 核心需求,再考慮 v2flyNG。不要同時啟動兩款 Android 用戶端來比較穩定性:兩者都會占用系統 VPN 入口,切換時請先停止目前使用的應用,再啟動另一款。
| 平台 | 用戶端 | 下載頁選項 | 選擇前確認 |
|---|---|---|---|
| Windows | v2rayN | Desktop、WPF | 處理器架構與軟體執行需求 |
| macOS | v2rayN | Apple Silicon、Intel | 系統資訊中的晶片或處理器 |
| Android | v2rayNG、v2flyNG | arm64、通用版 | 應用程式架構與節點的核心需求 |
| Linux | v2rayN | deb、rpm;分別提供 x64 與 arm64 版本 | 發行版套件格式與處理器架構 |
開啟用戶端下載頁,先選擇平台,再對照系統資訊。Windows 請查看「關於」中的系統類型,不要把「64 位元系統」直接等同於 x64:同樣是 64 位元的裝置,也可能採用 ARM 架構。macOS 請查看「關於這台 Mac」顯示的是 Apple 晶片還是 Intel 處理器,不要依機身年份推測。Linux 可用下列指令查詢機器架構,再依照發行版慣用的套件格式選擇。一般而言,x86_64 對應 x64,aarch64 對應 arm64;若目前的使用者空間架構與硬體架構不同,則以套件管理器辨識的目標架構為準。
uname -m
cat /etc/os-release
接著確認設定能否直接使用
Android 新款主流裝置通常選擇 arm64,但晶片能力與系統允許安裝的應用程式架構不一定相同。不確定時,可在下載頁選擇通用版;「通用」是指套件包含多種架構的原生程式庫,不代表支援更多協定。若已安裝同名應用程式,但無法安裝新版,請先確認架構、系統需求與應用程式簽章是否相符。不要把解除安裝當成第一步:先確認本機訂閱、手動節點與應用程式分流清單是否已備份,避免排除安裝問題時連帶遺失連線設定。
選擇用戶端前,先將現有需求整理成幾項可檢查的條件:服務提供的協定與傳輸方式、是否依賴特定核心、是只代理瀏覽器還是也要涵蓋不支援系統代理的應用程式,以及是否需要依應用程式區分流量。若只有圖形介面偏好不同,桌面版的兩種選擇都可先用同一個節點進行基本測試。若節點文件明確限定某種核心,就不能只因名稱相似而改用另一種核心。即使匯入時沒有錯誤,也要分別確認節點能否啟動,以及實際服務是否能存取。
遷移時,只帶走能明確辨識的設定
訂閱連結與手動節點可依用戶端支援的方式分別匯入;代理埠、DNS 設定、規則庫與應用程式清單則應分別核對。桌面與行動裝置的系統入口不同,整份設定目錄通常不適合跨平台搬移。即使兩端顯示相同的節點名稱,也要確認目前使用的節點、傳輸選項與路由策略是否一致。舊用戶端還能正常使用時,盡量先完成新用戶端的基本驗證,再停止舊設定;不要讓兩個程式共用同一個本機監聽埠來進行比對。
初次選擇不必一次設定所有功能。先保留一套可還原的最小環境:一個符合平台需求的用戶端、一個已知可用的節點,以及一個測試目標。需要在多部裝置上使用時,逐一確認系統入口,並記錄同一節點在各裝置上的結果。如此才能區分裝置差異與伺服器問題;若某部裝置連線失敗,也不會受到另一部裝置啟用的代理或不同應用程式設定干擾。
03 安裝
安裝與首次啟動:先確認本機監聽
依照發行套件格式準備執行環境
Windows 請在下載頁選擇需要的 v2rayN 版本。安裝程式依畫面指示操作;若取得的是壓縮發行套件,請先將整個套件解壓縮至可寫入的固定目錄,再啟動程式,不要直接在壓縮檔預覽中雙擊。不要只複製主程式:核心、規則資源與附屬檔案可能需要維持原有的相對位置。若程式啟動後立即關閉,先查看系統提示與應用程式記錄檔,再補齊該套件明確要求的執行元件。若目錄存取受限,可先在一般使用者可寫入的位置測試;長期以系統管理員權限執行整個程式,不是排除目錄權限問題的首選方式。
macOS 請依照晶片型號掛載對應的磁碟映像檔,將應用程式複製到「應用程式」資料夾後再啟動。若遭到系統安全性封鎖,請依照本機安全政策確認來源;無法確認時就停止安裝,不要全面降低系統防護。Linux 請使用發行版的套件管理器安裝相符的發行套件,交由它處理相依套件並記錄安裝狀態;缺少相依套件時,依照錯誤訊息列出的套件名稱檢查,不要用另一種格式的安裝套件互相覆蓋。Android 只在實際開啟安裝套件的來源需要時授予安裝權限;首次啟動時先確認主畫面是否正常,等到啟用連線時再確認系統網路授權。
依據實際狀態確認埠號,不要死記預設值
首次啟動時先不要修改系統代理,也不要開啟 TUN。在桌面版 v2rayN 的設定中,找出本機監聽埠或混合監聽埠,再對照記錄檔中的實際監聽位址。常見教學提到的兩個埠號,可能來自不同版本或監聽模式;不要假設目前一定有獨立的 HTTP 監聽埠。若只供本機應用程式使用,監聽位址應限於迴環位址;啟用區域網路連線會擴大可連入的範圍,並非解決本機連線失敗的必要步驟。看到介面上設定的埠號後,仍要透過啟動記錄檔或系統查詢確認設定已生效。
Windows 可使用 PowerShell 查看迴環位址或萬用位址上的監聽狀態。下列指令只會讀取資訊,不會修改埠號。結果中的處理程序 ID 可用來回到工作管理員確認所屬程序;萬用位址也可能占用用戶端原本要使用的埠號。若沒有任何輸出,先確認核心是否正在執行,再檢查啟動錯誤;不要隨意把本機埠號設成遠端節點的埠號。若同一埠號已被其他執行個體占用,請先正常關閉重複執行的用戶端,或為其中一個指定不同埠號,並同步更新依賴該埠號的應用程式設定。
Get-NetTCPConnection -State Listen |
Where-Object { $_.LocalAddress -in '127.0.0.1','::1','0.0.0.0','::' } |
Select-Object LocalAddress,LocalPort,OwningProcess
完成一次啟動與停止,建立乾淨的基準狀態
分別啟動與退出一次,確認系統匣中的程式是否仍在執行。關閉主視窗有時只會將介面縮至系統匣,核心仍會繼續監聽;若要釋出埠號,請使用用戶端的停止或退出功能,再重新檢查。若首次執行時發現舊的其他執行個體仍占用入口,先確認是否有工作正在使用它,不要只憑埠號就終止不明程序。詳細排查方式請參閱本機埠衝突排除方法;若想比較桌面版介面,可接著查看v2rayN 安裝與設定指南。
安裝完成後,不必立刻設定隨系統啟動。先記下用戶端儲存資料的方式、實際監聽埠號與停止操作,匯入節點後手動完成一次連線與退出。若系統可能存在舊的代理位址,也先記錄原值,避免將原本由組織管理的設定誤認為用戶端殘留而直接清除。確認正常退出後系統網路能恢復至啟用前狀態,再考慮設定開機啟動。Android 裝置也請記錄是否有其他應用程式占用系統網路入口,進入下一章測試前先關閉衝突應用程式。
04 設定來源
訂閱與節點匯入:先更新,再選擇使用中的節點
區分訂閱網址、單一節點分享連結與執行設定
訂閱是用戶端發出請求的網址,支援的回應格式由用戶端決定。單一節點分享連結通常只描述一條連線。完整的核心設定還可能包含獨立入站、多個出站與路由規則,不能當成一般訂閱網址提交。匯入前先查看來源提供的說明:如果提供的是網站帳戶入口而非訂閱網址,貼進用戶端可能只會取得登入頁面。不要因為網址能在瀏覽器開啟,就認定內容正確;也不要為了試錯而將網址交給不明的線上轉換工具。網址中的查詢參數與路徑可能含有存取憑證,應像密碼一樣妥善保管。
在 v2rayN 中,從訂閱群組管理入口新增群組,填入容易辨識的名稱與訂閱網址並儲存;選取該群組後,再執行更新目前訂閱。群組名稱只是本機備註,不會決定訂閱回傳格式。v2rayNG 可從選單進入訂閱群組設定,新增群組與網址後返回節點清單,執行更新訂閱。v2flyNG 也應從應用程式的訂閱群組入口管理來源,但不要假設它與另一款應用程式可辨識的節點類型完全相同。實際選單名稱可能因介面版本而異;確認來源已儲存、已執行擷取,而且清單確實新增或更新即可。
依序檢查請求、解析與選擇
更新後先查看群組中是否有項目,再確認目前使用的節點。看到新節點不代表用戶端已切換至該節點;重新整理也可能取代舊紀錄,導致先前選取的項目失效。優先選擇服務提供者明確列出且參數完整的節點進行測試。若只取得一條分享連結,可透過用戶端支援的剪貼簿匯入功能,將它加入適合的群組,不必先建立訂閱。手動維護的項目應與自動更新的項目分開,避免更新時誤以為手動修改會永久保留。
更新失敗時,先判斷是哪一類問題。請求逾時,檢查目前網路與更新使用的連線路徑;收到拒絕狀態,確認網址是否失效或權限是否變更;若顯示解析失敗,可能是收到登入頁、錯誤頁,或訂閱回傳格式不受目前用戶端支援。既有節點能連線但更新失敗,只能表示代理資料路徑至少部分可用,不能據此判定訂閱服務正常。反過來,訂閱更新成功只代表訂閱端點有回應,不代表清單中的每個節點都能連線。
先保留最後一個可用節點。只有在舊節點失效,且更新訂閱又依賴該節點時,才需要另外檢查更新路徑是否形成循環依賴;不要用反覆清空清單來取代故障排除。
設定更新方式,避免覆蓋手動調整
若用戶端提供經代理或不經代理更新的選項,先判斷訂閱網址可透過哪條路徑存取。舊節點無法使用且訂閱請求仍經由該節點傳送時,若本機網路能連上訂閱端點,可改用不經代理更新;反過來,若本機直連失敗但現有節點可用,再嘗試經代理更新。遇到憑證錯誤時,檢查系統時間與憑證信任狀態;遇到網域名稱解析失敗時,檢查目前的解析環境,不要忽略憑證錯誤後繼續操作。自動更新間隔依照服務管理者提供的更新頻率設定。若手動更新與自動更新同時發生,記下觸發時間,以便確認是哪次更新覆蓋了清單。
更新完成後,比對訂閱群組、目前使用的節點與一次實際存取結果。若設定依賴節點備註進行手動選擇,不要只用備註作為辨識依據,因為不同項目可能同名。可記錄協定類型、選取的群組與不含敏感資訊的節點備註,但不要在共享記錄檔中附上完整節點或訂閱內容。自動更新入口、系統 DNS 異常與更新路徑的詳細排查方式,請參閱訂閱更新失敗與自動更新設定。此時先不要調整路由;下一章會用單一入口驗證已選取的節點。
05 流量入口
系統代理、全域規則與直連的差異
系統代理決定哪些請求有機會進入核心
在桌面平台上,v2rayN 的「設定系統代理」主要是寫入可供應用程式讀取的系統代理設定。只有遵循這項設定的瀏覽器與其他應用程式,才可能將請求送到本機入口。並非所有程式都會遵循系統設定:有些命令列程式只讀取環境變數,有些應用程式使用自行儲存的代理設定,也有瀏覽器受到組織政策或擴充功能控制。啟用系統代理後,若只有某個應用程式無法使用,應先確認該應用程式是否有連上代理,以及使用的協定是否正確;不要直接修改整個核心的出站規則。
「清除系統代理」是撤銷或清理系統層級代理設定的操作,是否會變更既有設定仍取決於用戶端與作業系統的行為;這不等於停止核心,也無法阻止應用程式繼續使用自行設定的本機埠號。若系統代理選項中有「不變更系統代理」,應理解為用戶端不主動修改這層設定,而非自動恢復直連。曾手動修改系統代理的裝置,在切換前後都應進入系統設定,確認代理位址與排除清單;尤其在組織網路中,不要誤刪管理政策設定的代理。
全域與分流,指的是進入核心後的選擇方式
全域代理通常是指將進入核心、尚未被更具體條件處理的流量交給代理出站,不代表整部裝置的每條連線都已被接管。所謂繞過中國大陸規則,通常是依照規則庫中的網域與位址清單,決定部分流量直連;不會測量伺服器的實際位置,也不會分析網頁內容。直連策略會讓進入核心後符合條件的請求,從本機直接連線至目標;過程仍可能經過本機入口與核心。判斷問題出在系統入口還是路由,關鍵是先確認核心是否看得到該請求,再確認它選用了哪個出站。兩層設定的組合方式請參閱系統代理與路由模式比較。
明確指定代理的測試,不受系統是否採用設定影響
如果已確認桌面版的本機 SOCKS 監聽位址是 127.0.0.1:10808,可以使用下列指令單獨驗證這個入口。這裡使用保留作為範例的公開網域,不需要帳戶;若它不適合目前的網路或規則環境,請改用事先準備好的測試目標。Windows PowerShell 可將指令名稱寫成 curl.exe,避免呼叫別名。埠號不同時,請換成記錄檔實際顯示的 SOCKS 埠號;若只啟用了 HTTP 監聽,不要將它填入 SOCKS 選項。
curl --socks5-hostname 127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/
這個參數會讓 curl 將網域名稱交給 SOCKS 入口,而不是先在執行 curl 的主機上解析目標位址。收到回應只代表從該入口發出的請求有結果;仍須查看出站記錄,才能確認是否確實經由遠端節點。若連線本機位址時就遭到拒絕,先檢查埠號與核心程序;若本機連線成功後才逾時,則檢查出站、遠端交握或目標回應。有些網站會拒絕只讀取回應標頭的請求,可改用一般讀取方式對照;不要把應用程式層級的回應碼直接記成核心啟動失敗。
Android 使用的是系統 VPN 授權,不應照搬桌面平台「設定系統代理」的步驟。先用一般應用程式驗證,確認它未被應用程式分流設定排除,再查看核心選擇的出站。桌面平台也適用相同原則:本章先固定入口、節點與目標,確保測試可重現;下一章再單獨調整規則。若一開始同時更換瀏覽器、節點並切換全域模式,即使偶然恢復,也無法判斷是哪項變更真正有效。
06 出站策略
路由分流與 DNS:依序驗證規則比對
先明確定義比對條件,再指定出站標籤
常見核心會依序檢查路由規則,符合第一條適用規則後,就會決定出站。同一規則中同時設定網域與位址條件,不代表符合其中任一項就會命中;若要表達「指定網域集合或指定位址集合走直連」,應拆成兩條規則。direct、proxy、block 是設定中指定的出站標籤,不會因為名稱存在就自動建立出站。匯入規則前,應確認這些名稱在目前設定中分別對應哪個出站。
以下是核心設定中的 routing 片段。它應合併至既有的核心入站與出站設定中,且須先確認三個出站標籤都已存在,規則庫也確實包含對應的集合。這不是 v2rayN 或 Android 用戶端通用的匯入檔;使用圖形介面編輯時,應將各項分別填入路由規則編輯器。在此範例中,最後一條規則只符合 TCP 與 UDP,會作為一般代理流量的預設規則。若設定使用預設出站作為兜底,則應確認實際排在首位的是預期出站,不能將未命中規則自動視為直連。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:category-ads-all"],
"outboundTag": "block"
},
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}
別讓兜底規則提早攔截需要解析的位址規則
geosite:cn 比對規則庫中的網域集合;geoip:private 比對規則庫標記為私有網路等用途的位址範圍。只有位址、沒有網域名稱的請求,通常不會符合前兩條網域規則;以網域名稱連線的私有網路服務,也不等同於以私有網路位址連線。使用 IPIfNonMatch 時,若網域請求未命中規則,核心才會考慮解析位址後再次比對。上述範例中的寬泛網路兜底規則會在第一輪接住網域請求,因此第三條主要用於直接以位址進入的請求;不要期待每個陌生網域都先經過位址分類。若要解析後再依位址判斷,應依照目前核心的行為評估 IPOnDemand,或移除會提早命中的寬泛規則並明確指定預設出站。調整後也要觀察解析負載與實際命中次數。
沿著實際解析路徑檢查 DNS
先確認目標名稱由誰解析:應用程式自己的解析器、系統解析器、核心 DNS,還是遠端出站。瀏覽器啟用加密 DNS,不代表系統解析設定也改變;核心設定了 DNS,也不保證收到的每個請求都包含網域名稱。若修改 DNS 後只有部分應用程式的表現不同,先確認這些應用程式是否已預先解析,再使用相同入口比較網域請求與位址請求。不要直接以位址開啟需要憑證驗證的網站,並將結果視為相同的對照;網域與位址請求的 TLS 身分和網站選擇可能不同。必要時可使用自己管理的測試網域驗證,不要將敏感的內部網域名稱交給不負責該網域的解析器。
更新資源後,應確認集合是否存在以及成員是否變動,不要只查看檔案日期。不同來源的資料庫即使使用相同集合名稱,涵蓋範圍也可能不同。至少記下三個不含敏感資訊的範例:預期直連、預期代理與預期阻擋的目標。規則變更後,逐一發出新請求,並在可用的記錄檔中比對目標與出站。若沒有明確的命中資訊,先在隔離環境加入一條具體規則來確認順序。規則庫的更新入口與比對方式,請參閱GeoIP 與 GeoSite 規則庫。
07 系統接管
TUN 接管:只有系統代理不足時才啟用
判斷缺少的是入口,還是代理功能
TUN 透過虛擬網路介面接收由系統路由導入的流量,適合無法使用一般系統代理的應用程式。它改變的是流量進入的方式;進入後仍須經過相應的轉送、DNS 與出站策略。若瀏覽器使用明確指定的代理已經失敗,應先修復本機監聽、節點或出站設定;TUN 無法讓失效的節點恢復。反過來說,如果瀏覽器能使用系統代理,但目標應用程式完全不讀取代理設定,才適合在現有基準上測試 TUN 能否涵蓋該應用程式。
桌面平台請以目前版本 v2rayN 是否支援 TUN,以及介面提供的功能為準。啟用前確認已選好可用節點,並記下系統代理原值、目前網路與本機服務的可連線狀態。為避免兩種入口混在一起,首次驗證時請關閉自行設定的應用程式代理,並撤銷用戶端上一步寫入的系統代理設定;若網路由組織政策管理,則不應擅自修改。接著開啟 TUN,依系統要求授予建立介面或修改路由所需的權限。若系統拒絕權限,先檢查記錄檔中具體失敗的操作,不要把提高日常帳戶權限當成預設處理方式。
比對公開網路請求、私有網路目標與名稱解析
先發出一般網頁請求,再測試需要 TUN 的應用程式,最後測試允許存取的區域網路資源,例如自己管理的裝置。若公開網路可用但區域網路失敗,不要急著加入範圍過大的排除規則;先確認目標位址範圍、系統路由優先順序,以及用戶端是否有相應的直連規則。核心中的私有網路直連,與系統層不將私有網路流量導入介面,是兩種不同方式:前者仍能在核心中看到流量,後者則會在進入入口前繞過。若私有網路服務透過名稱存取,也要確認 DNS 查詢是否仍送往正確的本機解析器。
若一啟用 TUN 就所有請求都停止,先停用 TUN,重新測試原有基準。若能恢復,重點檢查虛擬介面、預設路由、遠端節點是否被錯誤導回虛擬介面,以及節點網域名稱解析是否依賴尚未建立的代理。若部分網頁能開啟,但應用程式卡在登入或媒體載入,請分別測試一般網頁存取、目標應用程式連線,以及其依賴的 DNS 或 UDP 流量。端對端是否能處理 UDP,還取決於轉送實作、遠端服務與出站協定設定,不能只憑虛擬介面已建立就下結論。
Android 先檢查系統授權與應用程式範圍
在 v2rayNG 或 v2flyNG 啟用連線時,Android 會要求授權建立系統網路通道。若失敗,先確認授權是否完成、系統是否已有常駐的同類服務,以及其他應用程式的連線是否尚未停止。若只有某個應用程式無法連線,檢查用戶端是否啟用應用程式分流,以及清單目前設定為包含還是排除。應用程式已在背景執行時,切換規則後請重新發起連線再觀察,不要用舊連線判斷新規則。行動數據與 Wi-Fi 可各測試一次,但應固定節點與測試目標,才能分辨是系統接管問題,還是特定網路的可達性差異。
為 TUN 保留明確的退出方式:停用後確認虛擬介面已移除,再使用同一個應用程式與原本的網路重試。一般代理能連線、TUN 無法連線時,不必重新建立訂閱。
確認啟用狀態穩定後,再考慮設定隨系統啟動。每次網路從有線切換到無線、從無線切換到行動數據,或從休眠恢復時,可使用相同的對照目標,觀察是短暫重新連線還是持續故障。若持續失敗,先記下當時的網路類型、用戶端記錄檔與是否啟用應用程式分流,再退出接管以恢復網路。若問題只在啟用接管後出現,回復明確指定代理仍可保留基本使用方式,不必連帶修改原有路由、節點與訂閱。
08 維護
日常維護:分層排除問題與安全回復
將更新拆分成可分別回復的變更
用戶端、核心、規則庫與訂閱節點是四種不同的變更。用戶端更新可能改變介面或設定產生方式;核心更新可能影響欄位相容性;規則庫更新會改變分類;訂閱更新則可能替換遠端參數。不要在同一次維護時段內一次更新四種內容後才測試連線。記錄變更發生在哪一層、目前使用的節點與本機監聽埠號,修改後立即比對入口、出站與目標三項。若其中一項異常,只回復剛才進行且可復原的變更,再使用相同目標重測。
備份時優先使用用戶端明確提供的匯出或備份功能。若只能備份資料目錄,先確認實際位置並正常退出程式,避免複製到一半設定又遭到改寫。備份內容和訂閱一樣可能包含憑證資訊,不應上傳到公開空間。還原前,先另存目前狀態的紀錄;設定格式變更後,無法保證新版能完整讀取舊目錄。先匯入必要節點以恢復基本連線,再補回自訂路由、本機埠號與應用程式分流清單。還原後要確認系統入口,因為系統代理與網路授權可能不包含在用戶端備份中。
依故障發生的位置決定下一步
- 核心未啟動。先查看最早出現的啟動錯誤,檢查相依套件、檔案路徑、監聽衝突與設定解析問題。不要優先查看最後一行通用的失敗提示。埠號無法啟動時,確認占用的程序;設定語法錯誤時,回復最近編輯的部分。
- 核心已啟動,但沒有對應請求。使用明確指定代理的請求進行比對。明確代理測試成功,但一般應用程式沒有記錄時,回頭檢查系統代理、應用程式自己的代理設定或分流清單。若目前的記錄層級看不到存取記錄,不要直接將「沒有記錄」等同於「請求未進入核心」。
- 已收到請求,但遠端交握失敗。確認目前使用的節點、系統時間、伺服器名稱與傳輸選項,並檢查同一網路下另一個已知可用的節點是否也有相同狀況。單一節點出錯時優先檢查該節點;多個節點同時出錯時,再檢查共用的網路與名稱解析。
- 交握正常,只有部分目標失敗。檢查路由順序、名稱解析與目標回應。若看到目標傳回拒絕或其他應用程式層級錯誤,代表連線至少已到達能夠回應的一端;仍應搭配出站記錄,確認回應是否來自預期的服務。
記錄錯誤時,保留時間、網路類型、操作步驟、錯誤類別與出站標籤。需要分享螢幕截圖時,請遮蔽訂閱網址、帳戶識別資訊、私有網域與連線參數,不要公開整份設定。重現問題後,將暫時調高的記錄層級恢復原值,避免持續記錄存取目標。遇到不定時逾時,先分辨是首次建立連線較慢、連續請求變慢,還是切換網路後舊連線未恢復。第一輪比對只使用一種測試工具與一個目標,不要直接比較不同用戶端的延遲分數。
依序從系統入口恢復到用戶端設定
要恢復一般網路時,先停止 TUN 或中斷行動裝置上的連線,再檢查用戶端修改過的系統代理,最後還原應用程式中手動填入的代理位址。桌面版關閉視窗不等於退出程式;退出程序也不代表作業系統中的設定已清除。保留原代理設定的裝置應還原原值,不要一律設為直連。確認一般網路恢復後,再依原本的基準啟用用戶端。若問題仍與帳戶授權、節點參數或安裝環境有關,可前往常見問題的對應分類查詢,不必清除所有設定重新來過。
網路恢復後,再補上維護紀錄,將故障前的變更、回復點與驗證結果一起記下。例如記錄「還原舊規則後,同一目標恢復直連」,而不是只寫「現在可以用了」。若只能定位到某個共同環節,也應保留尚未排除的可能性,避免下次處理時把推測當成已確認的原因。能重複觸發、逐項回復並重新驗證的紀錄,比只記下一次成功恢復更有價值。
09 進階
進階實作:規則測試、跨裝置比對與遷移
從最小規則測試開始
進階設定不是從堆疊規則開始,而是先弄清楚每條規則存在的理由。先選擇自己管理或獲得授權測試的目標,另外建立一套與日常設定分開的測試規則。固定節點、網路與入口,只加入一條精確比對規則與一個已知的預設出站,分別測試符合與未符合規則的情況。接著逐步擴大條件至網域後綴、位址範圍與規則庫集合。擴大條件後若行為改變,就拿上一個版本的精確規則進行比對,確認是涵蓋範圍擴大、優先順序改變,還是目標交給核心的位址形式不同。
每個測試案例都應記錄請求形式、預期出站、實際出站與回應結果。規則是否命中與實際服務是否成功應分開驗收:命中直連後,目標仍可能拒絕存取;命中代理後,遠端交握也可能失敗。驗證阻擋規則時,應選擇原本確定可存取的目標,才有比較依據。測試期間不要讓瀏覽器快取或既有長連線取代新請求;修改設定後,先確認核心已套用變更,再送出會建立新連線的請求。若看不到明確命中資訊,可暫時縮小規則範圍,不要憑載入速度推測分流結果。
跨裝置比對時,保留各平台差異
同一個訂閱能在桌面版與 Android 匯入,不代表兩邊實際生效的設定相同。先讓桌面版透過明確指定的本機入口,對目標發出請求;再於行動裝置選擇一個確定包含在應用程式清單中的應用程式,存取同一目標,並確認兩端使用的是同一節點。記錄每個平台的路由功能、是否使用系統虛擬介面、解析位置與預期直連範圍。若一端只支援預設規則,另一端可細部設定規則,應遷移實際需求,不必強求每個欄位完全照搬。需要查閱相關欄位的基礎概念,可參考協定、核心與路由術語。
遷移時,依序還原訂閱、目前使用的節點、本機入口與自訂分流,最後再恢復自動化設定。不要將桌面版使用的迴環埠號複製給行動裝置上的應用程式,也不要假設其中一端的預設模式就是另一端的全域模式。請分別說明同一項服務允許的失敗範圍,例如只有指定網站應走代理,區域網路資源則維持直連。跨裝置驗證時,加入未命中規則的目標、明確指定直連的目標,以及一般代理目標。若沒有明確記錄預期出站,只確認「兩邊都能開啟」還不足以證明遷移完成。
保留回歸測試案例,限制自訂設定範圍
常用回歸案例可涵蓋五種情境:一般代理存取、應直連的目標、應阻擋的目標、訂閱更新,以及退出後一般網路能恢復。每次修改只登記可能受影響的情境,並在採用新設定前逐一測試。若工作環境有特殊解析需求,請分別記錄 Wi-Fi、行動網路與組織網路的狀況,避免把只在單一環境成立的結論寫成預設策略。排除故障時優先採用唯讀檢查,以最低限度的記錄層級取得足夠資訊後,再恢復原設定。
一套能長期維護的設定,應清楚交代入口來源、命中的出站規則、解析責任歸屬,以及如何回到上一個可用狀態。
只有圖形介面無法滿足明確需求時,才考慮使用用戶端與核心確實支援的自訂設定方式。用戶端可能重新產生暫存執行檔,直接編輯這類檔案容易在下次啟動時遭到覆蓋。請將可維護的設定儲存在受支援的位置,並保留一套不使用自訂設定也能啟動的基準。若新規則沒有對應的實際需求、比對案例或回復方式,就先不要納入日常設定。至此,安裝、訂閱、系統入口、路由與流量接管都能各自驗證;遇到新問題時,回到相關章節即可,不必重做整個安裝流程。