nexcore-s-ui インストール・設定チュートリアル(sing-box パネル)
Astrenix/nexcore-s-ui の導入ガイド:sing-box ワンクリック設置、musl 静的バイナリ、Cloudflare DNS-01 自動証明書、/api/v1 API と CLI 運用。
- 全面刷新された Vue 3 + Element Plus UI で sing-box の入站・出站・ルーティング・ユーザーを一元管理。
- musl 静的バイナリにより amd64・arm64 など多アーキテクチャに対応し、ホストの GLIBC に依存しません。
- 監査ログ付きの /api/v1 REST API を実装し、nexcore-x-ui 互換のコントローラー連携に対応。
- Cloudflare API Token 連携を内蔵し、ポート 80 を使わずに DNS-01 で SSL 証明書を自動発行・自動更新。
アーキテクチャと主な特長
alireza0/s-ui を基盤に sing-box 運用と API 自動化向けに再構築された nexcore-s-ui の特長は次の通りです。
- 全面刷新された Vue 3 + Element Plus UI で sing-box の入站・出站・ルーティング・ユーザーを一元管理。
- musl 静的バイナリにより amd64・arm64 など多アーキテクチャに対応し、ホストの GLIBC に依存しません。
- 監査ログ付きの /api/v1 REST API を実装し、nexcore-x-ui 互換のコントローラー連携に対応。
- Cloudflare API Token 連携を内蔵し、ポート 80 を使わずに DNS-01 で SSL 証明書を自動発行・自動更新。
システムとアーキテクチャ要件
- 対応 OS — Ubuntu 24.04 LTS(検証済み推奨)。Ubuntu 20.04+、Debian 11+、CentOS Stream 8+ など systemd 搭載 Linux にも対応。
- CPU アーキテクチャ — amd64、arm64、386、armv5、armv6、armv7、s390x の静的バイナリを提供。
- 実行権限 — 80 / 443 低番ポートのバインド、ACME 証明書書き込み、tun デバイス作成のため root 権限が必要です。
- 同居性 — 導入パス・サービス名・ランダムポートが原版 s-ui と分離されており、同機共存に対応します。
ワンクリック導入・バージョン固定・強制再導入
root で SSH ログインして公式スクリプトを実行します。初回導入時はユーザー名・パスワード・ポートがすべてランダム生成されます。
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)
特定の Release タグを指定したい場合や、既存データベースを残したままバイナリを上書き修復したい場合は引数を付けます。
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 自動 SSL 証明書の設定
Hysteria2、Trojan、AnyTLS など TLS が必要な入站では Cloudflare DNS-01 による自動発行・自動更新を推奨します。
- Cloudflare 管理のドメインをノードへ向ける: Tovanix Cloud で取得したドメイン(または独自ドメイン)の A / AAAA レコードをサーバーの公衆 IP へ設定します。
- 最小権限の Cloudflare API Token を発行する: Cloudflare 管理画面で対象ゾーン限定の Zone:DNS:Edit 権限のみを持つ API Token を作成します(グローバルキーは避けてください)。
- パネルにドメインと Token を入力して発行: nexcore-s-ui の証明書画面で DNS-01 を選び、ドメインと API Token を保存すると自動で証明書取得と定期更新が行われます。
DNS-01 は DNS の 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 — データベースと設定を維持したまま最新の GitHub Releases へ更新します。
- nexcore-s-ui uninstall — バイナリ、systemd サービス、ローカルデータを完全削除します(事前バックアップ必須)。
よくある問題の切り分け
- 導入後にパネル画面へアクセスできない — ランダム生成されたパネルポートが未開放、または URI パスが抜けている。 — 導入ログのポートと URI を確認し、ファイアウォール開放後に nexcore-s-ui status で稼働を確認してください。
- Cloudflare DNS-01 証明書発行が失敗する — API Token に該当ゾーンの Zone:DNS:Edit 権限がない、または DNS 伝播が未完了。 — Token の権限範囲を見直し、nexcore-s-ui log で ACME の詳細なエラー内容を確認してください。
- Hysteria2 など UDP 系プロトコルが繋がらない — ファイアウォールで TCP のみ開放し UDP が閉じている、または証明書のドメイン・ALPN が不一致。 — 対象ポートの UDP 通信を開放し、クライアントの SNI と証明書ドメインが一致しているか確認してください。
- 設定を消さずにバイナリだけ修復したい — uninstall を実行するとデータベースまで消去されてしまう。 — uninstall は使わず install.sh --force を実行すれば既存データベースを保持したままバイナリを上書きできます。
よくある質問
ホスト側の GLIBC バージョンに制約はありますか?
ありません。musl 静的バイナリとしてビルドされており多環境で動作します。推奨 OS は Ubuntu 24.04 LTS です。
原版 alireza0/s-ui と同一サーバーで共存できますか?
はい。ディレクトリ、サービス名、ポートが分離されているため、待ち受けポートが重ならなければ共存可能です。
HTTP-01 ではなく Cloudflare DNS-01 を推奨する理由は?
ポート 80 を占有せずワイルドカード証明書にも対応でき、既存の Web サービスと競合しないため自動更新が安定します。
関連ページ: nexcore-x-ui インストール・運用チュートリアル(Xray パネル) · 自前ノードパネル選定:nexcore-x-ui・nexcore-s-ui・専用プロキシ比較 · 専用ネットワーク構築ソリューション · 専用プロキシ
読み込み中…