OpenWrt 旁路由安裝 Xray 核心:透明代理設定與注意事項

先讓主路由維持撥號與 DHCP,旁路由只接管一台測試裝置的流量。確認連線確實經過旁路由後,再檢查透明入站、DNS 與轉送規則。

本文重點

如果 OpenWrt 和主路由目前運作正常,想將代理從終端裝置移到網路入口,可先依本文測試核心與單機閘道,再確認透明代理的接管範圍。文中分別說明設定檔、程序監聽與防火牆三個層面,方便排查重開機後設定失效、網頁持續轉圈或裝置記憶體不足等問題。

主路由與旁路由:先確認由誰派發 IP 位址

位於同一網段的旁路由,不會自動收到所有裝置的網路流量。主路由繼續負責連網、派發 IP 位址和出口 NAT;測試裝置將旁路由設為 IPv4 預設閘道後,前往其他網段的流量才會先經過旁路由。同一網段內連線至印表機、管理頁面等服務時,通常仍由終端裝置直接連線,不會經過預設閘道。

192.168.1.1
範例:主路由 IP 位址
192.168.1.2
範例:旁路由 IP 位址
12345
範例:本機透明入站連接埠

先測試單一裝置,再調整派發範圍

只在一台裝置上變更預設閘道,並記下如何恢復為自動取得設定。只要這台裝置無法同時連上主路由管理頁面和外部網站,就先不要修改主路由派發的閘道設定。

以上範例使用 192.168.1.0/24。旁路由的靜態 IP 位址應避開主路由的動態派發範圍,或在主路由上保留該位址,以免其他裝置取得相同 IP。若 OpenWrt 本身就是主路由,則不需要再設定第二個閘道;仍可先從單一終端裝置的來源 IP 開始測試,避免影響整個網路。

Xray 與 V2Fly:依出站設定選擇核心

路由器上執行的是核心程序,不是桌面用戶端。請先確認現有伺服器實際使用的通訊協定、傳輸方式與安全設定,再查看韌體套件來源是否提供符合裝置架構的核心套件。兩種核心使用的欄位和指令不一定通用,請勿直接將桌面用戶端匯出的整份設定檔覆蓋到路由器上。

Xray

建議使用

現有出站設定使用 VLESS 與 REALITY 時,請依伺服器參數選擇支援相應傳輸方式的 Xray 版本,再測試監聽與出站連線。

適用情境:已有相應伺服器參數,並需要在 OpenWrt 上接管指定終端裝置

V2Fly

若目前維護的是以 V2Fly 為基礎的 VMess 設定,可沿用熟悉的核心,但仍須使用已安裝的版本檢查 JSON 欄位與路由資源路徑。

適用情境:現有 VMess 出站已通過測試,且希望沿用同一套設定

從設定檔到單機測試

  1. 設定固定的旁路由 IP

    在旁路由 LuCI 中開啟「網路」→「介面」→「LAN」→「編輯」→「一般設定」,檢查靜態 IP、網路遮罩和 IPv4 閘道。依範例將旁路由設為 192.168.1.2/24,並將閘道設為 192.168.1.1。儲存後,使用新 IP 位址重新開啟管理頁面。

  2. 檢查 IP 位址派發

    在同一個編輯頁面切換至「DHCP 伺服器」,確認旁路由的 LAN 介面不會派發 IPv4 位址,並由主路由統一派發。另外,請在用戶端確認實際取得的 IPv6 預設路由:停用 DHCPv4 不會一併停用 IPv6 路由公告。

  3. 確認設定檔位置

    如果安裝套件提供 /etc/init.d/xray,請先查看啟動指令碼啟動核心時使用的設定參數。手動部署可使用 /etc/xray/config.json,但必須明確指定服務讀取此檔案;若指令碼是從 UCI 或設定目錄產生檔案,請修改來源設定,而非修改重新啟動後就會被覆寫的暫存檔。

  4. 先測試出站連線

    支援此指令的 Xray 版本可使用 xray run -test -config /etc/xray/config.json 測試設定;請將路徑換成實際檔案位置,並以本機的 xray help run 說明為準。測試通過只代表設定檔可以載入。若要分開測試出站與透明轉送,可暫時在路由器的回送位址上開啟明確指定的代理入站,從路由器本機送出要求以測試出站;測試完成後請移除該入站設定。

  5. 讓單一終端裝置經過旁路由

    在測試終端裝置的 IPv4 網路設定中,將預設閘道改為旁路由 IP 位址,並保留同網段內不衝突的 IP 位址和正確的網路遮罩。透明接管範圍先限定為該終端裝置的來源 IP;規則尚未就緒前,不要修改主路由的 DHCP 閘道選項,也不要將測試連接埠開放至 WAN。

透明轉送:監聽、流量接管與策略路由

Xray 開始監聽,只代表本機有程序等待流量。以 TPROXY 為例,還需要防火牆在轉送路徑上比對指定流量,並透過封包標記搭配策略路由,將流量送至本機的透明入站。OpenWrt 自 22.03 起預設使用以 nftables 為基礎的 fw4;自訂韌體可能不同,請先確認目前使用的防火牆後端,再選擇相應的規則語法。不要把舊版 iptables 教學的規則整段套用到正在運作的 fw4 規則集中。

檢查項目確認內容
透明入站透明入站的監聽連接埠須與規則一致;啟用保留原始目的地的接收方式,且只比對該入站實際支援的 TCP 或 UDP 流量。
標記與路由防火牆標記、ip rule 的標記比對和獨立路由表必須一致;該路由表需要設定本機投遞路由,不能將已標記的流量再次送往主路由。
直連與例外不得接管回送、本機管理及其他預計保留直連的目的地;若規則也會比對本機流量,請排除核心本身的出站流量,以免形成迴圈。
DNS 與 IPv6分別檢查終端裝置使用的 DNS 伺服器和 IPv6 預設路由。只修改 IPv4 閘道,不會改變終端裝置可能從主路由取得的 IPv6 路徑。

排查時先建立一個新連線,再檢查對應規則。若規則設有計數器但數值沒有變化,請優先確認終端裝置的閘道、進入介面和來源 IP;若規則有命中但核心沒有收到要求,再檢查標記是否被其他規則覆寫、策略路由是否已載入,以及對應的通訊協定是否正在監聽。

設定持續儲存與資源檢查

寫入設定後,先確認啟動指令碼使用相同的檔案路徑,再到 LuCI 的「系統」→「啟動項」確認服務已啟用;前提是安裝套件確實有註冊服務。手動修改防火牆的暫時規則可能在重新載入後消失,應透過現有的 fw4 持續儲存機制管理,並在重新載入後再次檢查。若使用網域與 IP 位址規則資料庫,也要確認設定所引用的資源檔案可讀取,且位於核心實際搜尋的目錄中。

df -h /overlay /tmp
free -m
logread -e xray
ip rule show

常見問題:從終端裝置檢查旁路由

旁路由可以上網,為什麼電腦的流量沒有經過它?

在電腦上查看預設路由,確認 IPv4 下一個躍點是旁路由而非主路由;再確認瀏覽器沒有沿用個別設定的代理。測試時請建立新連線,並在 OpenWrt 上確認是否有比對到該電腦來源 IP 的規則;不要以旁路由本機的連線結果代替終端裝置測試。

有些網頁能開啟,有些卻一直轉圈?

先檢查終端裝置取得的 DNS 位址,以及 A、AAAA 查詢結果,再分別使用 IPv4 和 IPv6 測試同一個雙堆疊網站。若兩種 IP 通訊協定的結果不同,請檢查 IPv6 流量是否繞過旁路由;若問題只在使用 UDP 的應用程式中重現,再檢查 UDP 接管和出站支援情況,不要一開始就修改所有網域規則。

手動啟動時正常,重新開機後卻連不上?

先到「系統」→「啟動項」確認相關服務已啟用,再比對啟動指令碼和手動指令使用的設定檔路徑。若連接埠正在監聽,但要求沒有進入核心,請檢查透明代理規則和 ip rule show 是否都已恢復;在終端裝置上暫時新增的規則和策略路由不會自動保留。

變更閘道後,家裡的印表機找不到了?

先讓終端裝置恢復自動取得設定,確認是否能重新找到印表機並列印。若終端裝置和印表機位於同一網段,請確認手動填寫的網路遮罩是否正確;若兩者位於不同網段,再檢查新閘道的路由、防火牆區域和服務探索協定的涵蓋範圍,不要靠接管更多流量來解決問題。

下載v2rayN查看平台與安裝套件