nexcore-s-ui 安裝與設定教學(sing-box 節點面板)
Astrenix/nexcore-s-ui sing-box 節點面板完整教學:一鍵安裝、musl 靜態編譯、Cloudflare DNS-01 自動憑證、/api/v1 介面與 CLI 維運。
- 完整重寫的 Vue 3 + Element Plus 前端,統一管理 sing-box 的入站、出站、路由規則與多使用者憑據。
- 採用 musl 靜態編譯,支援 amd64、arm64 等多架構 Linux,不依賴宿主機 GLIBC 版本。
- 提供完整的 /api/v1 REST 介面與 API 稽核日誌,介面規範相容 nexcore-x-ui 主控對接。
- 內建 Cloudflare API Token 整合,支援 DNS-01 方式全自動申請與續簽 SSL 憑證,不必手動處理 80 連接埠驗證。
架構與核心特性
nexcore-s-ui 基於 alireza0/s-ui 二次開發重構,面向 sing-box 生態與自動化維運場景:
- 完整重寫的 Vue 3 + Element Plus 前端,統一管理 sing-box 的入站、出站、路由規則與多使用者憑據。
- 採用 musl 靜態編譯,支援 amd64、arm64 等多架構 Linux,不依賴宿主機 GLIBC 版本。
- 提供完整的 /api/v1 REST 介面與 API 稽核日誌,介面規範相容 nexcore-x-ui 主控對接。
- 內建 Cloudflare API Token 整合,支援 DNS-01 方式全自動申請與續簽 SSL 憑證,不必手動處理 80 連接埠驗證。
系統與架構需求
- 推薦系統 — Ubuntu 24.04 LTS(已通過端到端驗證);同時相容 Ubuntu 20.04+、Debian 11+、CentOS Stream 8+ 等帶 systemd 的現代 Linux。
- CPU 架構 — 支援 amd64、arm64、386、armv5、armv6、armv7 與 s390x 靜態執行檔。
- 執行權限 — 需要 root 權限執行,用於綁定 80 / 443 低連接埠、寫入 ACME 憑證及依需求建立 tun 裝置。
- 隔離共存 — 路徑、服務名與預設隨機連接埠皆與上游原版 s-ui 隔離,支援同機獨立共存。
一鍵安裝、指定版本與強制重裝
以 root 登入 Linux 伺服器後,執行官方一鍵安裝腳本。首次安裝會自動產生隨機使用者名稱、隨機密碼與隨機面板存取連接埠:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)
如果需要鎖定特定 Release 版本,或在不遺失資料庫的情況下覆寫程式執行檔,可附加版本標籤或 --force 參數:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0
首次安裝結束時終端會一次性印出隨機使用者名稱、密碼與面板 URI,請立即複製保存;關閉終端後無法直接查看明文密碼。
設定 Cloudflare DNS-01 自動憑證
使用 Hysteria2、Trojan、AnyTLS 或需要 TLS 網域的入站時,推薦透過 Cloudflare DNS-01 自動簽發並續簽憑證:
- 準備已接入 Cloudflare 解析的網域: 在 Tovanix 雲端服務註冊網域(或使用自有網域),並將目標子網域的 A / AAAA 記錄指向節點伺服器公網 IP。
- 建立最小權限的 Cloudflare API Token: 在 Cloudflare 控制台為目標網域區域產生僅含 Zone:DNS:Edit 權限的 API Token,避免使用全域金鑰。
- 在面板中填入 Token 與網域完成簽發: 進入 nexcore-s-ui 憑證管理頁,選擇 DNS-01 模式並填入網域與 API Token,儲存後系統會自動完成憑證申請與週期續簽。
DNS-01 驗證透過解析 TXT 記錄完成,即使伺服器的 80 連接埠被佔用或未對外開放,也能正常簽發與續簽憑證。
nexcore-s-ui 命令列(CLI)速查
安裝完成後可透過 nexcore-s-ui 指令進行日常啟停、查日誌、升級與解除安裝:
- nexcore-s-ui — 開啟互動式控制選單,集中執行面板管理與維護項目。
- nexcore-s-ui start | stop | restart | status — 啟動、停止、重啟 nexcore-s-ui 服務或檢查運作狀態。
- nexcore-s-ui log — 查看面板與核心服務的近期運作日誌,輔助定位入站或憑證錯誤。
- nexcore-s-ui update — 升級面板程式至最新 Release 版本,自動保留原有資料庫與設定。
- nexcore-s-ui uninstall — 完整移除面板程式、systemd 服務與本機資料(操作不可逆,請提前備份)。
常見問題排查
- 安裝後存取面板位址無回應 — 隨機產生的面板連接埠尚未在防火牆或安全群組放行,或遺漏了面板 URI 路徑。 — 核對安裝橫幅顯示的完整連接埠與路徑,在控制台放行對應連接埠後執行 nexcore-s-ui status 確認服務活躍。
- Cloudflare DNS-01 憑證申請失敗 — API Token 缺少對應網域的 DNS 編輯權限,或網域解析尚未生效。 — 檢查 Token 作用範圍是否包含目標網域且具備 Zone:DNS:Edit 權限,透過 nexcore-s-ui log 查看 ACME 回傳的具體錯誤。
- Hysteria2 或 UDP 類協定連線失敗 — 伺服器防火牆只放行了 TCP 連接埠而漏放 UDP,或憑證未包含正確網域與 ALPN。 — 同時放行對應連接埠的 UDP 流量,確保憑證有效且客戶端 SNI 與憑證網域一致。
- 執行檔損毀需要修復但不想遺失設定 — 直接執行解除安裝會連同資料庫一併清除。 — 不要執行 uninstall,改執行 install.sh --force 覆蓋程式執行檔即可完整保留原有資料庫。
常見問題
nexcore-s-ui 對宿主機 GLIBC 版本有要求嗎?
沒有強依賴。發行包採用 musl 靜態編譯,相容多種主流 Linux 發行版與不同架構,推薦優先使用 Ubuntu 24.04 LTS。
能否與原版 alireza0/s-ui 裝在同一台伺服器?
可以。nexcore-s-ui 的安裝目錄、服務名稱與連接埠皆獨立隔離,只要避免監聽連接埠重疊即可共存。
為什麼推薦優先使用 Cloudflare DNS-01 申請憑證?
DNS-01 不依賴伺服器 80 連接埠,支援萬用字元憑證且不會與既有 Web 服務搶佔連接埠,更適合自動化續簽。
相關頁面: nexcore-x-ui 安裝與維運教學(Xray 節點面板) · 自建節點面板選型:nexcore-x-ui、nexcore-s-ui 與獨享代理 · 專屬網路部署解決方案 · 獨享代理
正在載入…