V2Ray 全平台安裝指南
訂閱、代理與 TUN 設定

01 / PREPARATION

通用準備工作

先釐清用戶端、核心與伺服器設定

用戶端負責顯示節點、儲存訂閱、選擇路由及啟動連線；核心負責處理協定、加密傳輸與轉送流量；伺服器設定則提供遠端位址、連接埠及驗證參數。安裝用戶端不代表已經能連線。開始前請備妥有效的訂閱網址或完整節點參數，並確認目前網路可以正常瀏覽一般網站。

桌面平台建議使用 v2rayN；Android 通常可先選用 Xray 核心的 v2rayNG。只有在現有設定明確依賴 V2Fly 時，才考慮 v2flyNG。VLESS、VMess 與 Trojan 是不同協定，REALITY 則是與安全傳輸相關的設定，不能只因名稱相近就互換欄位。核心支援範圍也會因版本與建置方式而異；成功匯入不代表所有參數都能正常運作。

確認系統、架構與權限需求

先在系統資訊中確認處理器架構，再前往用戶端下載頁選擇安裝檔。系統與架構都必須符合要求：同為桌面系統，也可能分別需要 x64 或 arm64。不要以檔案大小判斷是否相容。安裝前請確認磁碟空間足夠，且目前帳戶有權安裝應用程式；若需要使用虛擬網卡，也須具備相應的管理權限。

先讓系統自動同步日期、時間與時區。時間有誤可能影響憑證驗證，也可能導致有時間條件的協定驗證失敗。若裝置長時間休眠、剛還原系統快照或曾離線存放，尤其要檢查這項設定。接著確認網路不需要透過登入頁面驗證；網路本身尚未連線時，反覆修改節點通常無法解決問題。

初次設定前，請先退出其他正在接管網路的代理或隧道程式。多個程式可能搶用同一個本機監聽連接埠，也可能同時修改系統代理、預設路由與 DNS。先讓一套用戶端運作，才能對照日誌與實際流量。若工作網路設有統一管理政策，請先確認允許的使用範圍，不要透過修改系統設定規避管理要求。

建立最小可驗證環境

先透過系統代理完成一次連線，再嘗試 TUN。系統代理通常只影響會讀取系統設定的應用程式，問題範圍較小；TUN 會接管更多流量，也會牽涉虛擬網卡、權限與路由。兩種方式都需要可用的遠端節點。基本連線尚未建立前就開啟所有進階選項，只會增加排查變數。

記下用戶端顯示的本機位址與監聽連接埠，並分清 HTTP、SOCKS 與混合入口。連接埠以實際設定為準，不要照抄其他裝置的截圖。本機迴圈位址只供本機使用；區域網路位址則供其他裝置連線，兩者用途不同。初次設定請維持本機監聽，暫時不要啟用「允許來自區域網路的連線」。

驗證時請同時檢查三個環節：用戶端能否啟動核心、應用程式是否將流量送到本機入口，以及遠端請求能否收到回應。只看到系統匣圖示、連線開關或測速結果，都不足以證明整條連線流程正常。之後每次只改一項設定，記下修改前的值與重現方式，方便失敗時還原。

若已有使用中的環境，請先匯出設定或備份應用程式資料，再進行安裝與更新。備份內容也可能包含訂閱與節點驗證資訊，請存放在安全的位置。本文依設定功能名稱說明操作，不假設各版本的選單排列完全相同；若介面不同，請找出對應欄位，而非執著於完全相同的按鈕位置。

02 / WINDOWS

Windows 安裝與設定

桌面版與經典 WPF 版怎麼選

前往Windows 下載區，在 v2rayN 卡片中選擇桌面版或經典 WPF 版。桌面版採用跨平台介面；WPF 版則保留經典 Windows 介面。兩者都可管理節點、訂閱與代理設定。初次使用可從桌面版開始；若已習慣 WPF 的操作方式，照原本流程選用即可，不必因介面不同而同時執行兩個版本。

下載後依照安裝程式指示選擇目錄。請選擇目前帳戶有寫入權限的位置，避免放在暫存下載資料夾，或會被同步軟體頻繁搬動的路徑。若啟動時提示缺少執行環境，先確認訊息中提到的元件名稱與架構，再依下載頁說明補齊。不要只憑錯誤截圖猜測版本，也不要隨意複製其他電腦的執行檔覆蓋安裝目錄。

匯入訂閱並選擇使用中的節點

啟動 v2rayN，開啟「訂閱群組設定」，新增群組並填入備註與訂閱網址。備註只用來辨識來源，不會參與連線驗證。儲存後執行「更新訂閱（不透過代理）」，前提是目前網路可以直接連到該網址。若服務提供者說明更新必須透過既有代理，請先恢復一條可用連線，再切換更新方式。

更新完成後，查看訂閱日誌與節點清單，確認新增內容屬於剛才建立的群組。選取一個節點並設為目前使用的伺服器，接著確認核心能否正常啟動。不要只看「訂閱更新成功」的提示：這通常只代表內容已取得並完成解析，節點的遠端位址、傳輸參數與服務狀態仍須實際發出請求驗證。

先設定系統代理，再處理應用程式差異

在系統匣選單中選擇「自動設定系統代理」，再開啟瀏覽器測試。若瀏覽器先前一直開著，請關閉相關視窗後重新啟動，避免舊連線與快取設定干擾。系統代理不會強制所有應用程式使用相同路徑；部分命令列程式、下載工具或使用自有網路堆疊的應用程式，需要另外設定代理，或改用 TUN。

若要用其他應用程式單獨測試，請填入 v2rayN 設定頁顯示的本機迴圈位址與對應連接埠，並選擇正確的代理類型。把 SOCKS 連接埠填入 HTTP 代理欄位，可能會在連線建立後立刻失敗。若應用程式支援「使用系統代理」，請先保留此選項，避免系統設定與應用程式手動設定產生互相矛盾的規則。

TUN 權限與 Windows 特有問題

需要接管不讀取系統代理的應用程式時，再啟用「TUN 模式」。依用戶端提示授予所需權限，並確認虛擬網卡與路由已建立。啟用後先重做先前成功的瀏覽器測試，再測試目標應用程式。若基本連線立刻失效，先關閉 TUN 還原原狀，再檢查日誌中的權限、網卡建立與位址衝突訊息。

安全軟體可能會限制程式啟動核心或建立網卡。若出現封鎖提示，請核對實際安裝來源與遭封鎖的操作，再依組織政策處理，不要關閉整套系統防護。Windows 防火牆也要分清本機存取與區域網路連入；若只在本機使用代理，排查時不應將所有網路類型的連入規則一律放行。

從休眠喚醒、切換無線網路，或從有線網路改用無線網路後，若連線無法恢復，先停止並重新啟動代理，再檢查本機監聽與預設路由。開機自動啟動也要實際測試：桌面介面自動出現，不代表需要提升權限的 TUN 已成功啟用。若有無人值守需求，請依用戶端提供的啟動機制設定，不要把啟動提示視為連線完成。

更新前請備份設定，並先退出目前執行中的程序再安裝。若系統提示檔案正在使用，請確認系統匣中是否仍有程式執行，不要連續啟動安裝程式。更新後先確認使用中的節點與代理模式，再還原自訂路由。若核心啟動異常，可繼續閱讀核心啟動失敗的日誌排查，從第一條有效錯誤著手。

03 / MACOS

macOS 安裝與設定

依晶片選擇安裝版本

開啟系統的「關於這台 Mac」，查看「晶片」或「處理器」欄位，再前往macOS 下載區。Apple Silicon 請選 arm64 版本，Intel 處理器則選 x64 版本。優先使用符合本機架構的安裝檔，不要預設使用相容執行方式；架構不符時，啟動失敗與核心子程序失敗可能會顯示不同訊息。

開啟下載的磁碟映像檔，依畫面指示將 v2rayN 移至「應用程式」，再從該資料夾啟動。不要長期直接從暫時掛載的映像檔執行，否則更新路徑、寫入權限與啟動項目可能難以維持一致。首次啟動前請先退出舊執行個體；若曾搬移應用程式資料夾，也請確認 Dock 或啟動項目沒有繼續指向舊副本。

若系統安全提示阻止啟動，請先確認檔案來源與提示內容，再查看「系統設定」中的「隱私權與安全性」。確認來源可信後，只依系統提供的方式處理。不要把遞迴修改系統權限或關閉整體安全機制當成標準安裝步驟。若錯誤明確指出架構或執行元件問題，應處理相應依賴，不要一概歸因於安全封鎖。

匯入訂閱與網路服務代理

在「訂閱群組設定」中填入訂閱網址並儲存，再依目前網路選擇更新方式。節點出現後，選取目前使用的伺服器並查看核心日誌。若訂閱可以更新但節點無法使用，請分別檢查訂閱取得流程與節點連線流程；兩者可能使用不同網域、連接埠及網路路徑，不能因其中一項成功就認定另一項也正常。

啟用系統代理時，請留意系統要求的授權提示。macOS 的代理設定與網路服務相關，無線與有線介面可能各自保留不同設定。切換網路後若只有部分應用程式失效，請開啟目前網路服務的代理頁面，確認位址與連接埠仍指向 v2rayN 的本機監聽，而不是先前安裝的另一份程式。

瀏覽器測試通過後，再確認目標應用程式是否會讀取系統代理。需要手動設定的應用程式，請依其支援的代理類型填入本機迴圈位址與實際連接埠。若代理設定正確但仍無法正常存取，可重新啟動應用程式以清除既有連線。不要在系統代理、應用程式代理與環境變數中同時填入不同連接埠，否則測試結果可能因啟動方式而異。

TUN 與網路切換的檢查順序

啟用 TUN 前，先儲存目前設定並確認一般代理連線可正常使用。TUN 需要建立虛擬網路介面與相關路由，所需權限不同於一般視窗操作。請依用戶端當下的提示授予權限；若介面顯示已開啟，但日誌仍出現權限錯誤，就表示尚未成功接管流量，不能只看開關外觀判斷。

若啟用 TUN 後連一般網站都無法存取，請先關閉 TUN，還原先前可用的系統代理路徑。接著檢查路由建立、DNS 處理及其他隧道程式是否衝突。企業網路或既有的遠端辦公隧道可能使用特殊路由，請在管理許可範圍內設定。不要直接刪除不熟悉的系統網路服務，以免影響原有網路環境。

從睡眠狀態喚醒後，舊連線可能仍指向已失效的網路介面。先停止連線，再重新啟動核心；必要時重新啟動目標應用程式，確認是否有新請求送出。若只有某個瀏覽器異常，再檢查該瀏覽器的安全 DNS、擴充功能代理與個別設定。系統層級已恢復時，無須立刻重裝整個用戶端。

更新或遷移前，先匯出訂閱與自訂規則，並記錄目前的監聽連接埠。完成新安裝後，先確認設定可正常讀取，再逐項還原自動啟動與 TUN。匯入 Windows 備份時，不要照搬磁碟路徑或啟動命令。節點參數可以跨平台沿用，但應用程式資料夾、輔助權限與網路介面屬於本機設定，必須重新確認。

04 / LINUX

Linux 安裝與設定

套件格式、架構與桌面工作階段

前往Linux 下載區，先依發行版的套件體系選擇 deb 或 rpm，再依處理器選擇 x64 或 arm64。套件格式與架構是兩項獨立條件：即使架構正確，也不能將不適用的套件格式交給本機套件管理工具安裝。桌面用戶端還需要可用的圖形工作階段；伺服器終端環境不等於桌面執行環境。

安裝前可在終端機查看電腦架構與系統資訊。以下命令只會辨識環境，不會修改網路。常見輸出中，x86_64 對應 x64，aarch64 通常對應 arm64。發行版資訊可用來確認套件體系與依賴條件，但不要據此推測用戶端支援的最低系統版本；實際需求請以下載頁說明與安裝錯誤訊息為準。

uname -m
cat /etc/os-release

使用桌面軟體安裝程式或發行版的套件管理工具安裝檔案。若缺少相依套件，請交由本機套件管理機制安裝相符套件。不要從其他發行版複製動態程式庫，也不要將不同架構的檔案放進系統目錄。安裝完成後，以一般桌面使用者身分啟動介面，先確認視窗與核心運作正常，再處理額外的網路權限。

匯入設定與桌面代理

開啟 v2rayN 的「訂閱群組設定」，建立群組、填入網址並更新。選定目前使用的節點後查看日誌，確認核心已成功啟動。若介面正常但子程序啟動失敗，請優先檢查相依套件、執行權限與工作目錄。錯誤若發生在圖形介面啟動階段，與發生在核心連線階段的處理方式不同，請保留完整錯誤訊息以便判斷。

Linux 桌面的系統代理實作方式並不一致。用戶端寫入代理設定後，有些桌面應用程式會讀取，有些則仍使用自己的設定。請先用可明確指定代理的瀏覽器或工具測試，再判斷系統代理是否生效。某個終端機命令仍直接連線，不代表節點失效；終端程式通常還需要設定代理環境變數。

若要為命令列工具設定代理，請先確認它支援的環境變數與代理協定，再填入本機實際監聽的連接埠。不要把網路範例中的固定連接埠直接寫進全域啟動檔。先在單次程序中測試，成功後再考慮永久設定；否則用戶端尚未啟動時，所有繼承該變數的工具都可能連到不存在的本機服務。

TUN 權限與監聽檢查

TUN 通常需要存取隧道裝置並修改路由的權限。請先確認一般代理可用，再依用戶端支援的方式授權。不同發行版的權限政策與桌面授權元件可能各異，不應預設以管理員身分長期執行整個圖形介面。若日誌指出權限不足，請找出失敗的具體操作，而不是反覆更換遠端節點。

本機連接埠衝突時，可用以下命令查看 TCP 監聽狀況，再與 v2rayN 設定中的位址和連接埠比對。能看到的程序資訊完整度取決於目前帳戶權限。這項檢查只能確認「哪個程序正在監聽」，無法證明遠端服務可用，也不能確認應用程式已將請求送到此入口；仍須搭配請求日誌判斷實際連線流程。

ss -ltnp

啟用 TUN 後若網域無法存取，但直接連線到已知位址有回應，請檢查 DNS 路徑與系統解析服務是否配合。系統可能由網路管理服務維護解析設定，手動覆寫設定檔可能在重新連線後失效。先查看目前生效的設定，再透過對應的管理介面修改，避免兩份 DNS 設定互相覆蓋。

切換桌面工作階段、網路連線或從休眠恢復後，請重新確認代理變數、監聽連接埠與路由。自動啟動只適用於已備妥的工作階段環境，無法保證需要提升權限的步驟也會自動完成。更新前匯出設定，更新後先測試一般代理，再還原 TUN 與自訂規則；若發生問題，保留套件管理工具與用戶端的日誌，以分辨安裝失敗或執行失敗。

05 / ANDROID

Android 安裝與設定

如何選擇 v2rayNG 與 v2flyNG

前往Android 下載區，優先查看 v2rayNG，其核心為 Xray；若現有設定明確採用 V2Fly 生態系，可將 v2flyNG 作為替代選擇。兩者並非同一款應用程式的不同介面主題，協定支援與欄位相容性也不能直接畫上等號。尤其使用 REALITY 或 Vision 參數時，請先確認所選核心支援該組設定。

下載頁提供 arm64 與通用版。較新的主流裝置通常可先考慮 arm64，但最後仍應以系統架構為準；不確定架構時，再查看通用版說明。安裝失敗時先閱讀系統提示，分辨架構不符、儲存空間不足或已有應用程式衝突，不要將所有安裝錯誤都歸因於網路下載問題。

初次安裝時，需授予執行安裝的瀏覽器或檔案管理工具相應的安裝權限。完成後可依需求撤銷該來源的授權。若已有同名應用程式，更新前請先備份設定；若系統提示安裝來源或簽章不相容，不要直接解除安裝舊版，因為解除安裝可能會刪除本機群組、自訂規則及尚未匯出的設定。

匯入訂閱、更新設定與連線授權

在用戶端的「訂閱群組設定」中新增訂閱，填入備註與網址，儲存後執行更新。不同版本可能將更新功能放在主選單或群組選單，找到對應功能名稱即可。若要從剪貼簿匯入單一分享連結，請先確認剪貼簿內容完整；訂閱網址、單一節點分享連結與完整 JSON 設定是不同內容，不能任意共用匯入入口。

更新後選取一個設定，再點選連線。Android 會要求確認 VPN 連線授權，此授權用於建立本機流量接管通道，不代表遠端節點已可連線。出現連線圖示後仍須開啟測試目標並查看日誌。若系統已在執行其他 VPN 連線，新連線可能會取代舊連線，請先確認兩者的使用關係。

一般連線會透過系統提供的 VPN 介面接管流量，不需要照搬桌面版的系統代理或 TUN 開關操作。若應用程式提供不同執行模式，請依目前版本的說明選擇。不要為了重現桌面選單而尋找不存在的選項，也不要只因系統顯示 VPN 圖示，就忽略節點驗證與路由規則檢查。

背景執行、應用程式分流與網路切換

若螢幕熄滅後連線中斷，請檢查電池最佳化、背景活動與自動啟動限制。透過系統提供的應用程式管理介面，為用戶端設定合適的背景執行條件，再鎖定螢幕等待並測試連線是否恢復。調整時也要留意耗電與連線需求，不必一次開放所有背景權限。常駐通知與連線維持有關，但通知仍在也不代表遠端服務可用。

設定應用程式分流前，先分清「只代理選取的應用程式」與「略過選取的應用程式」兩種模式，兩者方向相反。變更清單後，請停止並重新建立連線，再重新啟動要測試的應用程式，以減少舊連線的影響。若瀏覽器可用、只有某個應用程式無法連線，請優先檢查分流清單、該應用程式的代理設定與網路權限，不要立刻重裝用戶端。

切換網路後，原有連線可能需要重新建立。先中斷再連線，查看日誌是否重新送出請求；若仍失敗，確認目前網路本身是否已連線。若問題只出現在大型請求或部分應用程式，不要先隨意調整 MTU；應先排除節點、DNS 與路由差異，再根據可重現的現象判斷是否與封包大小有關。

從 v2rayNG 遷移至 v2flyNG 時，建議重新匯入訂閱，不要直接覆蓋應用程式的私有資料。保留原用戶端設定，確認新用戶端能解析並執行目標協定後，再清除舊資料。若要了解核心能力的差異，可閱讀Xray 與 V2Fly 核心差異；選擇時應以實際欄位支援情況為準，不要只憑名稱相近判斷相容性。

06 / SUBSCRIPTIONS

訂閱管理與設定遷移

分辨網址、分享連結與設定檔

訂閱網址用來取得一組設定；節點分享連結通常代表單一連線；完整 JSON 則可能包含入站、出站、路由與 DNS。匯入前先判斷內容類型，再選擇相應入口。將網頁網址當作節點匯入，或把完整設定貼到訂閱欄位，都可能導致解析失敗。不要只因文字以某個協定名稱開頭，就忽略後續結構是否完整。

每個來源請分別建立訂閱群組，並在備註中寫明用途與管理範圍。群組不是遠端帳戶，修改備註不會改變服務權限。網址中的查詢參數可能用於驗證，複製時須完整保留，避免聊天軟體截斷或加入空白。手動修改網址前請先儲存原值，不要憑經驗刪除看似多餘的參數。

選擇更新方式並檢查結果

「不透過代理」適用於目前網路可直接連線至訂閱服務的情況；透過代理更新則需要一條已可用的連線。初次使用時尚未選定可用節點，容易形成依賴循環。更新失敗時，先判斷是請求逾時、驗證失敗還是內容解析失敗；不同階段的原因不同，不要只看一則錯誤訊息就更換所有節點。

更新成功後，檢查節點數量變化、所屬群組與目前使用的節點。訂閱來源可能刪除或重新命名項目，先前選取的節點不一定仍有效。重要測試前請重新選取清單中的現有項目，再啟動連線。訂閱內容由服務端管理，直接修改受訂閱管理的節點欄位，可能在下次更新時被覆蓋；要測試變更，請先複製成獨立設定。

若無法識別回傳內容，請確認網址實際回傳的是登入頁、錯誤頁或過期提示。在瀏覽器中開啟網頁，不代表用戶端已取得可解析的訂閱。反過來說，訂閱下載成功也不代表節點的遠端連接埠可用。將訂閱下載與代理連線分開測試，才能避免在錯誤的環節反覆修改設定。

手動參數的核對順序

手動新增節點時，先核對協定、伺服器位址、連接埠與驗證欄位，再檢查傳輸方式、安全設定及其他參數。傳輸路徑、主機名稱與伺服器名稱各有用途，不能因為看起來都是網域就互相替代。若設定包含 REALITY，還須核對公鑰、短識別碼等配套參數；這些值必須由伺服器設定提供，不能自行產生後期待連上現有服務。

一般排錯時，不要直接編輯用戶端自動產生的執行設定。切換節點或重新啟動核心時，用戶端可能會重新產生檔案，手動修改也會隨之消失。請優先透過圖形介面調整；若確實需要完整自訂設定，請先釐清哪些設定由檔案控制、哪些仍由介面管理，並備份可用版本以便還原。

備份範圍與跨平台還原

遷移前請一併保留訂閱網址、獨立節點、自訂路由、DNS 設定與必要的本機監聽紀錄。訂閱可以重新下載，但獨立設定與本機規則不一定能還原。匯出檔可能含有驗證資訊，請限制存取權限；分享排錯資料時，只保留設定結構與錯誤位置，並移除可用來實際連線的內容。

還原時，先匯入訂閱並建立一般連線，再還原路由、應用程式分流與 TUN。跨平台遷移時，不要照搬資料夾路徑、網卡名稱與啟動項目。即使同樣使用 v2rayN，不同系統的權限機制也不相同。若一次還原所有設定後出現問題，很難判斷是訂閱、舊路徑還是網卡權限所致；分階段還原更容易找出原因。

手動更新訂閱穩定後，再設定自動更新。更新間隔應依實際變更需求調整，不必用頻繁請求取代故障排查。每次更新後簡單驗證：確認目前使用的節點仍存在、核心可以啟動、常用應用程式能正常連線。若服務提供者已停用舊網址，請更換訂閱來源，而不是反覆匯入同一個失效連結。

07 / ROUTING & DNS

路由、DNS 與模式選擇

流量接管與路由判斷是兩種不同設定

系統代理與 TUN 決定「哪些流量會進入用戶端」；路由則決定「進入後使用哪個出站」。啟用 TUN 不代表所有流量都會經由遠端轉送；選擇全域路由，也無法強迫完全不讀取系統代理的應用程式交出請求。排查時先確認應用程式的流量是否進入本機入口，再判斷規則是否將請求送往預期的出口。

初次使用可先採用用戶端提供的預設路由，例如「繞過中國大陸」，確認日常請求的路徑後再新增規則。預設路由依賴網域與位址分類資料，不會根據網站介面語言判斷。部分服務可能同時請求多個網域，也可能共用位址；若頁面能開啟、部分資源卻失敗，請檢查實際失敗的請求，而非只查看主網域。

規則順序、比對條件與出站標籤

路由規則通常依序比對，較明確的規則應放在可能先行命中的廣泛規則之前。網域規則依用戶端取得的目標網域比對，位址規則則依目標 IP 比對，兩者不一定都能取得。若應用程式直接連線至 IP、使用自己的 DNS，或採用不同的嗅探設定，比對條件可能改變；不能只看規則文字就認定一定會命中。

以下是 Xray 格式的路由片段示意，並非可直接連線的完整設定。使用前須確保已有名為 direct 的直連出站，且核心可讀取所需的分類資料。此片段只會將私有位址與指定分類的流量送往直連；未命中的流量仍須由完整設定中的出站順序或後續規則決定，片段本身並未設定最終代理出口。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

圖形用戶端通常提供路由編輯功能，建議優先透過介面設定，以免與自動產生的檔案衝突。出站標籤必須確實存在於完整設定中，且拼寫一致；標籤不是可以任意填寫的顯示備註。不同核心的欄位與規則格式也可能不同，不能將某個核心的 JSON 片段直接貼到另一個核心的設定中。

DNS 設定須配合實際請求路徑

DNS 會將網域解析成位址，但查詢可能來自系統、瀏覽器或核心。啟用瀏覽器安全 DNS 後，瀏覽器可能不再沿用系統的解析路徑。網域存取異常時，先確認由哪個元件負責解析，再檢查查詢是否能送達所選伺服器。單純增加多個 DNS 位址，無法自動修正錯誤的請求路徑。

代理伺服器本身使用網域時，也必須先解析該網域，才能建立遠端連線。若解析請求又依賴尚未建立的代理，可能形成啟動依賴循環。請先使用用戶端提供的合理預設值，建立基本連線後再調整遠端 DNS 與直連 DNS。每次修改後都要重新建立連線，並留意系統與應用程式快取可能暫時保留舊結果。

區域網路與 TUN 的適用範圍

存取本機路由器、網路印表機或區域網路管理頁面時，通常需要保留正確的直連路徑。啟用 TUN 後若無法使用本機服務，請檢查私有位址路由與系統既有網段，不要強制將所有位址送往遠端。遠端辦公網路也可能使用特定網段，請依實際網路設定建立規則，不要將公開範例當成完整解法。

「允許來自區域網路的連線」是開放本機代理入口，與 TUN 並非同一設定。啟用後，其他裝置須填入執行用戶端之電腦的區域網路位址與監聽連接埠，也會受到防火牆與網路隔離影響。請只在可信任的網路環境中按需開放，並限制可存取的範圍；詳細設定請參閱區域網路代理分享設定。

確認規則穩定後，記錄預設名稱、自訂項目與 DNS 設定。之後更換核心時，先還原基本預設，再移植自訂規則，以免舊欄位導致啟動失敗。若要了解設定流程，可閱讀inbounds、outbounds 與 routing 結構詳解，將介面欄位與執行設定對照。

08 / TROUBLESHOOTING

常見設定問題

從第一個失敗環節開始檢查

排錯時請固定一組條件：同一個網路、使用中的節點、目標應用程式與測試網址。依序檢查安裝啟動、訂閱取得、核心執行、本機流量接管與遠端連線。前一個環節尚未通過，就不要用後續設定補救。例如核心根本沒有監聽連接埠時，修改瀏覽器 DNS 很難解決問題；訂閱網址已過期，也不需要重裝虛擬網卡。

開啟用戶端日誌，先找出本次連線開始後第一條有效錯誤，再查看後續連鎖訊息。連接埠遭占用、權限不足、未知欄位與交握失敗，分別指向不同層級。記下發生時間與剛才執行的操作，截取足以交代上下文的幾行。不要公開完整設定與訂閱資訊，也不要只保留介面上的「連線失敗」提示。

依問題現象查看相應項目

延遲測試與實際請求應分開判斷

測試結果只適用於當次測試目標與使用的方法，不能代表所有網站或協定都正常。測試失敗也可能是目標沒有回應、請求路徑不同或 DNS 異常。請優先使用可穩定重現的實際請求，並搭配連線日誌判斷。若問題偶爾出現，請在同一網路的不同时段分別重測，不要只憑一次結果就判定所有設定。

整理問題時，請寫明系統與架構、用戶端名稱、執行模式、受影響範圍，以及已單獨修改的項目。附上已移除敏感資訊的錯誤訊息，比整頁節點清單更有幫助。基本連線恢復後，回到快速入門教學完成最後驗證；需要重新選擇安裝檔時，請前往下載頁。保留最後一份可用設定，再繼續調整進階功能。