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
正在載入…