Open-Box
繁

使用文件

安裝、升級和專業版

路由器端的安裝、升級、回退、解除安裝，以及專業版的試用、啟用和換路由器。

安裝

SSH 以 root 登入 OpenWrt 路由器後執行：

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/install.sh | sh

GitHub 存取不暢時，需要先透過可存取的 raw 鏡像獲取安裝腳本，再讓腳本使用鏡像下載發布包：

curl -fsSL https://gh-proxy.com/raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/install.sh | sh -s -- --mirror

--mirror 只控制安裝包下載；如果最外層的 raw.githubusercontent.com 本身無法存取，直接在原網址後追加 --mirror 仍然無法取得腳本。

安裝過程中會問一次面板連接埠（預設 3036，直接按 Enter 即可）。連接埠會先檢查是否可用——被別的程式占用、或與 Open-Box 自己和系統的連接埠衝突時，會說明原因並讓你重填。也可以用 --port 直接指定，例如在上面的命令末尾加 --port 3080。裝完之後還能改，見修改面板連接埠。

安裝要求：OpenWrt、x86_64 或 aarch64、至少 512MB 儲存空間和 512MB 記憶體。安裝 / 升級腳本會檢查並嘗試用 opkg 或 apk 補齊系統依賴（kmod-tun、kmod-nft-queue、kmod-nft-nat、kmod-veth、ip-full、ca-bundle）；軟體源不通時只提示、不中斷，可稍後按提示手動安裝，設 OPENBOX_SKIP_DEPS=1 可跳過這一步。安裝完成後，用瀏覽器開啟腳本提示的 http://<路由器區域網路 IP>:<面板連接埠> 網址，首次存取設定管理密碼。

安裝完成後，用瀏覽器開啟 http://<路由器 LAN 地址>:<面板連接埠>（安裝腳本結束時會印出這個網址），首次開啟時設定面板密碼。以後忘了密碼不用重新安裝，見下面的忘記面板密碼。

Debian / Ubuntu

同樣的安裝、升級、解除安裝命令也適用於 Debian / Ubuntu（需要 systemd；在 Ubuntu 24.04 上驗證過），以 root 或 sudo 執行即可。腳本會識別系統：服務交給 systemd（openbox.service 核心、openbox-panel.service 面板），命令列 open-box 放在 /usr/local/bin，隨包的 Node 是 OpenWrt 用的 musl 版，安裝時會從 nodejs.org（不通時換 npmmirror）下載同版本的官方 glibc 版替換，所以安裝機器要能存取其中之一。依賴用 apt 補齊（nftables、xz-utils、iproute2、ca-certificates），tun / nftables 核心模組隨發行版核心自帶。

和 OpenWrt 的差別：

  • 沒有 LuCI 頁面，也沒有 dnsmasq 分流模式——DNS 只有「防火牆劫持」和「關閉」兩種；本機用 systemd-resolved 的話它的上游查詢同樣會被核心接管，不需要改 resolved 的設定。
  • 防火牆由你自己管理：腳本不會寫任何放行規則。裝了 ufw / firewalld 之類的話，要自己放行面板連接埠，以及（作為旁路由時）區域網路到本機的轉發。
  • 核心啟動時會開啟 IP 轉發（net.ipv4.ip_forward=1，原來關著的話停止時關回去），這樣區域網路終端把閘道 / DNS 指向這台機器就能走它分流；只給本機用的話不用管。
  • 排障看 journalctl -u openbox -u openbox-panel；緊急恢復直連 systemctl stop openbox。

修改面板連接埠

新裝的預設連接埠是 3036；v0.1.216 及更早裝的機器升級後連接埠不變（還是 2026），不會被新預設值挪走。

兩種改法，效果一樣：

  • LuCI 頁面：路由器管理介面 → 服務 → Open-Box，「Open-Box 面板」那張卡片的按鈕排末尾點「修改連接埠」。填新連接埠儲存即可；有衝突不會儲存並告訴你原因，面板正在執行的話會自動重啟一次。
  • SSH：open-box port 看目前連接埠，open-box port 3080 改成 3080。

改完記得用新網址存取面板。

忘記面板密碼

面板密碼儲存在路由器上，能以 root 登上路由器就能查到，不需要重新安裝，也不會丟失訂閱和規則。兩個地方可以看：

1. LuCI 頁面：路由器管理介面 → 服務 → Open-Box，頁面頂部「完整管理請到 Open-Box 面板：」那一行，面板網址後面直接顯示 密碼: xxxx。剛升級完看不到的話，退出 LuCI 重新登入一次。

2. SSH 命令：SSH 登上路由器後執行 open-box，選 1：

root@OpenWrt:~# open-box

Open-Box v0.1.216
  1) 目前密碼
  2) 重新啟動
  3) 檢查升級
  4) 解除安裝
  5) 退出
請選擇 [1-5]: 1

  面板網址: http://192.168.1.1:3036
  目前密碼: ********

只想要密碼本身可以直接執行 open-box password；open-box check 檢查有沒有新版本，open-box update 直接升級，open-box restart 重啟核心和面板，open-box uninstall 解除安裝。

以上兩個入口從 v0.1.210 開始提供。更早的版本先透過 SSH 執行下面「升級」一節的命令升到最新版（升級會保留密碼、訂閱和規則），升級完成後 open-box 命令就可以用了。

查到密碼後想換一個：登入面板，在「設定」頁點「修改密碼」。

升級

面板中可以從「設定 → 後端設定」檢查更新，也可以透過 SSH 執行（OpenWrt 與 Debian / Ubuntu 同一條命令）：

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh

升級會保留訂閱、規則和面板密碼，並校驗 Open-Box、sing-box、GeoSite / GeoIP 元件。相同且完整的元件直接複用，只有變化、缺失或損壞的元件才會從本倉庫 Release 下載。

回退到上一個版本

如果升級後面板或核心異常,可以用下面的命令回退:腳本會到 GitHub 查目前版本之前最近的正式 Release,重新下載那一版的完整安裝包裝回去。路由器本機不保留舊版備份,所以回退需要能存取 GitHub(或鏡像);訂閱、規則、面板密碼等資料目錄不會被動到。

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh -s -- --rollback --direct

GitHub 存取不暢時，使用代理執行：

curl -fsSL https://gh-proxy.com/raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh -s -- --rollback --mirror https://gh-proxy.com

兩條命令都會自動識別路由器架構,下載上一個版本的完整安裝包,先校驗 SHA256,再替換目前檔案;校驗或替換失敗會保留現有安裝。–mirror 只影響安裝包下載,查詢 Release 列表的 GitHub API 會先直連、直連不通再經鏡像。

解除安裝

預設停止服務並保留訂閱和設定資料：

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/uninstall.sh | sh

連資料一起刪除：

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/uninstall.sh | sh -s -- --purge

專業版

共享網路和用戶端屬於專業版。一份授權對應一台路由器，這台路由器配對的手機、電腦不限台數。

免費試用

每台路由器可以免費試用 14 天：在面板「設定 · 共享網路」或「設定 · 用戶端」頁點「免費試用」就開始，不用註冊。試用結束後共享網路和用戶端停用，設定都保留，啟用後馬上恢復。

啟用

  1. 在官網購買，付款後頁面會顯示啟用碼，同時發到你的電子郵件。
  2. 開啟路由器面板，進入「設定 · 後端設定」，在「專業版」卡片裡點「填啟用碼」。
  3. 貼上啟用碼，點「啟用」。路由器要能上網（存取授權服務按目標分流走，和區域網路裝置一樣）。

啟用後路由器每天自動續一次授權；斷網 30 天內照常使用。

換路由器

在新路由器的面板裡填同一個啟用碼，按提示遷移，舊的那台會自動停用。每年可以自助遷移 5 次；也可以先在我的授權裡解除綁定。

到期與續費

年付到期前 14 天和 3 天，面板和電子郵件都會提醒。到期後共享網路和用戶端停用，設定全部保留；續費從原到期日往後加一年。年付有效期內補差價 ¥500 可以升級成永久版。