Tovanix
Tovanix

nexcore-x-ui 安裝與維運教學(Xray 節點面板)

Astrenix/nexcore-x-ui Xray 節點面板完整教學:一鍵安裝腳本、systemd 沙箱加固、/api/v1 介面、CLI 憑據找回與常見排障。

  • 純 Go 靜態執行檔搭配 Vue 3 + Element Plus 前端與 Xray-core,消除對宿主機 GLIBC 版本的強依賴。
  • 完整的 /api/v1 REST 介面設計,便於外部主控系統、腳本或多節點批次編排整合。
  • 內建 systemd 沙箱加固(如 ProtectSystem=strict、NoNewPrivileges=true),目錄權限 0700、資料庫權限 0600,API Token 以 SHA256 雜湊儲存。
  • VLESS:支援 XTLS-Reality、TCP、WebSocket 與 gRPC 等傳輸方式,兼顧低開銷與連線穩定性。

架構與核心特性

nexcore-x-ui 基於 vaxilu/x-ui 深度重構,針對雲端主機自動化部署與長期穩定運作做了全面加固:

  • 純 Go 靜態執行檔搭配 Vue 3 + Element Plus 前端與 Xray-core,消除對宿主機 GLIBC 版本的強依賴。
  • 完整的 /api/v1 REST 介面設計,便於外部主控系統、腳本或多節點批次編排整合。
  • 內建 systemd 沙箱加固(如 ProtectSystem=strict、NoNewPrivileges=true),目錄權限 0700、資料庫權限 0600,API Token 以 SHA256 雜湊儲存。
  • 安裝路徑、服務名稱與 CLI(nexcore-x-ui)與原版 x-ui 完全獨立,同機執行互不衝突。

系統與環境需求

  • 作業系統 — 現代帶 systemd 的 64 位元 Linux(推薦乾淨的 Ubuntu 22.04 / 24.04 LTS 或 Debian 12)。
  • 執行權限 — 需要 root 權限安裝 systemd 服務、放行連接埠與寫入受保護資料目錄。
  • 網路環境 — 伺服器需具備公網 IP 且可連線 GitHub Releases 下載安裝包;防火牆需放行面板與協定連接埠。
  • 推薦機型 — 可搭配本平台原生 IP VPS、雙 ISP VPS、住宅 IP VPS 或實體伺服器。

一鍵安裝與自動化部署

透過 SSH 以 root 身分登入伺服器後,執行官方一鍵安裝腳本即可自動下載靜態執行檔、初始化服務並產生隨機安全憑據:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)

如果你透過雲端初始化腳本或自研主控批次部署,可以在執行安裝腳本前傳入安全入口與 Webhook 回呼環境變數:

REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)

從 v2.1.3 起,基於安全考量,首次安裝產生的隨機帳號、密碼與入口不再落盤寫入明文 install-info.txt 檔案,只會輸出在終端橫幅並記錄到 systemd journal。

查看或找回首次登入憑據

如果安裝完成後不慎關閉終端,可以透過內建 CLI 或直接查詢 systemd 日誌找回首裝橫幅與連線資訊:

nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"

首次登入面板後,建議盡快透過面板設定或 nexcore-x-ui passwd 修改預設隨機密碼,並開啟防火牆限制面板連接埠的來源位址。

nexcore-x-ui 命令列(CLI)速查

安裝完成後全域註冊 nexcore-x-ui 指令,日常啟停、查日誌、改密、升級與解除安裝都不必記憶複雜路徑:

  • nexcore-x-ui — 開啟互動式維運選單,依數字編號選擇常用管理動作。
  • nexcore-x-ui start | stop | restart | status — 啟動、停止、重啟面板服務或查看目前運作狀態。
  • nexcore-x-ui creds / info — 查看目前面板連接埠、入口路徑與首裝憑據資訊。
  • nexcore-x-ui reset — 強制重新產生隨機管理員帳號、密碼與隨機面板連接埠。
  • nexcore-x-ui passwd <user> <new_password> — 將指定管理員帳號的登入密碼手動修改為新密碼。
  • nexcore-x-ui log / log-tail — 查看最近 200 行面板運作日誌,或即時追蹤輸出日誌串流。
  • nexcore-x-ui update — 將面板平滑升級到 GitHub Releases 最新版本並熱重啟服務。
  • nexcore-x-ui uninstall — 徹底移除面板執行檔、systemd 服務與資料目錄(執行前請先備份設定)。

支援的協定與傳輸方式

面板完整繼承 Xray-core 生態,支援多使用者獨立憑據、流量上限與到期時間控制:

  • VLESS:支援 XTLS-Reality、TCP、WebSocket 與 gRPC 等傳輸方式,兼顧低開銷與連線穩定性。
  • VMess 與 Trojan:適配各類既有客戶端與 TLS 網域設定場景。
  • Shadowsocks 與 Shadowsocks-2022:輕量高效,適合一般客戶端與高速內網或中轉鏈路。
  • SOCKS、HTTP 與 Dokodemo-door:適合程式代理、定點轉發與多節點鏈式出站。

開啟入站並測試連通後,建議把伺服器出口 IP 放進本站 IP 品質查詢核對原生與電信商標記,確認符合業務需求。

常見問題排查

  • 瀏覽器打不開面板登入頁 — 伺服器防火牆或雲端安全群組未放行隨機面板連接埠,或漏填安全入口路徑。 — 先執行 nexcore-x-ui status 與 nexcore-x-ui info 確認監聽連接埠與路徑,再到控制台防火牆放行對應 TCP 連接埠。
  • 忘記首次安裝的隨機密碼 — v2.1.3 及以上版本不再儲存明文檔案,關閉視窗後容易遺漏。 — 執行 nexcore-x-ui creds 從 journal 查看,或執行 nexcore-x-ui passwd <使用者名稱> <新密碼> 重設密碼。
  • 入站已建立但用戶端連不上 — 協定連接埠未放行、Reality 目標網域交握失敗,或系統時間偏差過大。 — 確認對應 TCP / UDP 連接埠已放行,校對伺服器 NTP 時間,並透過 nexcore-x-ui log-tail 查看 Xray 錯誤詳情。
  • 面板內觸發升級後未生效 — 網路拉取 GitHub Releases 逾時或殘留舊行程。 — 在 SSH 終端手動執行 nexcore-x-ui update 並觀察輸出日誌,完成後檢查 nexcore-x-ui status。

常見問題

nexcore-x-ui 可以和原版 vaxilu/x-ui 裝在同一台機器嗎?

可以。nexcore-x-ui 使用獨立的執行檔路徑、資料目錄、systemd 服務名與 CLI 指令,只要兩者連接埠不衝突即可共存。

升級 nexcore-x-ui 會清空現有入站和使用者設定嗎?

不會。透過面板線上升級或執行 nexcore-x-ui update 只替換程式執行檔並保留資料庫與現有節點設定。

怎麼用 /api/v1 介面自動化管理節點?

登入面板後在設定中產生 API Token(伺服器僅存 SHA256 雜湊),之後即可用標準 REST 請求建立入站、增刪使用者與讀取流量統計。

相關頁面: nexcore-s-ui 安裝與設定教學(sing-box 節點面板) · 自建節點面板選型:nexcore-x-ui、nexcore-s-ui 與獨享代理 · 專屬網路部署解決方案 · 原生 IP 與住宅 IP 的 VPS

正在載入…