全平台安裝與設定

通用準備事項

分清用戶端、核心與連線資料

用戶端負責圖形介面、訂閱管理與系統設定；核心則負責建立連線、處理協定及執行路由。桌面平台建議優先使用 v2rayN；Android 建議使用採用 Xray 核心的 v2rayNG。若需要相容 V2Fly 核心的環境，再考慮 v2flyNG。安裝用戶端不代表已有可用伺服器；開始前仍須準備有權使用的訂閱網址、單一分享連結或完整設定檔，以及服務提供者提供的協定與傳輸要求。

先辨別手上的連線資料。以協定名稱開頭的分享連結通常對應單一伺服器設定；一般網頁網址可能是訂閱介面，也可能只是管理頁面，兩者不能混用。完整 JSON 設定檔則可能同時包含入站、出站、路由與 DNS，不能直接貼到訂閱網址欄位。匯入前先確認格式，比反覆點選更新更有效。更多入口與格式說明請參閱訂閱連結匯入教學。

訂閱網址通常包含存取憑證，應當作帳戶資料妥善保管。不要在公開截圖中貼出完整網址，也不要為了轉換格式而提交到來源不明的網站。向他人說明問題時，只保留協定、傳輸方式與錯誤訊息，並隱去網址查詢參數、使用者識別資訊及密碼。要移轉裝置時，優先使用用戶端提供的匯出功能，並確認匯出的是伺服器清單，還是包含本機設定的完整備份。

確認架構、網路與權限

開啟系統的裝置資訊頁，確認作業系統、處理器架構與安裝檔類型。桌面版下載項目中的 x64 與 arm64 指的是指令集，不能只憑電腦品牌判斷；macOS 請在「關於這台 Mac」查看晶片資訊，Linux 可透過系統設定的「關於」頁面確認架構。多數較新的 Android 裝置適用 arm64 版本；無法確認時可先使用通用版。安裝檔請至用戶端下載頁取得，本手冊不重複提供檔案連結。

開始排查前，先退出其他代理或隧道程式，只保留一種流量接管方式。確認一般網路連線正常，完成需要透過瀏覽器登入的網路驗證，並確認系統日期、時間與時區正確。時間不準可能導致 TLS 憑證驗證失敗；尚未完成網路驗證，則可能使訂閱請求被重新導向至登入頁面。這兩種情況看起來像設定錯誤，實際上都應先在用戶端之外處理。

將一般代理與 TUN 分開測試。一般代理通常只會變更系統代理設定，或提供本機監聽連接埠；TUN 還涉及虛擬網路介面、路由與 DNS，可能需要管理員權限或輔助服務。先確認一般代理正常，再啟用 TUN，可將「伺服器無法使用」與「系統接管失敗」分成兩類問題。不要一開始就同時修改核心、DNS、路由與權限，否則即使連線恢復，也難以判斷是哪項變更生效。

建立可還原的基準設定

記下本機監聽位址與連接埠。常見設定是 SOCKS 使用 127.0.0.1:10808，HTTP 使用 127.0.0.1:10809，但應以目前用戶端設定及啟動記錄為準；部分版本使用混合連接埠，不一定會分別開啟兩個監聽服務。迴路位址只允許本機存取，適合初始設定。沒有明確需求時，不要改成監聽所有網路介面，也不要順手開放防火牆的輸入規則。

安裝完成後，先儲存一份已知可正常使用的設定，再更新訂閱及調整規則。可用的基準設定至少應包含：目前伺服器、核心類型、本機連接埠、系統代理狀態、路由模式與 TUN 開關。備份檔應存放在受控目錄；需要還原時，先退出用戶端，再依其備份機制匯入，避免執行中的程式將舊狀態重新寫入。移轉至其他裝置時，不要假設設定目錄、權限與絕對路徑完全相同。

驗收不能只看按鈕是否變色。依序確認記錄檔沒有啟動錯誤、應用程式確實使用目前的本機連接埠、目標請求有產生連線記錄，以及退出後系統網路能正常恢復。用戶端的連線測試只能反映特定探測方式，不能取代瀏覽器或實際應用程式的驗證。完成這些檢查後，再前往對應平台章節；之後遇到問題時，才能判斷問題出在安裝、匯入、核心還是流量接管。

Windows 安裝與設定

選擇桌面版或傳統 WPF 版

前往Windows 下載頁選擇 v2rayN。桌面版採用跨平台介面，傳統 WPF 版則使用 Windows 原生介面架構；兩者的選單配置、設定目錄與功能入口可能不同，不應同時執行來測試相同連接埠。想了解介面差異，請參閱Desktop 與 WPF 版選擇說明。先選一個版本完成基本設定，確認運作正常後，再評估是否移轉。

執行安裝程式時，依提示選擇安裝目錄與捷徑。升級現有安裝前，先退出系統匣中的用戶端並備份訂閱與本機設定；只關閉主視窗不一定會結束背景程序。安裝後從開始功能表啟動，先查看記錄檔是否指出執行環境、核心檔案或規則資源缺失。若系統顯示安全性警告，應先確認檔案來源與發行者資訊，不要為了解決啟動問題而關閉所有系統防護。

設定目錄與程式安裝目錄不一定相同，不能只把安裝位置當作備份位置。若介面提供開啟設定目錄或備份設定的選項，請優先使用。出現「無法寫入設定」時，先確認目前使用者有目錄寫入權限，以及目錄是否遭同步軟體或受控資料夾存取功能封鎖。日常使用不應長期以管理員身分執行；只有明確需要安裝服務或調整 TUN 權限時，才依介面提示提高權限。

匯入訂閱並選取使用中的伺服器

在 v2rayN 的「訂閱分組設定」中新增分組，輸入方便辨識的名稱，再將訂閱網址貼到對應欄位。第一次匯入時，先讓「過濾關鍵字」保持空白；儲存後回到主介面更新訂閱，並選取對應分組。更新成功只代表已取得並解析資料，還需在伺服器清單中選取一筆記錄並設為目前使用的伺服器。如果只是雙擊開啟編輯視窗，請關閉視窗後確認目前使用標記是否確實變更。

如果選單提供「透過代理更新」與「不透過代理更新」，首次尚無可用連線時，通常先試不透過代理更新；已有可用連線，且訂閱介面需要經由該連線存取時，再改用透過代理更新。更新失敗不能一概歸咎於用戶端；還要分辨請求逾時、回傳網頁、授權失效與解析失敗。瀏覽器能開啟訂閱管理頁，不代表訂閱介面回傳的內容可供用戶端辨識。

手動新增伺服器時，協定、位址、連接埠、使用者識別碼、傳輸方式與 TLS 設定都應來自同一份連線資料。不要把某個範例的傳輸路徑與另一台伺服器的連接埠拼湊在一起。儲存後，確認所選核心支援這組設定，尤其是包含 REALITY 等功能的設定。更新訂閱後，伺服器記錄可能會重建；暫時修改時，建議先複製到獨立分組，避免下次更新覆蓋本機修正。

系統代理、TUN 與退出後的網路還原

確認核心已啟動後，將「系統代理」設為「自動設定系統代理」。這通常會將 Windows 的代理目標設為用戶端本機監聽位址，但不保證所有程式都會使用該代理。瀏覽器通常會讀取系統代理設定；命令列工具及自行實作網路堆疊的軟體，則可能需要個別設定。若應用程式要求輸入 SOCKS 位址，請使用實際的 SOCKS 監聽連接埠；不要因為連接埠號碼相近，就混淆 HTTP 與 SOCKS 類型。

若需接管不讀取系統代理的程式，再考慮「啟用 TUN 模式」。是否可用取決於所選版本、相應的後端與權限設定；勾選選項不代表所有核心都能自動取得相同功能。依介面提示安裝或啟動必要服務，並查看虛擬網卡、路由與 DNS 是否建立成功。第一次測試時保留預設接管設定；企業網路、虛擬機與其他隧道程式可能已有特殊路由，請先記錄現況，再逐項檢查衝突。

Windows 常見的假故障是代理設定殘留。退出用戶端前，先選擇「清除系統代理」，再正常結束系統匣中的程序；若先前異常終止，請前往「設定 → 網路和網際網路 → 代理伺服器」，確認手動代理是否仍指向已停止的本機連接埠。關閉 TUN 後也要確認網路已恢復。若瀏覽器正常、某個服務程序卻無法連線，不要直接重裝用戶端：服務帳戶的代理設定可能與目前桌面使用者不同，應在該應用程式中確認。

最後驗收應涵蓋正常啟動、切換伺服器、更新訂閱與退出後還原四個操作。手動使用穩定後，再設定開機啟動；若開機時網路尚未就緒，自動更新失敗不代表訂閱已失效。請等網路連線完成後再手動更新並查看記錄檔。從系統睡眠喚醒後若連線異常，先重新啟動核心，不要刪除設定，並確認是否仍保留睡眠前的網路介面或 DNS 狀態。

macOS 安裝與設定

依晶片選擇安裝檔

開啟 Apple 選單中的「關於這台 Mac」，確認顯示的是晶片名稱還是 Intel 處理器，再前往macOS 下載頁選擇相應的 v2rayN 安裝檔。Apple Silicon 選 arm64，Intel 選 x64，不要依系統外觀或電腦尺寸判斷。下載後開啟磁碟映像檔，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動；長期直接執行映像檔中的副本，容易造成更新、權限與應用程式路徑判斷混亂。

首次開啟若遭系統安全機制阻擋，確認下載來源後，依「系統設定 → 隱私權與安全性」提供的方式授權本次應用程式。不要全面關閉系統安全機制，也不要照抄來源不明的終端機指令。若提示應用程式無法執行，先確認架構與系統需求，再檢查下載是否中斷或安裝是否不完整。權限、架構與設定問題屬於不同層次，應依序排除。

升級前先退出選單列或背景中執行的舊版本，備份設定，再替換「應用程式」資料夾中的程式。若「下載」資料夾、磁碟映像檔與應用程式資料夾中留有多個副本，登入項目可能會啟動舊版本。啟動後若看不到預期的訂閱，先確認目前執行的應用程式位置與使用者帳戶，不要立刻重新匯入所有資料。設定檔通常屬於目前使用者，改用其他帳戶執行不會自動共用同一組設定。

匯入訂閱與系統網路代理

在 v2rayN 中開啟訂閱分組設定，新增名稱清楚的分組，貼上訂閱網址並儲存，再更新訂閱。匯入單一分享連結時，請使用伺服器匯入功能，不要填入訂閱網址欄位。更新清單後選取目前使用的伺服器，並確認協定與核心相容。第一次測試不要同時啟用過濾關鍵字，否則清單空白可能是請求失敗，也可能是過濾條件排除了所有匯入內容。

啟用系統代理後，前往「系統設定 → 網路」，選取目前使用的網路服務，再進入「詳細資訊 → 代理伺服器」確認設定。系統介面的實際層級可能隨版本變動，但檢查對象始終是目前使用中的網路服務。Wi-Fi 與有線網路可能各自儲存代理選項；切換連線方式後，應重新確認代理位址與連接埠，不能因為 Wi-Fi 可用，就假設有線網路也套用了相同設定。

瀏覽器通常會遵循系統代理設定，但擴充功能或瀏覽器內建的代理設定可能會覆寫它。排查時先停用代理類擴充功能，並確認應用程式是否指定了獨立代理。若程式只支援 HTTP 代理，請填入實際的 HTTP 監聽連接埠；若只支援 SOCKS，則填入 SOCKS 連接埠。不要將伺服器的遠端位址直接填進系統代理欄位；系統代理應連到本機用戶端，再由用戶端完成協定交握與路由判斷。

TUN 權限、睡眠與網路切換

TUN 接管仰賴目前版本提供的輔助機制與系統授權，不能照搬 Windows 的服務安裝方式到 macOS。先透過一般代理確認連線，再依 v2rayN 的實際提示準備所需權限。授權提示應與剛才執行的操作相符；若權限遭拒，請回到系統設定確認後，重新啟用相應功能。若介面沒有提供某項接管功能，不要修改無關的核心欄位來強行模擬。

從睡眠喚醒、切換熱點，或從 Wi-Fi 切換至有線網路後，舊連線可能失效。先關閉並重新啟用接管，查看記錄檔是否重新綁定目前網路；必要時重新啟動核心。若只有網域存取異常，但現有連線仍可使用，應優先檢查 DNS 與網路服務切換，不要立刻更換伺服器。企業網路中的自動代理設定也可能重新寫入系統選項，請配合網路管理要求，避免兩種機制持續互相覆寫。

正常退出前先關閉 TUN，並清除用戶端設定的系統代理。異常退出後若所有瀏覽器請求都失敗，請到目前網路服務的代理設定頁，確認是否仍啟用指向迴路位址的代理。只停止核心不代表所有網路服務都會自動還原預設狀態。不要任意刪除系統網路服務來清除殘留代理；先撤銷明確由用戶端新增的設定，保留原有 DNS、自動設定網址與網路驗證資訊。

排查安裝路徑或權限時，也要區分主應用程式與輔助程序。活動監視器中仍有程序執行，不一定代表主介面尚未退出；反之，介面顯示正常也不代表必要的輔助元件已運作。應以記錄檔中的監聽成功、路由建立與請求處理結果為準。最後分別驗證一般代理、所需的 TUN 接管及退出後恢復直連，再決定是否加入登入時啟動，避免將尚未完成授權的狀態固定在每次登入時執行。

Linux 安裝與設定

選擇相符的發行版與套件架構

桌面環境建議優先使用 v2rayN。前往Linux 下載頁後，依發行版的套件系統選擇 deb 或 rpm，再確認處理器架構是 x64 還是 arm64。套件格式只代表相容於該安裝工具，不表示所有桌面環境的系統代理行為都相同。安裝前先查看發行版資訊，並使用圖形化套件安裝程式開啟檔案；若出現相依套件提示，優先透過發行版的套件管理工具處理，不要將來源不明的指令碼當成通用安裝步驟。

安裝完成後，從應用程式選單啟動，不要預設以超級使用者身分執行整個圖形用戶端。高權限程序可能會將設定寫入另一個使用者目錄，導致一般身分啟動時訂閱消失或目錄無法寫入。若之前曾以此方式執行，先退出程式，確認實際設定位置與檔案擁有者，再依發行版的管理方式修正。不要為了讓單次啟動成功，就將設定目錄改為所有使用者皆可寫入，以免增加本機資料外洩風險。

圖形介面無法開啟時，先分辨是桌面工作階段問題還是核心問題。缺少顯示環境、圖形相依套件或工作階段變數時，主視窗可能無法建立；此時尚未進入伺服器連線階段。若主視窗能開啟，但記錄檔指出核心缺失，則應檢查安裝是否完整，以及安全性政策是否阻擋執行。容器、遠端工作階段與精簡桌面環境可能沒有完整的系統代理整合；本手冊的圖形操作步驟不能取代這些環境所需的專門部署規劃。

分開設定訂閱與應用程式代理

在訂閱分組設定中新增網址，儲存後更新訂閱，再選取目前使用的伺服器。若訂閱網址包含特殊字元，請完整貼上，不要手動刪除查詢參數；換行、前後空格或複製到的網頁標記都可能造成解析失敗。第一次更新未成功時，先檢查網路驗證與介面回應，不要先調整系統路由。已有可用連線後再嘗試透過代理更新，可避免更新作業依賴尚未建立的代理通道。

GNOME、KDE 與其他桌面環境各有系統代理設定介面，應用程式讀取設定的來源也可能不同。v2rayN 完成系統代理操作後，仍應開啟桌面網路設定確認，並在實際應用程式中驗證。瀏覽器會讀取系統設定，不代表套件管理工具或終端機工具也會讀取。需要獨立設定的程式，請在其網路選項中指定本機代理類型、位址與連接埠；「全域模式」不代表作業系統已強制接管所有程序。

終端機環境中的代理變數也有作用範圍：只在特定終端機工作階段設定，不會自動影響從應用程式選單啟動的程式；寫入登入環境後，也不一定會立即影響已執行中的程序。初次設定不建議同時寫入多個啟動檔案。先在目標應用程式中確認代理可用，再決定是否永久保存；撤銷設定時也要清理相同來源，避免用戶端退出後，舊變數仍指向已停止監聽的本機連接埠。

檢查權限、連接埠與 DNS

需要使用 TUN 時，依目前版本的權限指引設定輔助服務或必要功能。不同發行版的服務管理方式與安全政策不同，不應直接套用其他平台的指令。重點檢查虛擬介面是否建立、路由是否指向預期介面，以及 DNS 請求是否進入預期的處理流程。若桌面網路管理工具與用戶端都嘗試修改 DNS，可能造成連線成功但網域解析時好時壞；先退回一般代理確認基本連線，再逐項恢復接管設定。

可使用系統工具查看本機連接埠是否被占用。以下兩個指令只會檢查監聽狀態，不會變更網路設定；連接埠號碼應替換為目前介面中實際設定的值。看到監聽項目仍不能證明它屬於這次啟動的核心，需搭配程序資訊與用戶端記錄檔判斷。若未顯示程序名稱，可能是權限不足；不要因程序欄位空白，就認定連接埠沒有被占用。

ss -lntp 'sport = :10808'
ss -lntp 'sport = :10809'

若訂閱能更新但應用程式無法連線，優先檢查應用程式使用的代理來源與協定類型；若一般代理正常但 TUN 失敗，優先檢查權限、路由與 DNS；若核心根本沒有監聽，再回頭檢查安裝、設定語法與檔案存取權限。依這個順序排查，比反覆切換發行版設定更容易保留現場。遇到安全政策拒絕執行或存取時，請查看系統記錄中的具體拒絕項目，不要直接停用整套安全政策。

退出時的測試同樣重要：先關閉 TUN、清除系統代理，再退出用戶端，確認桌面網路設定與個別應用程式設定是否已還原。筆記型電腦切換網路、從睡眠喚醒或接上有線網卡後，都應重新確認目前使用的介面。開機啟動與使用者登入啟動的執行環境不同；圖形用戶端通常應在使用者工作階段可用後啟動。在建立可用的基準設定前，不要另外設定背景自動啟動或重複的服務執行個體，以免發生連接埠衝突或設定目錄分流。

Android 安裝與設定

選擇 v2rayNG 或 v2flyNG

前往Android 下載頁，建議優先選擇 v2rayNG；需要 V2Fly 核心環境時再選 v2flyNG。兩者是不同的應用程式，安裝其中一款不代表能在另一款中切換核心。多數較新的裝置適用 arm64 版本；無法確認架構時，請使用通用版。安裝前先確認裝置允許目前的瀏覽器或檔案管理工具安裝應用程式，只授權實際負責開啟安裝檔的應用程式；安裝完成後，可依裝置管理習慣關閉該權限。

安裝或升級時若出現套件衝突、無法覆蓋或簽章不一致，先停止重試，確認現有應用程式的身分與安裝來源。不要立刻解除安裝，因為解除安裝可能同時移除伺服器清單與本機設定。先使用目前應用程式的匯出功能儲存必要資料，再判斷是安裝了另一款應用程式、選錯套件，還是舊版無法直接以目前套件覆蓋。裝置儲存空間不足也可能導致安裝失敗，應與架構問題分開排查。

首次啟動時先查看預設設定，不要直接匯入來源不明的完整設定檔。完整設定檔可能包含自訂 DNS、路由與本機監聽位址，會改變應用程式原有的行為。如果手上的連線資料是一般訂閱，請使用訂閱功能；若需手動新增伺服器，應逐項核對協定、傳輸方式與 TLS。v2flyNG 不能視為所有 Xray 功能的替代執行環境，實際支援能力取決於使用的核心，而不是圖示或應用程式名稱。

訂閱設定與連線授權

在 v2rayNG 的選單中開啟「訂閱設定」，新增訂閱名稱與網址，儲存後回到主畫面更新訂閱。不同版本介面中的新增按鈕位置可能不同，但操作順序都是先儲存訂閱項目，再更新伺服器清單。匯入單一連結時使用剪貼簿匯入功能；掃描分享內容則使用對應的掃描功能。不要把 QR Code 中的訂閱網址誤當成一般伺服器，也不要把單一伺服器連結反覆新增為訂閱。

更新後點選一筆伺服器記錄，確認已顯示選取標記，再啟動連線。系統第一次會要求授權建立 VPN 連線；這是 Android 提供的流量接管介面，不代表需要安裝另一款 VPN 應用程式。授權後查看狀態列與應用程式記錄檔，確認服務確實已啟動。若同時執行其他占用該介面的網路工具，系統可能會切換或停止其中一個。排查時先只保留目前的用戶端，避免兩個應用程式輪流爭取接管權限。

v2flyNG 的匯入原則相同：先分清訂閱與單一設定，再檢查選取的記錄及核心相容性。清單中成功出現記錄，不代表目前核心一定能執行其中的傳輸參數。連線失敗時，記下第一則與交握相關的錯誤訊息，不要連續切換設定。若連線資料需要特定 Xray 功能，請先確認服務提供者的參數說明與應用程式選擇，不要刪除安全欄位來換取表面上的啟動成功。

個別應用程式接管、背景執行與 DNS

Android 主要透過應用程式建立 VPN 介面來接管流量，這與桌面平台的「自動設定系統代理」不同，不必照搬桌面版的本機代理開關。若只想讓部分應用程式使用代理，可在用戶端支援的個別應用程式設定中選擇接管或排除範圍。儲存後通常需要重新建立連線。先確認清單採用的是允許清單還是排除清單；相同的勾選項目在兩種模式下可能產生相反結果，測試時先單獨驗證一個目標應用程式。

切換到背景一段時間後若連線中斷，先檢查電池最佳化、背景活動限制與裝置製造商的省電政策。允許必要的背景執行與通知，有助於系統保留連線服務；但不要為了排查而一次放寬所有應用程式權限。若只有鎖定螢幕後失敗，優先確認背景服務是否遭到終止；若切換 Wi-Fi 與行動網路時失敗，則優先重新連線並查看網路變更記錄。這兩種情況不應一概歸因於伺服器不穩定。

系統的「私人 DNS」、用戶端 DNS 設定及瀏覽器的加密 DNS 都可能影響網域解析。遇到網域無法存取時，先還原成一條明確的解析路徑，再逐步加入自訂設定。不要同時在多處啟用特殊 DNS，然後據此判斷路由規則。部分裝置製造商提供的應用程式分身、工作資料夾或獨立空間具有額外隔離機制；請確認目標應用程式與用戶端位於相同使用環境，個別應用程式清單中的身分也必須相符。

停止連線後，檢查通知列狀態與實際網路是否恢復。若系統啟用了「永遠開啟 VPN」或封鎖未經 VPN 的連線，用戶端停止後的網路行為可能與一般退出不同，請到系統網路設定檢查相關選項。使用公共網路時，先依網路要求完成登入，再啟動連線。最後分別測試前景、背景、鎖定螢幕與網路切換四種情境，保留一組穩定設定後再加入個別應用程式規則，避免把背景限制誤判為訂閱或協定錯誤。

路由與流量接管

先釐清兩個不同問題

流量接管決定請求能否進入用戶端；路由分流則決定進入後使用哪個出站。系統代理、應用程式個別代理與 TUN 屬於接管層；網域、IP、連接埠與出站標籤屬於路由層。將路由模式改成全域，無法強制忽略系統代理的應用程式進入用戶端。排查時先查看目標應用程式的請求是否出現在記錄檔中；若沒有請求記錄，應先檢查接管路徑，而不是繼續增加網域規則。

路由規則通常依序比對，命中後選擇出站，因此明確的規則應排在廣泛規則之前。廣告封鎖、區域網路直連、指定網域直連與其餘流量走代理，可以組成清楚的基本策略，但每條規則都應有明確目的。請留意單一規則內不同欄位的組合方式，不要把「網域或 IP 任一命中」的想法隨意寫進同一個規則物件；需要分開判斷時，請用不同規則表達，方便透過記錄檔驗證與後續維護。

geosite 是網域分類規則，geoip 是 IP 分類規則；兩者都依賴相符的資源檔與標籤。標籤名稱不是任意備註，拼錯或資源不存在都可能造成啟動失敗。透過用戶端的路由編輯器選取內建規則，通常較能確保資源路徑一致。複製設定片段前，先確認本機是否有對應資源，以及用戶端是否會在啟動時重新產生設定，覆寫手動修改的內容。

本機入站與欄位說明

以下是用來說明本機入站的完整 V2Ray 設定，提供迴路位址上的 SOCKS 與 HTTP 入口，預設出站為直連。這份設定可協助理解監聽與路由架構，但不包含遠端代理伺服器，不能取代訂閱。用戶端通常會自行產生執行設定，不應直接用此範例覆蓋目前使用的設定目錄。若要測試，請使用獨立設定環境，並確認範例連接埠未被目前的執行個體占用。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    },
    {
      "tag": "http-in",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

listen 決定監聽介面，port 決定本機連接埠，tag 用來命名入站或出站。規則中的 outboundTag 必須指向已存在的出站標籤；填入不存在的名稱，不會自動建立代理出站。上述設定在沒有命中規則時會使用第一個出站，也就是直連。用戶端介面中的「最終規則」通常會轉換成具體設定，不能將介面文字直接當成核心 JSON 欄位照抄。

domainStrategy 控制路由階段如何處理網域與 IP 比對。AsIs 保留網域進行判斷；IPIfNonMatch 會在網域規則未命中時嘗試解析，再比對 IP 規則；IPOnDemand 則會在需要比對 IP 時進行解析。這不是獨立的遠端 DNS 開關，也不保證所有網域都使用相同的解析路徑，仍須搭配 DNS 設定、出站行為與用戶端實作方式理解。

用最少規則驗證結果

新增規則時，先選一個可重複測試的目標，記錄預期出站，再查看記錄檔中的實際選擇。網域規則通常只填主機名稱，不填完整網頁路徑；也要區分子網域、精確比對與後綴比對。應用程式使用 IP 直連、加密 DNS 或連線重用時，記錄檔未必會保留預期的網域資訊。此時應檢查實際請求內容，不要不斷加入相似網域，形成重複又難以說明的規則集合。

系統代理適合遵循系統設定的應用程式；TUN 則適合需要更廣泛接管流量的情境，但 TUN 不會自動決定分流策略。啟用後仍需避免核心自身的出站流量再次進入隧道，並正確處理 DNS 與區域網路目標。初次使用時保留用戶端預設的防迴圈機制，不要任意修改介面綁定與排除路由。區域網路列印、檔案共享或虛擬機通訊異常時，先確認私有位址的流量路徑，再考慮是否需要新增精確的直連規則。

路由規則維護應與訂閱維護分開。更新訂閱可能會重建伺服器記錄，但不能當成修復任意路由錯誤的方法；更新路由資源也不等於更新伺服器參數。每次修改時保留舊規則，測試目標服務與區域網路服務，再確認退出後能否恢復。遇到核心功能相容性問題時，請參閱Xray 與 V2Fly 核心差異，確認欄位是否受支援，避免在不相容的核心上反覆刪改參數碰運氣。

常見設定問題

依故障階段查看記錄檔

先記下「哪個操作失敗」，再記下「出現什麼錯誤」。啟動失敗、更新訂閱失敗、單一應用程式無法連線，以及從睡眠喚醒後斷線，應分開處理。開啟記錄檔視窗，清除或標記舊記錄，再只重現一次問題，找出最先出現的錯誤及其前後文。最後一行「啟動失敗」往往只是總結，真正原因可能出現在前面。需要更詳細的分類，請參閱核心啟動失敗記錄檔診斷。

記錄檔出現 address already in use 之類的訊息時，優先確認本機連接埠被哪個程序占用。先退出舊用戶端與背景執行個體，再確認監聽是否已釋放；若確實要更換連接埠，系統代理與應用程式個別代理也必須同步修改。若是設定解析錯誤，請檢查 JSON 的逗號、括號、欄位類型，以及核心是否認得該欄位。JSON 語法正確不代表目前核心支援所有欄位，也不代表所引用的檔案與標籤都存在。

若記錄檔指出資源檔不存在，請檢查規則檔案路徑、安裝完整性與存取權限，不要直接刪除所有路由。若指出協定未知或不支援傳輸方式，請核對目前使用的核心與連線資料。切換核心前，先停用依賴特定功能的設定，再確認新核心支援相同協定。不要只以「能啟動」為目標；移除 TLS、驗證或認證欄位可能改變連線意義，表面錯誤消失不代表設定正確。

訂閱清單空白、連線逾時與憑證錯誤

更新訂閱後清單空白時，依序檢查目前選取的分組、過濾關鍵字、介面回應與訂閱授權狀態。成功回傳網頁或空白內容，不代表成功取得伺服器資料。暫時清空過濾條件，再單獨更新一個分組，可判斷是取得資料失敗，還是顯示條件造成。管理多個來源時應使用明確分組，詳細作法請參閱訂閱分組與伺服器篩選；不要以重複匯入掩蓋分組關係不清的問題。

連線逾時代表某個階段未能在預期時間內完成，但不能只憑這幾個字就判定伺服器失效。先確認本機連接埠是否存在，再查看遠端位址能否解析，以及實際連線停在建立連線還是協定交握階段。遇到 connection refused 時，應核對目標位址、連接埠與服務狀態；若目標是迴路位址，也要確認本機核心已啟動。更換伺服器可作為對照測試，但應保留原始錯誤與設定，避免失去比較依據。

遇到 TLS 憑證錯誤時，先檢查系統時間、伺服器名稱與連線資料中的安全設定。憑證對應的名稱可能與連線位址不同，但這種差異必須來自服務提供者的明確設定，不能自行猜測。不要把略過憑證驗證當成通用修復方式；若訂閱資料已過期，應更新資料或聯絡服務提供者確認。網路驗證頁面、企業代理或安全軟體介入，也可能改變憑證鏈，應一併考量目前的網路環境。

建立故障對照與還原順序

瀏覽器可用但其他應用程式無法連線時，先比較代理來源：瀏覽器是否安裝擴充功能、目標應用程式是否讀取系統代理，以及協定類型與連接埠是否一致。一般代理可用但 TUN 不可用時，優先檢查權限、虛擬介面、路由與 DNS。若網域連線失敗但 IP 連線成功，可懷疑解析路徑；不過直接連線 IP 可能因 TLS 名稱或伺服器虛擬主機限制而失敗，因此這只能作為線索，不能單憑一次測試排除其他原因。

只有特定網站無法使用、其他服務正常時，請檢查該請求的出站、網域規則與應用程式快取。修改路由後，舊連線可能仍沿用原本通道，應重新建立目標連線再測試。必要時可暫時改用最精簡的規則組進行對照，但先備份原始設定。若精簡規則可用，再逐條恢復自訂規則；若仍無法使用，則回頭檢查遠端參數與應用程式的流量接管方式。沒有請求記錄時，不要繼續修改網域分類，這通常是在錯誤的層級排查。

遇到網路切換或背景執行問題時，記錄觸發條件比只寫「偶爾失敗」更有用。請明確記下問題是在鎖定螢幕、系統睡眠、切換 Wi-Fi、啟動另一個隧道程式，還是更新訂閱後發生，再查看相應記錄。Android 應優先確認服務是否遭系統停止；桌面平台則應檢查目前網路介面與殘留代理。重新啟動可以暫時清除狀態，但若每次都在相同操作後重現，就應針對該操作建立對照，而不是把重新啟動當成長期維護方式。

回報問題時，請提供作業系統、用戶端名稱、所選核心、觸發步驟、完整錯誤訊息及已完成的對照測試，不必附上完整訂閱或帳戶資料。分享記錄檔前，先確認是否包含伺服器位址、查詢參數或驗證資訊，並移除敏感內容。若只想重新完成基本連線設定，請返回快速入門教學；若要更換平台安裝檔，請返回用戶端下載頁。保留可還原的基準設定，比反覆刪除所有設定更容易找出並解決問題。