Fitur Extended
- Branding
- Instal Aplikasi Node.js
- Notifikasi server
- FASTPANEL Extended
- Prometheus
- Statistik email
- Statistik penggunaan disk
Kustomisasi Branding
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
Kustomisasi Logo
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
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 installdi 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.jsdi 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
pagesdan di dalamnya, tambahkan file bernamaindex.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
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
- Buat bot baru menggunakan bot resmi Telegram @BotFather. Ikuti tautan dan klik tombol "Start"
- Ketik
/newbotdan tekan Enter. - Masukkan nama yang diinginkan untuk bot Anda dan tekan Enter.
- Masukkan username yang diinginkan untuk bot Anda. Harus diakhiri dengan
bot, lalu tekan Enter. - Anda akan menerima pesan yang dimulai dengan:
Done! Congratulations on your new bot. - 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
Token API disimpan di @BotFather. Jika Anda lupa, kirim perintah /mybots, pilih bot Anda, lalu klik tombol "API Token".
- Buka FASTPANEL® dan buka "Settings" → "Notifications".
- Klik tombol "Create channel"
- 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
- Klik tombol "Save".
- Pada layar berikutnya, klik tombol "Invite" untuk mengundang bot Anda ke obrolan atau obrolan grup
- Tautan akan terbuka di tab baru. Konfirmasikan pengalihan ke aplikasi Telegram Desktop
- Klik tombol "Start" untuk mengaktifkan bot Anda
- Untuk memverifikasi bahwa penyiapan sudah benar, kembali ke tab FASTPANEL® dan klik tombol pesawat kertas
- Jika semuanya dikonfigurasi dengan benar, notifikasi uji akan dikirim ke obrolan dengan bot Anda
- Untuk menyesuaikan pengaturan saluran nanti, klik ikon pensil di sebelah saluran
- Di bawah ini adalah contoh notifikasi yang dihasilkan ketika trigger diaktifkan
Slack
- Masuk ke akun Anda dan buat aplikasi Slack melalui halaman aplikasi.
- Pilih "From scratch".
- Masukkan App Name, pilih workspace tempat aplikasi akan dibuat, lalu klik “Create app”.
- Di bagian “Features”, buka “Incoming Webhooks” dan aktifkan fitur tersebut
- Di bagian bawah halaman yang sama, klik “Add New Webhook”
- Pada layar berikutnya, pilih saluran tempat notifikasi akan dikirim. Disarankan untuk membuat saluran khusus untuk peringatan. Lalu klik “Allow”.
- Anda akan diarahkan kembali ke halaman webhooks. Gulir ke bawah dan klik “Copy” untuk menyalin URL webhook
- Buka FASTPANEL® dan buka "Settings" → "Notifications".
- Klik tombol "Create channel"
- 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
- Klik tombol "Save".
- Untuk memverifikasi bahwa penyiapan sudah benar, klik tombol pesawat kertas
- Jika semuanya dikonfigurasi dengan benar, notifikasi uji akan dikirim ke saluran yang dipilih pada langkah 6
- Untuk menyesuaikan pengaturan saluran nanti, klik ikon pensil di sebelah saluran
- 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:
- Nonaktifkan trigger yang tidak diperlukan menggunakan toggle di sebelah kiri.
- 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.
- Edit trigger yang ada
Ambang batas untuk CPU, Disk, dan RAM diatur dalam persentase. Ambang batas untuk Load Average 5 diatur dalam nilai integer.
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
FASTPANEL Extended aktif secara default untuk semua pengguna. Anda tidak perlu mengaktifkan lisensi.
Prometheus
Di halaman ini
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:
-
Hubungkan ke server FASTPANEL® Anda melalui SSH.
-
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
$IPdengan 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
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
- 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.
-
Anda dapat menentukan seberapa sering statistik diperbarui secara otomatis — dari setiap 1 jam hingga setiap 24 jam.
-
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:
-
Memilih domain email.
-
Memilih statistik untuk seluruh domain atau kotak surat tertentu.
-
Memilih rentang waktu untuk laporan — dari 24 jam terakhir hingga bulan terakhir.
-
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
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.
- Klik ikon folder di sudut kanan atas untuk kembali ke pengelola file.
- Klik ikon segarkan (panah melingkar) di sudut kanan atas untuk memuat ulang data.
- Klik nama pengguna di sudut kiri atas untuk beralih di antara direktori home pengguna yang berbeda; statistik akan diperbarui sesuai dengan itu.
FASTPANEL