FASTPANELWIKI

CLI

Database

Di halaman ini

Mendapatkan daftar server database

Perintah

mogwai databases servers list

Contoh output

ID      NAME                    TYPE            LOCAL   HOST    USERNAME        AVAIL
1       mysql(localhost)        mysql           true            fastuser        true
2       postgresql(localhost)   postgresql      true            fastuser        true

Server IDs digunakan dalam perintah lain.

Mendapatkan daftar database

Perintah

mogwai databases list

Contoh output

ID      NAME            SERVER_NAME             LOCAL           HOST    CHARSET OWNER   SIZE    CREATE_AT                              
1       db1             mysql(localhost)        localhost       true    utf8mb4 user    0       2024-05-28 10:03:03.227413266 +0000 UTC
2       database43s     mysql(localhost)        localhost       true    utf8mb4 user82  0       2024-05-28 10:07:15.001640584 +0000 UTC

Menyinkronkan daftar database

Jika Anda baru saja menambahkan atau menghapus database, dan database tersebut belum muncul di FASTPANEL, Anda dapat memaksa sinkronisasi daftar

Perintah

mogwai databases sync

Membuat database baru

Perintah

mogwai databases create [flags]

Opsi

  • -n, --name=NAME : Nama database.
  • -o, --owner="fastuser" :  pengguna FASTPANEL tempat database akan ditambahkan.
  • -s, --site=SITE : Situs web di FASTPANEL tempat database akan ditambahkan.
  • -c, --charset="utf8mb4" : Pengodean database.
  • -u, --username=USERNAME : Nama pengguna database.
  • -p, --password=PASSWORD : Kata sandi pengguna database.

Contoh perintah

mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1

Perintah ini akan membuat database bernama db1 di server database default (--server=1) dan "menautkannya" ke situs example.com.

Email

Di halaman ini

Mendapatkan daftar domain email

Perintah

mogwai emails domains list

Contoh output

ID      NAME            FALLBACK        DKIM    ENABLED OWNER_ID        OWNER           CREATE_AT
1       example.com                     true    true    1               example_com_usr 2024-01-04 15:46:02+03:00

Domain IDs digunakan dalam perintah lain.

Menambahkan domain email

Perintah

mogwai emails domains create

Opsi

  • --domain=DOMAIN : Nama domain email.
  • -o, --owner="fastuser" : Pengguna FASTPANEL yang akan ditambahkan domain email.

Contoh pembuatan domain email example1.com di bawah pengguna fastuser

mogwai emails domains create --domain=example1.com -o fastuser

Mendapatkan daftar kotak surat

Perintah

mogwai emails boxes list

Opsi

  • --domain=DOMAIN : Nama domain email

Contoh perintah

mogwai emails boxes list --domain example.com

Contoh output

ID      ADDRESS                 ALIASES REDIRECTS       SIZE    QUOTA   ENABLED OWNER_ID        OWNER           CREATE_AT
1       user@example.com                                0       0       true    4               example_com_usr 2024-02-08 11:13:01+03:00

ID dari output perintah digunakan dalam perintah lain.

Membuat kotak surat

Perintah

mogwai emails boxes create

Opsi

  • --domain=DOMAIN : Nama domain email.
  • -l, --login=LOGIN : Nama kotak surat, tanpa domain.
  • -p, --password=PASSWORD : Kata sandi untuk kotak surat.

Contoh perintah

mogwai emails boxes create  --domain=example.com --login=user --password=MySecretPassword123

Perintah ini akan membuat kotak surat bernama user@example.com dengan kata sandi MySecretPassword123.

Menghapus kotak surat

Perintah

mogwai emails boxes delete

Opsi

  • -b, --box=BOX : ID kotak surat..

Contoh perintah

mogwai emails boxes delete -b 1

Perintah ini akan menghapus kotak surat dengan ID 1.

Mengimpor kotak surat dan email

Perintah

mogwai emails boxes import[sync] [<flags>]

Opsi

  • -i, --import_config=IMPORT_CONFIG : Jalur ke file daftar impor
  • --force : Hanya untuk mode import - hapus kotak surat yang sudah ada.

Untuk mengimpor email, Anda perlu menyiapkan daftar kotak surat di server dalam format:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opsi

  • IMAP_HOST : Alamat server email IMAP.
  • SOURCE_ADDR : Kotak surat di server sumber.
  • SOURCE_PASSWORD : Kata sandi untuk koneksi IMAP ke kotak surat di server sumber. Beberapa layanan, seperti Google, memerlukan pembuatan kata sandi aplikasi untuk akses IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Kotak surat di server FASTPANEL yang menjadi tujuan transfer pesan.

Contoh isi file

imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.com

Tersedia dua mode:

Mode impor

mogwai emails boxes import

Dalam mode ini, semua pesan disalin secara penuh, kotak surat di server FASTPANEL tidak boleh sudah dibuat atau harus kosong - saat perintah dijalankan, FASTPANEL membuat kotak surat yang diperlukan. Jika kotak surat yang sudah berisi konten telah ada, kesalahan akan ditampilkan. Anda dapat menggunakan flag --force - maka kotak surat akan dikosongkan.

Contoh menjalankan perintah dengan daftar kotak surat yang disimpan di file /root/import.txt dan menggunakan kunci --force

mogwai emails boxes import --import_config=/root/import.txt --force

Mode sinkronisasi

mogwai emails boxes sync

Dalam mode ini, Panel Kontrol mengunduh pesan dari server sumber tanpa menghapus apa pun. Mode ini harus digunakan jika pesan baru telah muncul di kotak surat asli setelah impor pertama, yang juga perlu ditransfer.

Contoh perintah

mogwai emails boxes sync --import_config=/root/import.txt

Deskripsi

Di halaman ini

FASTPANEL menyediakan antarmuka baris perintah (CLI) yang diimplementasikan melalui utilitas mogwai (/usr/local/bin/mogwai). Utilitas ini hanya akan berfungsi saat dijalankan sebagai root.

Bantuan

Untuk melihat daftar perintah yang tersedia, gunakan:

mogwai --help

Untuk mempelajari lebih lanjut tentang perintah tertentu, gunakan:

mogwai command --help

Untuk melihat daftar perintah beserta deskripsinya, gunakan:

mogwai --help-long

Pengguna

Di halaman ini

Membuat pengguna baru

Perintah

mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]

Opsi

  • -u, --username=USERNAME : Tentukan nama pengguna untuk pengguna baru.
  • -p, --password=PASSWORD : Tentukan kata sandi untuk pengguna baru.
  • -r, --role="USER" : Tentukan peran untuk pengguna baru. Peran yang didukung adalah RESELLER dan USER. Peran bawaan adalah USER.

Informasi penggunaan

Untuk membuat pengguna baru dengan nama pengguna testuser, kata sandi My$ecretPassword123, dan peran RESELLER, gunakan perintah berikut:

mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"

Catatan tambahan

  • Nama pengguna harus unik dan tidak boleh mengandung spasi atau titik.
  • Kata sandi harus terdiri dari setidaknya 8 karakter. Kami merekomendasikan penggunaan setidaknya satu huruf besar, satu huruf kecil, satu angka, dan satu karakter khusus.

Situs web

Di halaman ini

Mencantumkan situs di server

Perintah

mogwai sites list

Contoh output

ID      SERVER_NAME             ALIASES                         OWNER                   MODE    PHP_VERSION     IPS             DOCUMENT_ROOT
1       example.com             www.example.com                 example_com_usr         mpm_itk 82              127.0.0.1   /var/www/example_com_usr/data/www/example.com

Catatan: Situs IDs dari daftar ini digunakan dalam perintah lain.

Membuat situs baru

Perintah

mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]

Opsi

  • --owner : Pengguna pada sistem FASTPANEL yang akan memiliki situs.
  • --server-name=SERVER-NAME : Nama domain untuk situs.
  • -a, --alias=ALIAS : Alias untuk situs, seperti subdomain www. Beberapa alias dapat ditentukan.
  • --ip=IP : Alamat IP server tempat situs akan berjalan. Beberapa alamat IP dapat ditentukan.
  • -h, --handler=HANDLER : Handler backend. Dapat berupa:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versi PHP atau Node.js (mis. 8.2, 8.3, 20.15.1).
  • --create-user : Buat pengguna untuk situs.

Contoh perintah

mogwai sites create --server-name=example.com --owner=user --create-user --alias=www.example.com --ip=127.0.0.1 --handler=fcgi --handler_version=7.3

Menghapus situs

Perintah

mogwai sites delete --id=ID

Situs ID dapat diperoleh dari perintah mogwai sites list.

Contoh perintah

mogwai sites delete --id=987

Perintah ini akan menghapus situs dengan ID 987

Mengubah pengaturan situs

Perintah

mogwai sites update --id=ID [<flags>]

Situs ID dapat diperoleh dari perintah mogwai sites list.

Opsi

  • -i, --id=ID : ID situs.
  • -a, --add-alias=ADD-ALIAS : Tambahkan alias, beberapa alias dapat ditentukan.
  • --del-alias=DEL-ALIAS : Hapus alias, beberapa alias dapat ditentukan.
  • --add-ip=ADD-IP : Tambahkan alamat IP dari pengaturan situs, beberapa alamat IP dapat ditentukan.
  • --del-ip=DEL-IP : Hapus alamat IP dari pengaturan situs, beberapa alamat IP dapat ditentukan.
  • -h, --handler=HANDLER : Handler backend. Dapat berupa:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versi PHP atau Node.js (mis. 8.2, 8.3, 20.15.1).
  • --gzip : Aktifkan kompresi.
  • --no-gzip : Nonaktifkan kompresi.
  • --gzip-comp-level=LEVEL : Atur tingkat kompresi, 1-9.
  • --expires=EXPIRES : Atur waktu cache untuk konten statis.
  • --worker-count=WORKER-COUNT : Atur jumlah worker untuk PHP-FPM

Anda juga dapat memperbarui pengaturan untuk beberapa situs di server menggunakan perintah

mogwai sites batch-update
  • Untuk mengubah pengaturan untuk semua situs, gunakan flag -a.
  • Untuk mengubah pengaturan untuk situs yang dipilih, tentukan beberapa flag --id dengan IDs masing-masing.

Contoh perintah

mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6

Perintah ini akan menambahkan alias www1.example.com, mengubah handler menjadi cgi, dan mengubah Versi PHP menjadi 5.6 untuk situs dengan ID 3

Contoh perintah

mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2

Perintah ini akan mengubah handler PHP untuk situs dengan ID 2 dan 3

Mentransfer Pengguna Antar FASTPANEL

Di halaman ini

Pendahuluan

Artikel ini menjelaskan proses transfer akun pengguna dan data terkaitnya (situs web, basis data, email, dll.) dari satu server FASTPANEL ke server lainnya menggunakan utilitas migrasi bawaan.

Istilah Utama

  • Server sumber - Server asal data ditransfer.
  • Server tujuan - Server tempat data ditransfer.

Catatan Penting

  • Secara default, migrasi hanya berfungsi dengan benar untuk situs dengan konfigurasi FASTPANEL standar.

  • Situs dengan perubahan konfigurasi manual hanya dapat ditransfer jika flag -m digunakan untuk pemetaan alamat IP.

  • Jika kata sandi terenkripsi untuk pemilik basis data tidak tersedia, basis data tidak akan ditransfer.

  • Jika sebuah situs web tidak ditransfer, basis data terkaitnya juga tidak akan ditransfer.

  • Hanya basis data lokal yang dapat ditransfer.

Proses Migrasi

Koneksi

Server tujuan terhubung ke server sumber melalui SSH. Saat koneksi pertama, server tujuan memasang kunci SSH di server sumber (baik yang telah disediakan sebelumnya atau yang dibuat dari kata sandi).

Langkah Migrasi

  • Instalasi modul
  • Mengumpulkan informasi tentang objek yang dapat ditransfer
  • Membuat pengguna
  • Mentransfer sertifikat SSL
  • Membuat situs web, akun FTP, domain email, dan akun email
  • Membuat basis data dan pengguna basis data
  • Mentransfer file situs web dan kotak surat email
  • Mentransfer tugas cron

Transfer file dijalankan menggunakan rsync. Basis data ditransfer dengan membuat dump melalui tunnel SSH.

Perintah untuk Memulai Migrasi

Perintah dijalankan di server tujuan sebagai pengguna dengan hak akses root:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Flag Baris Perintah

Koneksi SSH

  • --remote_host="SOURCE_IP" - Alamat IP server sumber.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Pengguna (harus root).
  • --remote_password="USER_PASSWORD" - Kata sandi untuk pengguna SSH yang ditentukan.
  • --ssh_key_path="PATH_TO_KEY" - Jalur ke kunci SSH privat di server tujuan untuk terhubung ke server sumber. Jika kunci digunakan, kata sandi (--remote_password) tidak diperlukan.

Alamat IP

Anda harus menggunakan hanya satu dari flag berikut untuk mengelola alamat IP situs selama transfer. Flag -m memiliki prioritas.

  • -i "IP_ADDRESS_ON_DESTINATION" - Menetapkan alamat IP yang ditentukan ke semua situs yang ditransfer di server tujuan. Untuk menentukan beberapa IP (misalnya, jika ada beberapa di sumber), ulangi flag untuk setiap IP sumber yang perlu ditransfer.

  • -m "SOURCE_IP,DESTINATION_IP" - Metode yang direkomendasikan. Membuat pemetaan langsung: semua situs yang menggunakan SOURCE_IP di server sumber akan menggunakan DESTINATION_IP di server tujuan. Flag ini dapat ditentukan beberapa kali untuk pasangan IP yang berbeda. Wajib untuk mentransfer situs dengan pengeditan konfigurasi manual, karena memungkinkan penggantian alamat IP yang benar dalam directive listen.

Pengaturan Tambahan

  • --users="USER_LIST" - Hanya mentransfer pengguna yang ditentukan (dipisahkan dengan koma). Jika tidak ditentukan, semua pengguna akan ditransfer.
  • --disable_disk_quota - Menonaktifkan transfer kuota disk pengguna.
  • --with_user_data - Termasuk penyalinan seluruh isi direktori home pengguna (kecuali subdirektori logs/). Gunakan dengan hati-hati, karena ini dapat meningkatkan waktu transfer dan jumlah data yang ditransfer secara signifikan.
  • --only_data - Hanya mentransfer data (file situs web, file email, dump basis data). Berguna jika migrasi struktur awal (pengguna, situs, DB, dll.) berhasil, tetapi terjadi kesalahan selama tahap penyalinan file atau dump. Memungkinkan untuk menjalankan ulang hanya bagian penyalinan data.
  • --transfer_timeout - Menetapkan batas waktu operasi (default adalah 60 menit).

Contoh Perintah

Transfer semua pengguna dari server 11.22.33.44 ke server saat ini. Di server lama, situs menggunakan IP 11.22.33.44 dan 11.22.33.55; di server baru, masing-masing harus menggunakan 99.88.77.66 dan 99.88.77.67. Koneksi melalui SSH dengan kata sandi.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Kemungkinan Masalah dan Jenis Kesalahan

Kesalahan dalam log migrasi tidak selalu menunjukkan masalah kritis, tetapi dapat mengarah pada alasan mengapa objek tertentu tidak ditransfer.

  • Konflik: Terjadi ketika transfer suatu objek tidak mungkin dilakukan karena konfigurasi server tujuan saat ini (misalnya, pengguna atau situs dengan nama yang sama sudah ada) atau jika konfigurasi situs di server sumber tidak dikenali oleh panel (misalnya, karena pengeditan manual yang ekstensif).

  • Kata Sandi Tersimpan Hilang: Seperti disebutkan sebelumnya, pengguna basis data MySQL tanpa kata sandi yang tersimpan di FASTPANEL pada server sumber tidak dapat ditransfer.

  • Pengaturan Manual dan Alamat IP: Jika sebuah situs di server sumber memiliki pengeditan konfigurasi server web manual dan flag -m tidak digunakan selama migrasi untuk memetakan alamat IP-nya, situs tersebut tidak akan ditransfer karena panel tidak mengetahui IP mana yang harus ditentukan dalam konfigurasi di server tujuan.