FASTPANELWIKI

Fitur Extended

Kustomisasi Branding

Di halaman ini

Bagian Branding di FASTPANEL® memungkinkan Anda menyesuaikan tampilan visual dan gaya panel kontrol. Menu ini terletak di "Pengaturan" → "Utama" → "Branding".

Skema Warna

Buka tab "Skema warna" untuk mengubah tema warna utama panel. Pilih dari berbagai palet warna bawaan (misalnya, biru, oranye, merah, hijau).

Sesuaikan Tema:

  • Terang: Gunakan tema terang
  • Gelap: Beralih ke mode gelap
  • Sama seperti di perangkat: Secara otomatis menyesuaikan dengan pengaturan perangkat pengguna

Tab "Logo" memungkinkan pengunggahan logo kustom untuk area panel yang berbeda.

Layar Login
Logo terpisah dapat diunggah untuk tema Terang dan Gelap.
Gunakan tombol Unggah untuk menambahkan logo baru atau Atur Ulang untuk mengembalikan ke setelan bawaan.

  • Format yang didukung: jpeg, png, svg, webp
  • Resolusi maksimum: 256x100 piksel
  • Ukuran file maksimum: 5 MB

Logo Header
Ditampilkan di header panel kontrol.

  • Format yang didukung: jpeg, png, svg, webp
  • Resolusi maksimum: 200x22 piksel
  • Ukuran file maksimum: 5 MB

Kustomisasi Favicon

Tab "Favicon" memungkinkan pengunggahan favicon, yang ditampilkan di tab browser dan hasil pencarian.
Gunakan tombol Unggah untuk menambahkan favicon atau Atur Ulang untuk mengembalikan ke setelan bawaan.

  • Format yang didukung: ico
  • Ukuran file maksimum: 1 MB

Kustomisasi Tautan

Tab "Tautan" menyediakan kolom untuk menyesuaikan tautan di menu samping.

  • Basis pengetahuan: URL untuk mengakses basis pengetahuan

Setelah mengubah tautan, klik Simpan untuk menerapkan perubahan.

Node.js

Di halaman ini
info

FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.

Pendahuluan

Node.js adalah platform server yang menjalankan aplikasi yang ditulis dalam JavaScript.

Pertama, Anda perlu menginstal Node.js:

  • Buka "Settings" -> "Applications"
  • Klik tombol "Install" untuk versi Node.js yang diperlukan

Buat website:

  • Pilih templat untuk website Node.js
  • Tentukan domain dan parameter terkait. Pada tahap konfigurasi Anda dapat mengubah DB, pengguna FTP, dan Backend
  • Unggah file aplikasi ke direktori website
  • Untuk menginstal dependensi jalankan npm20.15.1 install di Terminal (perlu menginstal aplikasi ttyd untuk FASTPANEL®)
  • Mulai ulang Node.js dengan membuka dasbor situs lalu membuka bagian "Services".

Framework Express

Menggunakan framework Express sebagai contoh, mari buat server web sederhana:

  • Hubungkan ke server melalui SSH sebagai pengguna pemilik situs (Anda dapat menggunakan aplikasi ttyd untuk FASTPANEL®)
  • Buat file app.js di direktori website dan isi dengan kode berikut:
const express = require('express');
const app = express();
const PORT = process.env.SERVICE_PORT;

app.get('/', (req, res) => {
  res.send('Hello! This is my first server on Node.js + Express 🚀');
});

app.listen(PORT, () => {
  console.log(`Server is running at http://localhost:${PORT}`);
});
  • Di direktori website, jalankan perintah untuk menginstal express
npm20.15.1 install express
  • Buka dasbor situs, lalu ke bagian Services
  • Mulai ulang layanan
  • Periksa website

Docusaurus

Menggunakan aplikasi web Docusaurus sebagai contoh, mari konfigurasi pengaturan:

  • Hubungkan ke server melalui SSH sebagai pengguna pemilik situs (Anda dapat menggunakan aplikasi ttyd untuk FASTPANEL®)
  • Di direktori website, jalankan instalasi Docusaurus
npx20.15.1 create-docusaurus -j ./docs
  • Saat diminta memilih templat, jawab classic (recommended)

  • Setelah instalasi, ganti satu baris dalam file docs/package.json

"start": "docusaurus start",
# replace with 
"start": "docusaurus start --port $SERVICE_PORT",

$SERVICE_PORT adalah variabel sistem yang diatur di FASTPANEL®

  • Di panel kontrol, buka "site settings" -> "Backend"

  • Pilih handler Standalone atau PM2.

  • Pilih versi Node.js yang diinginkan.

  • Tentukan folder kerja docs

  • Di kolom Launch command, masukkan: npm run start

  • Simpan. Tunggu hingga aplikasi dikompilasi (informasi akan muncul di log). Periksa website

Next.js

Menggunakan Next.js dengan Node.js 20.19 sebagai contoh, mari buat server web sederhana:

  • Hubungkan ke server melalui SSH sebagai pengguna pemilik website (Anda juga dapat menggunakan aplikasi ttyd di FASTPANEL®).
  • Di direktori website, jalankan perintah inisialisasi proyek:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom
  • Tambahkan blok scripts ke file package.json:
"scripts": {
  "dev": "next dev -p $SERVICE_PORT",
  "build": "next build",
  "start": "next start -p $SERVICE_PORT"
}
  • Buat direktori pages dan di dalamnya, tambahkan file bernama index.js:
mkdir pages
cat <<EOF > pages/index.js
export async function getServerSideProps() {
  return {
    props: {
      nodeVersion: process.version,
      port: process.env.SERVICE_PORT || 3000,
    },
  };
}

export default function Home({ nodeVersion, port }) {
  return (
    <div style={{
      fontFamily: 'sans-serif',
      textAlign: 'center',
      marginTop: '20vh'
    }}>
      <h1>✅ It works!</h1>
      <p>Next.js app running on Node.js {nodeVersion}</p>
      <p>Port: {port}</p>
    </div>
  );
}
EOF
  • Jalankan build proyek.
yarn20.19.4 build
  • Di panel kontrol, buka "site settings" -> "Backend"
  • Pilih handler Standalone atau PM2.
  • Pilih versi Node.js yang diinginkan.
  • Di kolom Launch command, masukkan: yarn run start.
  • Simpan. Tunggu hingga aplikasi dikompilasi (informasi akan muncul di log). Periksa website

Informasi tambahan

Dalam mode Standalone, proses Node.js dijalankan untuk mengeksekusi skrip Anda.

Dalam mode PM2, manajer proses PM2 digunakan untuk mengelola proses Node.js, log, dan beban sistem.
Mode ini juga memungkinkan Anda menentukan jumlah worker — yaitu jumlah proses Node.js yang menangani permintaan masuk ke server.
Selain itu, mode ini menyediakan opsi Enable file watch — PM2 akan secara otomatis memulai ulang aplikasi Anda saat file diubah di direktori saat ini atau subdirektorinya. Harap dicatat bahwa mode ini menambah beban sistem dan tidak direkomendasikan untuk lingkungan produksi.

Demikian pula, Anda dapat mengonfigurasi aplikasi jika memerlukan YARN alih-alih NPM

Anda dapat menginstal dependensi proyek yang tercantum dalam package.json menggunakan YARN atau NPM langsung dari FASTPANEL®. Untuk melakukannya, buka kartu website dan buka bagian Services:

Log

Aplikasi Node.js dapat menghasilkan log. Di FASTPANEL®, log tersebut berada di dasbor situs, di bagian Logs, pada tab "Backend log"

Perintah konsol

Setelah menginstal Node.js di FASTPANEL®, pengguna dapat bekerja dengan proyek mereka menggunakan perintah konsol seperti:

  • pm2
  • yarn20.15.1
  • npx20.15.1
  • npm20.15.1
  • node20.15.1

Contoh:

$ npm20.15.1 list
node-socket-port-server@1.0.0 /var/www/node_user/data/www/node.site
└── express@4.21.2
$ pm2 ls
┌────┬─────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name        │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼─────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9355     │ 2m     │ 0    │ online    │ 0%       │ 62.4mb   │ user     │ disabled │
│ 1  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9362     │ 2m     │ 0    │ online    │ 0%       │ 62.5mb   │ user     │ disabled │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

Setiap nama perintah menyertakan nomor versi Node.js yang telah diinstal. Dalam contoh ini, versi yang tersedia adalah Node.js 20.15.1.

Notifikasi server

Di halaman ini
info

FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.

FASTPANEL® memungkinkan pemantauan metrik server utama: beban CPU, Load Average 5, penggunaan disk, dan konsumsi RAM. Ketika suatu metrik melebihi ambang batasnya, peringatan akan dikirim secara otomatis ke Telegram atau Slack. Konfigurasi berada di "Settings" → "Notifications".

Artikel ini menjelaskan cara menyiapkan saluran pengiriman dan mengonfigurasi parameter notifikasi, termasuk ambang batas dan trigger.

Penyiapan saluran

Telegram

  1. Buat bot baru menggunakan bot resmi Telegram @BotFather. Ikuti tautan dan klik tombol "Start"
  1. Ketik /newbot dan tekan Enter.
  2. Masukkan nama yang diinginkan untuk bot Anda dan tekan Enter.
  3. Masukkan username yang diinginkan untuk bot Anda. Harus diakhiri dengan bot, lalu tekan Enter.
  4. Anda akan menerima pesan yang dimulai dengan:
    Done! Congratulations on your new bot.
  5. Klik baris biru setelah Use this token to access the HTTP API: (diburamkan pada tangkapan layar) untuk menyalin token API bot Anda ke clipboard. Jaga keamanan token tersebut, karena siapa pun yang memilikinya dapat mengendalikan bot Anda
catatan

Token API disimpan di @BotFather. Jika Anda lupa, kirim perintah /mybots, pilih bot Anda, lalu klik tombol "API Token".

  1. Buka FASTPANEL® dan buka "Settings" → "Notifications".
  2. Klik tombol "Create channel"
  1. Isi bidang berikut:
  • Name — Masukkan nama untuk saluran agar dapat dibedakan secara visual
  • Channel — Pilih "Telegram"
  • Bot token — Tempel token bot yang disalin pada langkah 6
  • Problem period — Atur interval waktu (dalam menit) setelah itu notifikasi akan dikirim jika masalah tetap berlanjut. Nilai minimum adalah 1 menit
  • Notification repeat interval — Atur interval antara notifikasi berturut-turut untuk masalah yang sama
  • Notify about solved problems — Aktifkan opsi ini untuk menerima notifikasi saat masalah terselesaikan
  • Add basic triggers — Aktifkan opsi ini untuk secara otomatis membuat trigger untuk semua drive, RAM, dan CPU
  1. Klik tombol "Save".
  2. Pada layar berikutnya, klik tombol "Invite" untuk mengundang bot Anda ke obrolan atau obrolan grup
  1. Tautan akan terbuka di tab baru. Konfirmasikan pengalihan ke aplikasi Telegram Desktop
  1. Klik tombol "Start" untuk mengaktifkan bot Anda
  1. Untuk memverifikasi bahwa penyiapan sudah benar, kembali ke tab FASTPANEL® dan klik tombol pesawat kertas
  1. Jika semuanya dikonfigurasi dengan benar, notifikasi uji akan dikirim ke obrolan dengan bot Anda
  1. Untuk menyesuaikan pengaturan saluran nanti, klik ikon pensil di sebelah saluran
  1. Di bawah ini adalah contoh notifikasi yang dihasilkan ketika trigger diaktifkan

Slack

  1. Masuk ke akun Anda dan buat aplikasi Slack melalui halaman aplikasi.
  2. Pilih "From scratch".
  3. Masukkan App Name, pilih workspace tempat aplikasi akan dibuat, lalu klik “Create app”.
  4. Di bagian “Features”, buka “Incoming Webhooks” dan aktifkan fitur tersebut
  1. Di bagian bawah halaman yang sama, klik “Add New Webhook”
  1. Pada layar berikutnya, pilih saluran tempat notifikasi akan dikirim. Disarankan untuk membuat saluran khusus untuk peringatan. Lalu klik “Allow”.
  2. Anda akan diarahkan kembali ke halaman webhooks. Gulir ke bawah dan klik “Copy” untuk menyalin URL webhook
  1. Buka FASTPANEL® dan buka "Settings" → "Notifications".
  2. Klik tombol "Create channel"
  1. Isi bidang berikut:
  • Name — Masukkan nama untuk saluran agar dapat dibedakan secara visual
  • Channel — Pilih "Slack"
  • Webhook url — Tempel URL webhook yang disalin pada langkah 7
  • Problem period — Atur interval waktu (dalam menit) setelah itu notifikasi akan dikirim jika masalah tetap berlanjut. Nilai minimum adalah 1 menit
  • Notification repeat interval — Atur interval antara notifikasi berturut-turut untuk masalah yang sama
  • Notify about solved problems — Aktifkan opsi ini untuk menerima notifikasi saat masalah terselesaikan
  • Add basic triggers — Aktifkan opsi ini untuk secara otomatis membuat trigger untuk semua drive, RAM, dan CPU
  1. Klik tombol "Save".
  2. Untuk memverifikasi bahwa penyiapan sudah benar, klik tombol pesawat kertas
  1. Jika semuanya dikonfigurasi dengan benar, notifikasi uji akan dikirim ke saluran yang dipilih pada langkah 6
  1. Untuk menyesuaikan pengaturan saluran nanti, klik ikon pensil di sebelah saluran
  1. Di bawah ini adalah contoh notifikasi yang dihasilkan ketika trigger diaktifkan

Konfigurasi trigger

Untuk mengonfigurasi trigger, klik ikon cog pada baris saluran yang ingin Anda edit

Di bagian yang terbuka, Anda dapat:

  1. Nonaktifkan trigger yang tidak diperlukan menggunakan toggle di sebelah kiri.
  2. Buat trigger baru dengan salah satu tipe berikut: CPU, Disk (untuk setiap disk secara terpisah), Load Average 5 (rata-rata beban sistem selama 5 menit terakhir), RAM.
  3. Edit trigger yang ada

Ambang batas untuk CPU, Disk, dan RAM diatur dalam persentase. Ambang batas untuk Load Average 5 diatur dalam nilai integer.

catatan

Sebagai aturan umum, nilai Load Average 5 yang normal kira-kira sama dengan jumlah inti CPU pada server, atau hingga dua kali jumlah tersebut.

FASTPANEL Extended

Prometheus

Di halaman ini
info

FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.

Integrasi FASTPANEL dengan Prometheus untuk pengumpulan metrik

FASTPANEL® sekarang mendukung integrasi dengan Prometheus untuk mengumpulkan metrik sistem. Panduan ini akan memandu Anda melalui langkah-langkah yang diperlukan untuk menambahkan instance FASTPANEL® Anda ke Prometheus, sehingga Anda dapat mengumpulkan dan memantau metrik sistem secara real time.

Buat Token

Agar Prometheus dapat mengumpulkan metrik, Anda perlu membuat token khusus dengan akses terbatas:

  1. Hubungkan ke server FASTPANEL® Anda melalui SSH.

  2. Jalankan perintah berikut untuk membuat token:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token adalah nama khusus untuk token; Anda dapat memilih nama apa pun
  • Token akan diberikan cakupan berikut:
    • read_only — akses hanya-baca
    • metrics_only — akses dibatasi hanya untuk metrik

Tambahkan job ke Prometheus

Setelah token dibuat, Anda perlu mengonfigurasi Prometheus untuk mulai melakukan scraping metrik dari instance FASTPANEL® Anda.

Buka file konfigurasi Prometheus Anda dan tambahkan job baru:

- job_name: "fastpanel2"
  scheme: https
  static_configs:
    - targets: ["$IP:8888"]
  metrics_path: /api/metrics
  tls_config:
    insecure_skip_verify: true
  bearer_token: I_AM_TOKEN
  scrape_interval: 60s
  • job_name — nama khusus untuk job
  • targets — alamat IP dan port server FASTPANEL® Anda. Ganti $IP dengan alamat IP server Anda
  • metrics_path — endpoint API untuk mengambil metrik
  • bearer_token — ganti ini dengan token yang Anda buat (metrics_test_token)
  • scrape_interval — seberapa sering Prometheus harus melakukan scraping metrik (dalam kasus ini diatur ke 60 detik)

Konfigurasikan Dashboard Monitoring

Setelah berhasil menambahkan instance FASTPANEL® Anda ke Prometheus, Anda dapat menyiapkan dashboard pertama Anda untuk memvisualisasikan metrik yang dikumpulkan.

Untuk mengimpor dashboard, silakan ikuti panduan ini.

Sekarang Prometheus akan mulai mengumpulkan metrik dari instance FASTPANEL® Anda, sehingga Anda dapat memantau performa sistem secara real time.

Statistik email

Di halaman ini
info

FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.

FASTPANEL® menyertakan fitur Statistik email yang memungkinkan Anda memantau aktivitas email keluar dengan mudah untuk seluruh domain atau kotak surat individual. Anda dapat dengan cepat melihat berapa banyak pesan yang dikirim, terkirim, atau terpental, serta melihat kode kesalahan SMTP yang terperinci dengan rekomendasi yang menjelaskan mengapa email tertentu ditolak.

Konfigurasikan pengumpulan statistik otomatis

  1. Untuk mengaktifkan pengumpulan statistik email otomatis, buka "Settings" → "Mail" → "Statistics" dan aktifkan opsi "Enable statistics collection".

Jika Anda memilih untuk tidak mengumpulkan data secara otomatis, nonaktifkan opsi ini. Setelah itu, Anda perlu mengeklik tombol "Update" secara manual di tampilan statistik (lihat bagian berikutnya) untuk menyegarkan data.

  1. Anda dapat menentukan seberapa sering statistik diperbarui secara otomatis — dari setiap 1 jam hingga setiap 24 jam.

  2. Untuk menyimpan pengaturan Anda, jangan lupa mengeklik tombol "Save".

Tampilan statistik

Untuk melihat statistik, buka "Management" → "Mail", lalu klik ikon grafik di samping domain yang ingin Anda analisis.

Tampilan statistik dibagi menjadi tiga bagian utama, yang dijelaskan secara terperinci di bawah ini.

Grafik statistik

Menampilkan jumlah total pesan yang dikirim, terkirim, dan terpental selama periode waktu yang dipilih. Grafik membantu Anda mengidentifikasi tren dan masalah pengiriman secara sekilas.

Anda dapat menyesuaikan data yang ditampilkan dengan:

  1. Memilih domain email.

  2. Memilih statistik untuk seluruh domain atau kotak surat tertentu.

  3. Memilih rentang waktu untuk laporan — dari 24 jam terakhir hingga bulan terakhir.

  4. Mengeklik tombol "Update" untuk menyegarkan statistik secara manual dan mengambil data terbaru.

Alasan bounce teratas

Mencantumkan penyebab kegagalan pengiriman pesan yang paling sering terjadi, beserta kode kesalahan SMTP yang sesuai. Ini memungkinkan Anda memahami dan menangani masalah yang berulang.

Peristiwa kesalahan keluar

Menyediakan informasi terperinci tentang setiap pesan yang ditolak atau tidak terkirim, beserta tindakan yang direkomendasikan untuk menyelesaikan masalah.

Untuk setiap catatan, detail berikut ditampilkan:

  • Date/Time — waktu tepat saat upaya pengiriman terjadi

  • Queue ID — pengenal unik pesan dalam antrean email

  • From / From domain / To — alamat pengirim dan penerima, serta domain asal

  • SMTP code — kode respons yang dikembalikan oleh server email penerima (misalnya, 550-5.7.26)

  • Advice — penjelasan singkat tentang masalah dan tindakan yang direkomendasikan (misalnya, “Pesan ditolak oleh Gmail: autentikasi SPF/DKIM tidak ada atau gagal”)

  • Detail — teks respons SMTP lengkap, yang dapat menyertakan tautan ke dokumentasi eksternal dari server penerima (misalnya, halaman dukungan Gmail)

  • Unknown code — menunjukkan apakah respons SMTP tidak dapat diklasifikasikan

  • Bytes — ukuran pesan email

  • Retry count — jumlah upaya pengiriman yang dilakukan sebelum pesan ditolak secara permanen

  • Last try — cap waktu upaya pengiriman terakhir

  • Spam score — hasil evaluasi spam, jika berlaku

Data ini memberikan gambaran menyeluruh tentang masalah pengiriman keluar, membantu Anda mendiagnosis masalah autentikasi, reputasi, atau konfigurasi.

Statistik penggunaan disk

info

FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.

FASTPANEL® menyertakan fitur Statistik Penggunaan Disk yang memungkinkan Anda dengan cepat melihat file dan direktori mana yang menggunakan ruang di direktori pengguna situs web Anda.

Untuk menggunakan fitur ini, buka "Management" → "File Manager" dan klik ikon bulat di sudut kanan atas

Pada layar berikutnya, Anda akan melihat statistik penggunaan disk yang terperinci, termasuk Directories, Top large files, dan Extension statistics.

  1. Klik ikon folder di sudut kanan atas untuk kembali ke pengelola file.
  2. Klik ikon segarkan (panah melingkar) di sudut kanan atas untuk memuat ulang data.
  3. Klik nama pengguna di sudut kiri atas untuk beralih di antara direktori home pengguna yang berbeda; statistik akan diperbarui sesuai dengan itu.