V2Ray 安裝與設定指南

設定前檢查

一般準備：先確認平台與設定來源

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

桌面平台建議使用 v2rayN，適用於 Windows、macOS 和 Linux；Android 建議使用採用 Xray 核心的 v2rayNG，若需要 V2Fly 核心生態系，再考慮 v2flyNG。圖形介面用戶端負責儲存設定、更新訂閱、產生執行參數及控制核心，實際處理連線的是核心程序。安裝用戶端不會自動取得可用伺服器，也不會替您建立訂閱。開始前請準備合法取得且仍在有效期限內的設定，並確認適用的協定與傳輸組合。

伺服器位址、連接埠、使用者識別碼、傳輸方式與安全設定必須配套使用。不要因為協定名稱相同，就把另一份設定的 TLS、路徑或伺服器名稱拼湊進來。尤其是 VLESS、Trojan 等設定，驗證欄位與外層安全參數各有用途，缺少其中一項也可能造成連線逾時。遇到無法匯入的連結，先判斷它是單一伺服器分享連結、訂閱網址，還是完整設定檔，再選擇相應的匯入方式，不要一再貼到同一個文字欄位。

確認裝置架構、時間與網路基準

下載前先查看系統資訊。Windows 查看「系統類型」，macOS 查看「關於這台 Mac」中的晶片資訊；Linux 則要確認處理器架構與發行版套件格式。Android 多數新型裝置使用 arm64，但仍應以裝置實際支援的 ABI 為準，不要只憑購買年份判斷。安裝套件格式與處理器架構是兩回事：deb 和 rpm 決定套件管理方式，x64 和 arm64 則決定可執行程式能否執行。下載頁的標示必須同時符合這兩項。

啟用系統自動校時，並確認時區設定正確。系統時間錯誤會影響憑證效期判斷，也可能干擾依賴時間的驗證。接著在關閉代理的狀態下開啟常用網站，確認本地網路是否正常；若基本網路無法使用，請先檢查無線連線、閘道器或網路登入頁面。測試期間暫時退出其他代理和 VPN 工具，避免系統設定遭到多次覆寫。公司或學校配發的裝置也可能套用管理者設定的代理政策，反覆切換開關無法解決這類問題。

建立可還原的初始狀態

第一次執行時只匯入一組設定、選擇一台伺服器，並先使用用戶端預設的基本路由。不要同時啟用 TUN、自訂 DNS、遠端規則和多個實驗性選項。每完成一項調整，就重試相同的測試目標，並記下修改前後的差異，才能將問題範圍縮小至最近變動的設定。正式調整前請儲存現有設定或截圖，但截圖應遮住訂閱網址、使用者識別碼與驗證欄位；這些資訊即使看起來只是連結，也可能代表帳戶存取權限。

最後確認驗證標準：瀏覽器能否載入目標網頁、用戶端是否有相應的連線記錄，以及直連網站是否仍可存取。單次延遲測試成功，只代表特定探測收到回應，不表示網頁、DNS 或所有應用程式都已設定完成。以下各平台章節都依「安裝、匯入、接管、驗證」的順序說明，您可以直接前往使用的平台，但不要略過這輪基準檢查。

桌面平台 / Windows

Windows：v2rayN 安裝與系統代理

選擇桌面版或傳統 WPF 版

前往Windows 下載頁選擇 v2rayN。桌面版採用新一代跨平台介面，傳統 WPF 版則沿用 Windows 桌面介面；請依使用習慣與實際相容性選擇，不要同時執行兩個版本來比較連線效果。下載頁目前提供的 x64 安裝程式適用於相應的系統架構。執行前請閱讀安裝程式提示；若系統缺少執行元件，請依用戶端或安裝程式說明補齊，不要從不明來源下載同名動態連結程式庫來覆蓋檔案。

安裝後先以一般使用者權限啟動。主視窗能開啟，不代表核心已經啟動；請在記錄區確認設定已載入，且本機入站連接埠正在監聽。程式目錄與使用者資料目錄可能分開儲存，更新或移轉前請使用用戶端支援的匯出功能備份設定。不要將程式放在臨時解壓縮資料夾後隨手刪除，也不要在程式執行時移動整個目錄，否則下次啟動可能找不到核心、規則檔或已儲存的設定。

匯入訂閱並指定使用中的伺服器

開啟訂閱群組或訂閱管理頁面，新增容易辨識的群組名稱，將完整訂閱網址填入網址欄位並儲存，再執行更新。如果只有單一分享連結，請使用從剪貼簿匯入等相應功能，不必硬是建立訂閱群組。更新後確認清單中出現預期的設定，再透過雙擊或「設為使用中伺服器」選單指定一項設定。清單中有伺服器，不代表正在使用該伺服器；請一併確認使用中標記與核心執行狀態。

訂閱更新失敗時，先查看記錄判斷是解析失敗、驗證失敗還是要求逾時。初次連線尚未建立時，選擇經由代理更新可能形成相依循環；此時可嘗試直接更新，或使用設定提供者允許的其他取得方式。不要為了讓清單出現內容而關閉所有安全檢查。若更新成功但清單為空，請檢查群組篩選、帳戶有效性與回傳內容格式，也確認複製訂閱網址時沒有夾帶換行或末尾標點。

從系統代理開始，再決定是否使用 TUN

選好伺服器後，將系統代理設為「自動設定系統代理」或實際介面中功能相同的選項。這會讓遵循 Windows 系統代理設定的應用程式使用本機代理入口，但不會接管所有網路程式。瀏覽器設定也可能遭擴充功能或獨立代理設定覆寫；命令列工具通常也不會讀取系統代理。遇到這種情況，先別急著更換伺服器，請觀察用戶端在送出要求時是否留下連線記錄，確認要求有沒有進入本機入口。

確實需要接管更多應用程式時，再啟用 TUN 並依程式提示授予必要權限。TUN 涉及虛擬網路介面、路由與 DNS，不只是換一種方式呈現系統代理按鈕。首次測試可先關閉系統代理，只保留一種接管方式；確認可用後，再依用戶端建議設定組合。遇到驅動程式、虛擬網卡或路由錯誤，請記錄錯誤訊息並檢查權限及其他 VPN 軟體，不要以關閉整個防火牆代替問題排查。

驗證連線並在結束後還原設定

使用瀏覽器瀏覽一個明確需要代理的目標，再開啟一個應直接連線的目標，對照記錄中的出站選擇。若瀏覽器可用、終端卻無法使用，請參閱分別排查系統代理與終端問題，不要把應用程式差異歸咎於伺服器。結束使用前，先清除系統代理再退出用戶端。若異常關機後瀏覽器顯示代理無法連線，請到 Windows 網路代理設定檢查是否仍指向已停止的本機連接埠；還原設定後再重新啟動用戶端測試。

桌面平台 / macOS

macOS：晶片選擇、權限與網路服務

依晶片架構安裝 v2rayN

開啟macOS 下載頁，Apple Silicon 裝置選擇 arm64，Intel 裝置選擇 x64。可在「關於這台 Mac」查看晶片資訊，不要只憑產品外觀或機型名稱判斷。下載 DMG 後開啟磁碟映像檔，依安裝畫面將應用程式移至「應用程式」資料夾，再從正式位置啟動。長期直接從磁碟映像檔執行，推出映像檔、更新程式或重新開機後都可能遇到路徑與權限問題，也不利於後續維護。

首次啟動可能受到系統安全政策限制。請先核對應用程式來源與選擇的平台，再到系統設定的「隱私權與安全性」查看是否有允許開啟的選項。受管理的裝置可能禁止使用者自行允許，此時請聯絡管理者處理。不要為了執行單一程式而關閉整台裝置的安全機制，也不要批次刪除不明的系統屬性。若提示程式架構不符，請返回下載頁重新選擇，不要將所有啟動錯誤都當成權限問題。

匯入設定並檢查核心狀態

在 v2rayN 中建立訂閱群組、儲存網址並更新，接著將一項設定設為使用中伺服器。匯入單一分享連結時請使用剪貼簿入口；匯入完整檔案前，則要確認檔案適用於目前的用戶端，不要將核心專用 JSON 當成訂閱網址。設定出現後查看執行記錄，確認核心沒有立即結束。某些問題只會影響背景程序，主視窗仍可操作，因此「介面能開啟」不能作為安裝完成的唯一依據。

先使用預設或基本路由測試連線，再逐項調整 DNS 與分流。更換核心前，請確認所選協定與傳輸方式受目標核心支援；同一設定顯示相同名稱，不代表產生的參數完全相容。切換後若出現未知欄位或設定解析錯誤，請還原原本的核心並查看用戶端產生的設定相關提示。不要在使用者介面與手動設定檔之間反覆覆寫，否則下次儲存時可能又還原修改。

系統代理與網路服務的對應關係

macOS 的代理設定與網路服務相關。啟用系統代理後，請檢查目前實際使用的是 Wi-Fi、有線網路還是其他服務；切換介面後若只有部分應用程式恢復直連，可能是新網路服務尚未套用相應設定。系統設定中的 HTTP、HTTPS 與 SOCKS 代理欄位各有用途，不能因為位址都是本機就互換連接埠。使用用戶端自動設定時，先保留自動產生的結果，確認連線後再進行必要的手動調整。

瀏覽器可能遵循系統代理，也可能遭擴充功能或應用程式本身的網路選項覆寫。終端程式通常需要自己的代理參數或環境變數，不會因為選單列顯示代理已啟用就自動改變行為。切換網路後也請重新建立測試連線，既有連線可能仍沿用舊路徑。驗證時使用相同目標建立新要求，再查看記錄，避免將頁面快取、既有連線或應用程式背景重試誤認為目前設定已生效。

TUN 授權、睡眠與恢復

需要使用 TUN 時，請依用戶端提示完成權限申請。建立虛擬介面和修改路由通常需要額外權限，具體方式以目前程式的實作為準。啟用後若整個網路中斷，先關閉 TUN 恢復網路，再檢查記錄中的介面建立、路由寫入與 DNS 錯誤。不要同時啟用另一套 VPN 的全域接管來「補救」，兩者可能爭用預設路由，讓問題更難重現。工作裝置上的安全軟體也可能限制這類網路操作。

退出前清除系統代理，並確認瀏覽器是否恢復直連。若應用程式已退出，但網頁仍顯示本機代理連線失敗，請檢查目前網路服務的代理設定是否有殘留項目。不要一開始就刪除整個網路服務或重設所有網路設定。保留訂閱與路由設定，只還原流量接管層，通常能將影響範圍縮到最小；確認恢復後，再回到用戶端逐項重新啟用功能並測試。

桌面平台 / Linux

Linux：套件、桌面代理與執行權限

確認架構與發行版套件格式相符

在 Linux 上使用 v2rayN 桌面用戶端時，先到Linux 下載頁區分 deb 與 rpm，再選擇 x64 或 arm64。Debian、Ubuntu 等發行版通常使用 deb，Fedora 等通常使用 rpm，但仍應以本機套件管理系統為準。可使用下方唯讀命令查看架構與系統資訊：輸出中的 x86_64通常對應 x64，aarch64通常對應 arm64。不要只改副檔名，將套件偽裝成另一種格式安裝。

uname -m
cat /etc/os-release

下載完成後，可使用桌面軟體安裝程式開啟套件，或依發行版文件使用套件管理器安裝。若缺少相依套件，請先讓套件管理器列出具體項目，再確認目前桌面環境與系統版本是否符合需求。不要將其他發行版的系統程式庫直接複製到系統目錄。安裝失敗與用戶端設定失敗是不同階段：前者要先處理套件、相依性與架構，後者才需要檢查訂閱與核心參數；混在一起排查容易增加變數。

先以一般使用者啟動並匯入設定

安裝後從應用程式選單啟動 v2rayN，以一般使用者身分建立訂閱群組、儲存網址並更新。更新成功後選擇一台使用中的伺服器，再檢查核心記錄是否已進入監聽狀態。若桌面圖示無法開啟主視窗，可透過桌面環境提供的應用程式記錄入口查看錯誤；不要立刻以管理者權限執行整個介面。以不同身分啟動可能會使用不同資料目錄與檔案擁有者，之後一般使用者反而可能無法寫入原本的設定。

若曾以高權限啟動，導致設定無法寫入，請先退出程式並確認實際資料目錄，再依系統管理方式修正該目錄的擁有者，不要遞迴放寬整個家目錄的權限。訂閱網址與匯出的設定都屬於敏感資料，目錄存取權應限於需要使用的帳戶。更新用戶端時請保留使用者資料，更新完成後確認核心路徑與規則資源仍可找到；圖形程式更新成功，不代表原有外部路徑一定仍然有效。

了解桌面系統代理的適用範圍

Linux 的系統代理不是所有程式共用的統一開關。GNOME、KDE 等桌面環境各有代理設定，應用程式也可能只讀取環境變數、獨立設定檔或啟動參數。v2rayN 成功修改桌面代理後，瀏覽器可能已可正常使用，但終端機中的要求仍直接連線。遇到這種情況，先從應用程式層面的差異排查：確認要求是否進入用戶端，再決定是否為個別工具設定代理，或改用能接管更多流量的 TUN。

下方命令透過本機 SOCKS 入口向範例網站送出要求，適合檢查「工具到本機代理」這一段。連接埠必須改成用戶端設定中實際監聽的值；範例使用 socks5h，表示由代理端解析目標網域。測試成功只代表這次要求經過指定入口，不代表桌面系統代理、其他終端機或所有應用程式都已生效。若顯示連線遭拒，請先檢查核心是否正在執行，以及連接埠是否一致。

curl --proxy socks5h://127.0.0.1:10808 --head https://example.com

TUN 權限與網路管理衝突

TUN 需要存取虛擬網路裝置並管理相關路由。授權方式取決於用戶端套件與系統政策，請優先使用程式提供的權限流程，不要任意提高整個安裝目錄的權限。啟用失敗時，分別檢查虛擬裝置是否可用、權限是否遭拒，以及預設路由是否與其他 VPN 衝突。容器或受限的桌面工作階段可能根本不具備所需裝置與權限，反覆點擊開關無法解決，也不應因此放寬整台裝置的安全限制。

Linux 上還要留意系統解析服務與用戶端 DNS 的界線。系統可能透過本機存根解析器處理查詢，TUN 則可能接管另一條解析路徑。只有網域名稱無法使用時，請先比較系統解析與代理要求，不要同時修改網路管理器、解析服務和用戶端三處設定。退出後確認桌面代理與暫時設定的環境變數已還原；若只有特定終端機異常，請檢查該終端機的工作階段變數，而不是重新安裝用戶端。

行動裝置 / Android

Android：VPN 授權與背景執行

選擇 v2rayNG 或 v2flyNG

Android 首選 v2rayNG，採用 Xray 核心；若需要 V2Fly 核心生態系，可選擇 v2flyNG。兩款用戶端的Android 下載頁均提供 arm64 與通用安裝套件。多數新型裝置適用 arm64，但仍應確認系統位元數與裝置支援情況；無法判斷時可考慮通用套件。不要只因兩款應用程式的介面相似，就認為設定功能完全相同；協定、傳輸與安全參數仍取決於各自核心的支援程度。

安裝 APK 時，Android 可能要求授予瀏覽器或檔案管理員安裝應用程式的權限。請只為此次使用的來源按需授權，安裝完成後即可撤銷。若系統提示無法安裝，先檢查裝置架構、剩餘空間與既有應用程式的簽章是否衝突；無法覆蓋安裝不一定代表套件損毀。準備解除安裝並重裝前，請先使用用戶端功能備份必要設定；解除安裝可能會清除群組、路由與應用程式選擇，不要假設重裝後會自動還原。

匯入訂閱並首次授予 VPN 權限

開啟訂閱設定，新增群組並填入完整網址，儲存後回到清單更新訂閱，再點選要使用的伺服器。單一分享連結可從剪貼簿或 QR Code 入口匯入，但 QR Code 也可能包含帳戶資訊，不宜轉傳至公開平台。匯入後請核對協定與必要欄位，不要只看備註名稱。若清單中有多個群組，請確認目前的篩選條件沒有隱藏剛匯入的設定；更新完成也不代表使用中的伺服器已自動切換。

點選連線後，系統會顯示 VPN 連線授權提示；確認後，用戶端才能透過 Android 的 VpnService 接管流量。VPN 標誌表示系統已建立相關介面，不代表遠端伺服器已完成驗證，也不保證網頁一定能開啟。請再查看用戶端記錄，並實際瀏覽測試目標。一般應用程式通常只能使用一條作用中的系統 VPN 通道，其他 VPN、廣告過濾或網路防護應用程式可能會占用通道；請先決定要保留哪一個，再重新連線。

路由、個別應用程式與本機代理入口

先使用用戶端的基本路由連線，再依需求設定個別應用程式代理。不同介面中「代理所選應用程式」與「略過所選應用程式」的意思可能相反，儲存前務必確認目前模式。選擇瀏覽器時，也要考慮頁面是否會呼叫外部應用程式、下載管理員或系統服務；這些程式不一定與瀏覽器使用相同的身分。排查特定應用程式時，可先暫時恢復較廣的接管範圍；若恢復後能正常使用，再逐項縮小範圍，找出遺漏的項目。

Android 的 VPN 流量接管與桌面平台的系統 HTTP 代理不同，通常不需要在 Wi-Fi 進階設定中再填入本機代理。額外設定 Wi-Fi 代理反而可能在用戶端停止後造成網路異常。用戶端顯示的本機 SOCKS 連接埠主要供需要明確設定代理的程式使用，不代表區域網路中的其他裝置預設可以存取。不要為了方便測試就將監聽位址改為所有介面；跨裝置共用會引入存取控制、網路隔離與權限等新問題。

電池管理、網路切換與斷線恢復

若前景使用正常，但鎖定螢幕一段時間後就斷線，請優先檢查電池最佳化與背景活動限制。各家系統的設定位置不同，可在應用程式資訊中允許必要的背景執行，並依需要保留前景通知。將應用程式加入省電例外，只能降低它遭背景清除的機率，無法修正錯誤的伺服器或 DNS。若連線記錄在螢幕熄滅時停止，重新開啟應用程式後才恢復，較符合背景管理造成的影響；請與持續出現交握錯誤的情況區分。

在行動數據與 Wi-Fi 之間切換後，請先確認基本網路已完成登入，再重新建立連線。不同網路對 UDP、網域名稱解析或目標連接埠的處理方式可能不同，不能用單一網路的測試結果概括伺服器狀態。若只有背景執行時斷線，請接著閱讀v2rayNG 電池最佳化與個別應用程式設定；若兩種網路都無法載入網頁，請依本文末尾的記錄分層排查方式檢查，不要持續重新安裝應用程式。

跨平台 / 設定生命週期

訂閱管理：更新、選擇與備份

區分訂閱網址與分享連結

訂閱網址通常會透過一次網路要求回傳一組伺服器設定；單一分享連結則直接描述某台伺服器。兩者都可能複製到剪貼簿，但處理方式不同：訂閱應儲存在群組中以便更新，分享連結則透過相應的匯入入口解析。網頁網址也不一定是訂閱網址；帳戶管理頁、說明頁或登入導向頁都不能直接作為設定來源。更新後若記錄顯示解析失敗，請先向設定提供者確認網址用途與回傳格式。

訂閱網址通常包含存取憑證，取得網址的人可能因此存取同一帳戶的資源。請勿將完整網址貼到公開回報、線上解析網站或截圖中。描述問題時，只保留錯誤類型、用戶端名稱與必要的非敏感參數。QR Code、匯出檔案與備份目錄也應同樣謹慎處理。若網址已外洩，請透過設定提供者支援的管理入口重新產生或撤銷舊網址；只刪除本機瀏覽記錄，無法讓外部副本失效。

區分更新連線與實際使用的連線

直接更新與經由代理更新，決定的是訂閱要求透過哪條路徑取得，並不等於伺服器的路由模式。尚未有可用伺服器的初始狀態下，經由代理更新可能無法啟動；若既有連線可用，但直接連線無法存取訂閱服務，才可能需要經由代理更新。選擇時請分辨要求逾時、驗證遭拒與內容解析失敗這三種不同結果。若要求明確回報驗證錯誤，切換更新連線通常無法解決，應先檢查帳戶權限與網址有效性。

更新失敗後不要立即清空原有清單。先保留可能仍可使用的設定，記錄群組與錯誤資訊，再確認目前網路能否連線至訂閱服務。有些用戶端會保留舊設定，有些更新操作則可能重建群組中的項目；具體行為應依介面提示與實際結果判斷。手動編輯由訂閱產生的項目時尤其要謹慎，下次更新可能會覆寫修改。若長期需要自訂參數，建議使用用戶端支援的複製功能或獨立管理方式儲存設定。

更新成功後仍須確認使用中的項目

訂閱更新成功只表示取得與解析程序已完成，不保證目前使用中的伺服器仍然存在，也不代表它能正常連線。更新後請檢查使用中標記、協定類型與群組篩選，再送出實際要求。備註名稱可能重複或變更，不能只憑名稱判斷是否為同一項設定。有些項目的連接埠、傳輸路徑或安全參數也可能隨訂閱更新；排查更新後的故障時，請優先確認用戶端是否已重新載入新的執行設定。

延遲測試、連線測試與實際網頁載入並不相同。測試目標、解析方式與探測協定不同，結果也可能不同；某台伺服器在探測時有回應，仍可能無法存取特定網站。不要將清單排序後的第一項視為所有情境下的最佳選擇。更可靠的方式是選擇一項設定，以固定目標驗證網頁載入、網域名稱解析與直連例外，再依實際使用狀況決定是否保留，不要只依賴單一測試數值。

備份與移轉也要確認設定範圍

移轉至新裝置時，請優先匯出用戶端支援的設定，不要直接覆蓋另一平台的整個程式目錄。訂閱網址可以重新匯入，但本機連接埠、路由規則、個別應用程式選擇與系統流量接管權限未必會一併移轉。尤其 Android 的應用程式清單與桌面平台的應用程式路徑沒有直接對應關係，跨平台還原後請重新檢查。備份檔案應儲存在設有存取控制的位置；不要因為是個人筆記，就將完整驗證資訊放進公開同步內容。

若要比較用戶端的訂閱與核心功能，請參閱用戶端比較。不要以安裝更多用戶端取代來源與格式檢查；只要訂閱本身回傳錯誤內容，換用其他圖形介面通常還是會遇到相同問題。

跨平台 / 流量路徑

路由與 DNS：先接管流量，再決定出站

系統代理、TUN 與核心路由各自負責一層

先確認要求是否進入用戶端，再討論流量分流。系統代理會讓遵循系統設定的應用程式主動連線至本機入口；TUN 則透過虛擬網路介面接管適用的流量。流量進入核心後，路由規則才會決定使用代理、直連或其他已定義的出站。應用程式若略過系統代理，修改核心規則不會有任何效果。反過來說，要求已進入核心卻被規則分配至直連，就不應繼續排查瀏覽器的代理按鈕。記錄是區分這兩種情況的重要依據。

不同用戶端中的「全域」與「規則」可能位於不同設定層級。系統代理的全域設定通常只是讓更多要求送至本機代理，核心仍可能依規則選擇出站；有些用戶端的全域路由模式才會改變核心分流。因此請先確認目前調整的是系統流量接管方式，還是核心路由模式。測試時先固定接管方式，再比較路由變更；不要同時修改兩層，否則無法判斷是哪項設定讓要求恢復或失敗。

透過最精簡的規則了解比對順序

以下是 Xray 風格的局部路由範例，只示範將範例網域交由名為 direct的出站處理。這不是可直接啟動的完整設定，使用前必須在完整設定中定義同名出站；實際用戶端可能會自動產生其他標籤，請依產生結果調整。路由通常會依規則順序尋找符合項目，前面較寬泛的規則可能先於後面的精確規則命中。維護例外時，先檢查既有規則，不要不斷在末尾追加重複條件。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

精確網域與網域後綴的涵蓋範圍不同。只為主網域設定規則，不一定涵蓋網頁所需的圖片、驗證或介面網域。遇到網頁主體載入成功、登入卻失敗時，請查看失敗要求對應的網域與出站，不要直接將整個網路切換成另一種模式。位址規則也有類似限制：IPv4 與 IPv6 是不同的位址族，只處理其中一種，無法保證另一個通訊協定堆疊的要求也會依預期分流。

分清系統解析與核心解析

DNS 負責將網域名稱解析為位址，但系統、瀏覽器與代理核心可能各有解析路徑。瀏覽器若啟用自己的安全 DNS，解析結果未必來自系統解析器；應用程式向 SOCKS 入口傳送網域名稱或已解析的 IP 位址，也會影響核心可使用哪些網域條件。排查時先確認網域在哪一層解析、查詢經由哪個出站送出，再決定要修改哪一處。盲目同時更換所有 DNS，只會讓原本可定位的問題變成多個變數。

以下片段展示核心 DNS 伺服器陣列與查詢位址族設定，僅供局部參考。伺服器能否存取仍取決於目前網路、路由與用戶端產生的設定，不要將特定公共解析位址視為適用於所有網路的固定答案。若加密 DNS 的端點需要先解析網域，也要考慮啟動時如何取得該端點位址，避免解析要求依賴尚未建立的代理連線，造成彼此等待。

{
  "dns": {
    "servers": ["1.1.1.1", "8.8.8.8"],
    "queryStrategy": "UseIP"
  }
}

檢查區域網路、IPv6 與 UDP 限制

啟用 TUN 後若印表機、區域網路服務或本機管理頁面無法存取，請檢查私有位址與本機服務是否設有適當的略過規則。不要為了解決單一區域網路位址問題，就將所有流量設為直連。在 IPv6 環境中，也要留意應用程式實際使用的位址族；只用 IPv4 測試成功，不代表雙堆疊連線都能正常使用。語音、遊戲或其他 UDP 應用程式則須一併確認協定、伺服器與流量接管方式支援相應流量。

調整完成後重新載入核心，並透過新連線驗證。既有連線可能仍使用先前的出站，應用程式快取也可能保留舊的解析結果。只重新整理同一個頁面、不查看連線記錄，容易將快取造成的差異誤判為規則失效。

常見設定問題 / 分層排查

設定疑難排解：從本機入口到遠端連線

先記錄問題現象，不要同時重設所有設定

開始排查時，記下用戶端名稱、作業系統、使用的核心、流量接管方式與失敗的目標，並說明是所有應用程式都失敗，還是只有特定瀏覽器或終端機出問題。接著記錄上次成功後做過哪些變更，例如更新訂閱、切換網路、升級系統或調整路由。不要把這些資訊全縮成一句「已連線但不能用」。越具體的現象越容易找出問題，也能避免本機連接埠尚未監聽時就反覆更換遠端伺服器，或帳戶失效時仍持續調整 DNS。

先關閉 TUN 與系統代理，確認基本網路可正常使用，再只恢復一種流量接管方式。若關閉後仍無法連線，請檢查系統是否保留本機代理位址、Android 是否啟用了封鎖非 VPN 流量，或目前網路是否需要登入。只有直連基準恢復後，後續比較才有意義。還原設定時請保留訂閱與既有規則備份，不要將刪除所有資料當成預設處理方式，否則可能失去仍可用來比對的有效設定。

依據記錄判斷問題位置

記錄顯示監聽連接埠遭占用時，請先退出重複執行的用戶端，或其他占用相同連接埠的程式，再決定是否修改本機連接埠。若已修改連接埠，也要同步調整瀏覽器擴充功能、終端機參數與其他明確設定代理的項目。連線遭拒通常表示目標入口沒有在監聽；連線逾時則只代表未能在指定時間內完成連線，不能只憑這個用詞判定問題出在 DNS、網路或伺服器端。設定解析錯誤應優先檢查欄位與核心的相容性，而不是調整系統代理。

若要求沒有出現在記錄中，優先檢查應用程式到用戶端的路徑：系統代理是否生效、瀏覽器擴充功能是否覆寫設定、個別應用程式清單是否有所遺漏。若要求已出現但交握失敗，請檢查伺服器位址、連接埠、驗證、傳輸與安全參數是否相互配套，以及系統時間是否正確。若要求已依預期送出，但只有特定網站異常，再檢查該網站的解析、憑證與網路回應。不要因為單一目標失敗，就認定整個用戶端都沒有執行。

常見問題的處理範圍

回報問題時保留必要資訊

需要進一步協助時，請提供可重現的操作順序、故障時間附近的記錄，以及已經驗證過的排查步驟。遮住完整訂閱網址、使用者識別碼、密碼與其他驗證欄位，只保留判斷問題所需的資訊。提高記錄詳細程度後，可能會包含更多瀏覽目標；記錄完成後請恢復適當的詳細程度。不要在公開回報中直接上傳整個設定目錄，也不要以包含帳戶憑證的截圖取代文字說明。

若仍顯示連線正常，卻無法開啟網頁，請接著依照已連線但無法上網的逐項檢查清單核對。若只想重新走一次最精簡的設定流程，請返回快速入門指南；需要更換平台安裝套件時，請前往下載頁。保留一組確認可用的最簡設定，通常比不斷新增規則、切換核心或重裝程式更有助於排查下次故障。