相容性

支援的硬體

Vonode 節點能在哪些主機上執行、能使用哪些行動網路模組。每一項都註明依據:已在實際硬體上測試,或程式碼已支援但尚未測試。

已實測Vonode 團隊已在實際硬體上驗證。每個型號分別標出測試過的功能。
相容同一模組系列或已列入節點的型號表,或只試過單項功能;尚未在硬體上完整測試。
規劃中暫不支援,預計在後續版本提供。
不支援已知無法使用,或不在節點的設計範圍內。

主機

節點在一台長時間開機的 Linux 電腦上執行。依處理器架構列出需求:

amd64

64 位元 x86(x86-64)

已支援
作業系統
Debian 12、Ubuntu 22.04 以上版本,或 Fedora,需使用 systemd(安裝套件的需求)
安裝方式
systemd 安裝套件(本版本建議);Docker Compose 即將推出
系統套件
完整的 iproute2(ip -V 輸出 iproute2)、核心驅動程式 option 和 qmi_wwan;Wi-Fi 通話需要 /dev/net/tun
模組存取
root 權限;已停用並禁止啟動 ModemManager
網路
手機能透過連接埠轉送或 VPN 連到 TCP 2222 連接埠(預設)
硬體範例
Intel N100 迷你電腦、二手精簡型電腦或 NUC;節點本身只需 2 GB 記憶體和 4 GB 磁碟
驗證平台
Ubuntu 22.04,amd64

不支援:macOS 或 Windows 上的 Docker Desktop,以及沒有 USB 直通的虛擬機器。

arm64

64 位元 ARM(aarch64)

規劃中(1.3.1)
作業系統
待確認
安裝方式
使用多架構映像檔的 Docker Compose(預計在 1.3.1 提供)
系統套件
待確認
模組存取
待確認
網路
待確認
硬體範例
Raspberry Pi 4 和 5、RK3588 開發板(待確認)
驗證平台
尚未測試

目前的安裝套件在非 x86-64 主機上會直接停止。arm64 主機和多架構 Docker 映像檔預計在節點軟體 1.3.1 提供,屆時會更新這一欄。

行動網路模組

節點透過 USB,用模組的序列埠(AT)和 QMI 介面驅動採用高通平台的模組。一個節點最多連接五個模組。

測試過的功能(DJI Cellular 模組):經行動網路和 Wi-Fi 通話收發簡訊;Wi-Fi 通話註冊、雙向有聲的來電和撥出、通話保留與恢復;eSIM 設定檔切換;行動數據連線。行動網路通話目前在所有模組上都尚未確認。
模組狀態驗證平台 簡訊行動網路通話Wi-Fi 通話 eSIM行動數據說明
DJI Cellular 模組內建 Quectel EG25-G · 需先切換一次 USB 識別 已實測amd64 · Ubuntu 22.04已實測不支援已實測部分實測已實測 已測試兩台。簡訊:經行動網路接收,經 Wi-Fi 通話收發。行動網路通話:不支援;通話可經 Wi-Fi 通話進行。eSIM:在可插拔 eUICC 卡上切換設定檔;下載設定檔尚未測試。詳見下方「使用 DJI Cellular 模組」。
Quectel EG25-GUSB 2c7c:0125 相容未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 與已測試的 DJI 模組內部是同一款模組,但尚未單獨測試。
Quectel EC25EC25-E、-AF、-AU、-J 等地區版本 相容未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 與 EG25-G 屬於同一 USB ID 系列。請購買適合你所在國家或地區頻段的版本。
Quectel EC20USB 2c7c:0125 系列 相容amd64 · Ubuntu 22.04程式碼支援,未測試部分實測程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 曾用一個模組試過行動網路通話:USB 音訊可以開啟,但尚未確認雙向有聲的通話。其他功能未測試。
Quectel EC21 和 EG21LTE Cat 1 相容未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 已列入節點的型號表。
Quectel EM05、EM06 和 EG06M.2 和 Mini PCIe LTE 相容未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 已列入節點的型號表。需要具備 USB 和 SIM 卡槽的轉接板。
Quectel RM500Q5G · M.2 相容未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試程式碼支援,未測試 5G 下的表現尚未確認。需要具備 SIM 卡槽的 M.2 轉 USB 3 轉接板。

使用 DJI Cellular 模組

DJI Cellular 模組內建 Quectel EG25-G。出廠時它回報的是 DJI 的 USB ID(2ca3:4006),Linux 標準驅動程式無法辨識。把它的 USB 識別切換成 Quectel 一次後,節點就會把它當作 EG25-G 使用。我們硬體測試用的模組,就是這樣切換過的 DJI Cellular 模組。

2ca3:4006 → AT+QCFG="usbcfg" → 2c7c:0125 USB ID 2ca3:4006 USB ID 2c7c:0125 AT+QCFG="usbcfg" AT+CFUN=1,1
示意圖:這次切換只改變模組回報的 USB ID。

傳送任何指令之前,請先閱讀

  • 這些指令只修改模組的 USB 識別,不修改 IMEI、韌體,也不修改任何射頻參數。
  • 修改後,在恢復原識別之前,模組可能無法在 DJI 裝置上使用;也可能影響保固。風險由你自行承擔。
  • 切勿修改模組的 IMEI。在許多國家,這是違法行為。
  1. 讓 AT 埠出現

    把模組插到 Linux 主機上。DJI 模式下標準序列埠驅動程式不會自動綁定,所以先載入驅動程式,並在本次工作階段中加入 DJI 的 ID。之後模組會出現幾個 ttyUSB 連接埠。

    $ sudo modprobe option
    $ echo 2ca3 4006 | sudo tee /sys/bus/usb-serial/drivers/option1/new_id
    $ ls /dev/ttyUSB*
  2. 開啟 AT 埠

    AT 埠通常是 /dev/ttyUSB2,但編號以你的系統為準:輸入 AT 後回覆 OK 的那個連接埠就是 AT 埠。可以使用 picocom、minicom 或 screen 等任何序列埠終端機(picocom 按 Ctrl-A 再按 Ctrl-X 離開)。

    $ sudo picocom -b 115200 /dev/ttyUSB2
    AT
  3. 切換為 Quectel 識別

    在序列埠終端機中輸入這兩道指令。第二道會重新啟動模組;新的識別在斷電後仍會保留。

    AT+QCFG="usbcfg",0x2C7C,0x0125,1,1,1,1,1,0,0
    AT+CFUN=1,1
  4. 檢查結果

    重新啟動完成後,lsusb 應顯示 2c7c:0125(Quectel)。此時節點的安裝指令碼就能偵測到這個模組。

    $ lsusb | grep -i -E '2c7c|2ca3'

恢復 DJI 原識別

如果要把模組重新用在 DJI 裝置上,用同樣的方法開啟 AT 埠並傳送這兩道指令。之後 lsusb 會重新顯示 2ca3:4006。

AT+QCFG="usbcfg",0x2CA3,0x4006,1,1,1,1,1,0,0
AT+CFUN=1,1

指令改編自 wlzh/dji-4g-vohive-mac, 授權條款為 CC BY 4.0. 改動:改寫為互動式序列埠終端機的操作步驟,並加入驅動程式綁定、尋找 AT 埠和 lsusb 檢查。

DJI 是 SZ DJI Technology Co., Ltd. 的商標;Quectel 是 Quectel Wireless Solutions Co., Ltd. 的商標;Vonode 與 DJI 及 Quectel 無關聯,也未獲得其認可。

SIM 卡與電信業者

  • 請先在手機上關閉 SIM 卡的 PIN 碼。實體 SIM 卡插上即可使用。
  • 模組沒有內建 eSIM。要使用 eSIM 設定檔,請在模組的 SIM 卡槽插入一張可插拔 eUICC 卡(俗稱「eSIM 卡」)。
  • Wi-Fi 通話需要電信業者在你的資費方案中開通,和手機上一樣。模組必須至少用這張 SIM 卡在行動網路上註冊過一次。
  • Vonode 無法保證某家電信業者或資費方案一定可用。能否使用取決於電信業者的網路和資費方案。

不支援

  • 只提供網路卡功能的 USB 網卡(HiLink、僅 RNDIS 或僅 ECM 韌體)。節點需要模組的序列埠和 QMI 介面。
  • 非高通晶片平台的模組,包括上表未列出的 Quectel 系列。
  • 其他廠商的模組尚未測試。部分功能使用 Quectel 專用的 AT 指令。
  • OpenWrt 路由器、macOS 或 Windows 上的 Docker Desktop,以及沒有 USB 直通的虛擬機器。
  • 本版本暫不支援 ARM 主機:預計在 1.3.1 提供,見上方 arm64 一欄。
最後更新:2026 年 10 月 8 日。你的模組不在清單中?請寄信至 support@vonode.cc.