nexcore-x-ui インストール・運用チュートリアル(Xray パネル)
Astrenix/nexcore-x-ui の導入手順:ワンクリックインストール、静的 Go バイナリ、systemd 強化、/api/v1 REST API、CLI 認証確認と障害対応。
- 静的 Go バイナリと Vue 3 + Element Plus SPA、Xray-core を統合し、ホスト側の GLIBC バージョン依存を排除。
- 外部コントローラーやスクリプト、複数ノード自動化に適した体系的な /api/v1 REST API を提供。
- systemd サンドボックス強化(ProtectSystem=strict、NoNewPrivileges=true 等)、0700 ディレクトリ、0600 DB 権限、SHA256 ハッシュによる API Token 保管を標準化。
- VLESS:XTLS-Reality、TCP、WebSocket、gRPC に対応し、低オーバーヘッドで安定接続を実現。
アーキテクチャと主な特長
vaxilu/x-ui をベースにクラウド自動化と長期運用向けに全面刷新した nexcore-x-ui の特長は次の通りです。
- 静的 Go バイナリと Vue 3 + Element Plus SPA、Xray-core を統合し、ホスト側の GLIBC バージョン依存を排除。
- 外部コントローラーやスクリプト、複数ノード自動化に適した体系的な /api/v1 REST API を提供。
- systemd サンドボックス強化(ProtectSystem=strict、NoNewPrivileges=true 等)、0700 ディレクトリ、0600 DB 権限、SHA256 ハッシュによる API Token 保管を標準化。
- 導入パス、サービス名、CLI(nexcore-x-ui)が原版 x-ui と独立しており、同一マシン上で競合しません。
動作要件
- OS — systemd を備えた 64bit Linux(クリーンな Ubuntu 22.04 / 24.04 LTS または Debian 12 を推奨)。
- 権限 — systemd サービス登録、ポート設定、保護ディレクトリ作成のため root 権限が必要です。
- ネットワーク — 公衆 IP と GitHub Releases への取得経路があり、ファイアウォールでパネルおよびプロトコルのポートを開放できること。
- 推奨サーバー — Tovanix のネイティブ 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 journal から初回バナーを確認できます。
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 <user> <new_password> で再設定してください。
- 入站は稼働中だがクライアントが接続できない — プロトコルポート未開放、Reality 対象ドメインのハンドシェイク不備、またはサーバー時刻のずれ。 — TCP / UDP 開放と NTP 時刻同期を確認し、nexcore-x-ui log-tail で Xray のエラーを確認してください。
- パネル内の更新操作が反映されない — GitHub Releases 取得のタイムアウトや旧プロセスの残留。 — SSH で nexcore-x-ui update を実行して詳細ログを確認し、完了後 nexcore-x-ui status を点検してください。
よくある質問
原版 vaxilu/x-ui と同じサーバーで同居できますか?
はい。バイナリ、データディレクトリ、systemd ユニット、CLI 名がすべて独立しているため、ポートが重複しなければ同居できます。
アップデートで既存の入站やユーザー設定は消えますか?
消えません。パネル内更新や nexcore-x-ui update はバイナリのみ差し替え、データベースと設定を保持します。
/api/v1 で自動管理を始める手順は?
パネル設定から API Token を発行(サーバーには SHA256 ハッシュのみ保存)すると、標準 REST API で入站やユーザー、通信量を操作できます。
関連ページ: nexcore-s-ui インストール・設定チュートリアル(sing-box パネル) · 自前ノードパネル選定:nexcore-x-ui・nexcore-s-ui・専用プロキシ比較 · 専用ネットワーク構築ソリューション · ネイティブ IP・住宅 IP の VPS
読み込み中…