Tovanix
Tovanix

Tutorial pemasangan & operasional nexcore-x-ui (panel Xray)

Panduan lengkap Astrenix/nexcore-x-ui: pemasangan satu perintah, Vue 3 + biner Go statis, penguatan systemd, REST API /api/v1, CLI, dan perbaikan.

  • Biner Go statis bersama Vue 3 + Element Plus SPA dan Xray-core tanpa ketergantungan ketat pada versi GLIBC host.
  • REST API /api/v1 yang terstruktur untuk pengendali eksternal, skrip, dan orkestrasi banyak node.
  • Penguatan systemd (ProtectSystem=strict, NoNewPrivileges=true), izin direktori 0700, basis data 0600, serta token API tersimpan sebagai hash SHA256.
  • VLESS dengan transpor XTLS-Reality, TCP, WebSocket, dan gRPC untuk beban ringan serta koneksi stabil.

Arsitektur dan fitur utama

Dirancang ulang dari vaxilu/x-ui untuk otomatisasi cloud dan keamanan produksi, nexcore-x-ui menghadirkan:

  • Biner Go statis bersama Vue 3 + Element Plus SPA dan Xray-core tanpa ketergantungan ketat pada versi GLIBC host.
  • REST API /api/v1 yang terstruktur untuk pengendali eksternal, skrip, dan orkestrasi banyak node.
  • Penguatan systemd (ProtectSystem=strict, NoNewPrivileges=true), izin direktori 0700, basis data 0600, serta token API tersimpan sebagai hash SHA256.
  • Jalur pemasangan, layanan systemd, dan perintah CLI (nexcore-x-ui) yang terpisah sehingga tidak bentrok dengan x-ui asli.

Persyaratan sistem

  • Sistem operasi — Linux 64-bit modern dengan systemd (disarankan Ubuntu 22.04 / 24.04 LTS bersih atau Debian 12).
  • Hak akses — Akses root diperlukan untuk mendaftarkan unit systemd, mengatur port, dan mengamankan direktori data.
  • Jaringan — IP publik dengan akses keluar ke GitHub Releases untuk mengunduh biner, serta firewall yang mengizinkan port panel dan protokol.
  • Server yang disarankan — Cocok dipadukan dengan VPS IP natif, VPS Dual-ISP, VPS residensial, atau server fisik Tovanix.

Pemasangan satu perintah & penyediaan otomatis

Masuk lewat SSH sebagai root lalu jalankan skrip resmi untuk mengunduh biner statis, mengaktifkan layanan, dan membuat kredensial acak:

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

Untuk penyediaan massal via cloud-init atau pengendali sendiri, sertakan variabel jalur aman dan webhook callback sebelum menjalankan skrip:

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)

Mulai v2.1.3, kredensial awal teks biasa tidak lagi ditulis ke install-info.txt di disk; informasi hanya tampil di banner terminal dan tercatat di systemd journal.

Melihat kembali kredensial masuk awal

Jika terminal terlanjur ditutup setelah pemasangan, ambil kembali banner awal lewat CLI atau langsung dari systemd journal:

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

Setelah masuk pertama kali, ubah kata sandi acak lewat panel atau perintah nexcore-x-ui passwd lalu batasi akses port panel di firewall.

Referensi cepat CLI nexcore-x-ui

Pemasangan mendaftarkan perintah global nexcore-x-ui untuk mengendalikan layanan, log, kata sandi, pembaruan, dan penghapusan:

  • nexcore-x-ui — Membuka menu pengelolaan interaktif di terminal.
  • nexcore-x-ui start | stop | restart | status — Menjalankan, menghentikan, memuat ulang, atau mengecek status layanan panel.
  • nexcore-x-ui creds / info — Menampilkan port panel, jalur masuk, serta kredensial awal.
  • nexcore-x-ui reset — Membuat ulang nama pengguna admin, kata sandi, dan port panel secara acak.
  • nexcore-x-ui passwd <user> <new_password> — Mengubah kata sandi masuk secara manual untuk akun admin tertentu.
  • nexcore-x-ui log / log-tail — Menampilkan 200 baris log terakhir atau memantau aliran log secara langsung.
  • nexcore-x-ui update — Memperbarui dengan mulus ke rilis terbaru GitHub Releases lalu memulai ulang layanan.
  • nexcore-x-ui uninstall — Menghapus biner, unit systemd, dan direktori data secara menyeluruh (cadangkan dulu).

Protokol dan transpor yang didukung

Berjalan langsung di atas Xray-core dengan dukungan akun per pengguna, kuota lalu lintas, dan batas masa berlaku untuk:

  • VLESS dengan transpor XTLS-Reality, TCP, WebSocket, dan gRPC untuk beban ringan serta koneksi stabil.
  • VMess dan Trojan demi kompatibilitas klien lama dan konfigurasi domain TLS.
  • Shadowsocks dan Shadowsocks-2022 untuk klien ringan dan jalur relai cepat.
  • SOCKS, HTTP, dan Dokodemo-door untuk proxy aplikasi, penerusan port, dan rantai multi-hop.

Setelah menguji inbound, periksa IP keluar Anda di Pemeriksaan Kualitas IP gratis untuk memastikan status natif dan operatornya.

Pemecahan masalah

  • Halaman login panel tidak terbuka di peramban — Port acak panel masih diblokir firewall atau jalur masuk aman terlewat di URL. — Jalankan nexcore-x-ui status dan nexcore-x-ui info untuk memeriksa port serta jalur, lalu buka port TCP itu di firewall.
  • Lupa kata sandi acak awal — Versi v2.1.3 ke atas tidak menyimpan file kredensial teks biasa di disk. — Jalankan nexcore-x-ui creds untuk membaca journal, atau atur ulang dengan nexcore-x-ui passwd <user> <new_password>.
  • Inbound aktif tetapi klien gagal terhubung — Port protokol tertutup, handshake Reality gagal, atau jam server terlalu melenceng. — Periksa aturan TCP / UDP, sinkronkan waktu NTP, dan lihat galat Xray melalui nexcore-x-ui log-tail.
  • Pembaruan dari dalam panel tidak berubah — Unduhan GitHub Releases habis waktu atau proses lama masih tertinggal. — Jalankan nexcore-x-ui update lewat SSH untuk memantau log lengkap lalu cek dengan nexcore-x-ui status.

Pertanyaan umum

Bisakah nexcore-x-ui dipasang bersama vaxilu/x-ui di satu server?

Bisa. Biner, direktori data, unit systemd, dan CLI terpisah sepenuhnya sehingga dapat berjalan berdampingan selama port tidak bentrok.

Apakah pembaruan nexcore-x-ui menghapus inbound dan pengguna yang ada?

Tidak. Pembaruan dari panel maupun nexcore-x-ui update hanya mengganti biner dan tetap menjaga basis data SQLite.

Bagaimana cara mengotomatiskan node dengan /api/v1?

Buat API Token di pengaturan panel (disimpan di server sebagai hash SHA256), lalu kirim permintaan REST standar untuk inbound, pengguna, dan statistik.

Halaman terkait: Tutorial pemasangan & konfigurasi nexcore-s-ui (sing-box) · Panduan memilih panel node: nexcore-x-ui, nexcore-s-ui & Proxy Khusus · Solusi penerapan jaringan privat · VPS dengan IP asli dan IP residensial

Memuat…