CLI
Database
Di halaman ini
Mendapatkan daftar server database
Perintah
mogwai databases servers listContoh output
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServer IDs digunakan dalam perintah lain.
Mendapatkan daftar database
Perintah
mogwai databases listContoh 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 UTCMenyinkronkan 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 syncMembuat 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 dbpassword1Perintah ini akan membuat database bernama db1 di server database default (--server=1) dan "menautkannya" ke situs example.com.
Di halaman ini
Mendapatkan daftar domain email
Perintah
mogwai emails domains listContoh 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:00Domain IDs digunakan dalam perintah lain.
Menambahkan domain email
Perintah
mogwai emails domains createOpsi
--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 fastuserMendapatkan daftar kotak surat
Perintah
mogwai emails boxes listOpsi
--domain=DOMAIN: Nama domain email
Contoh perintah
mogwai emails boxes list --domain example.comContoh 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:00ID dari output perintah digunakan dalam perintah lain.
Membuat kotak surat
Perintah
mogwai emails boxes createOpsi
--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=MySecretPassword123Perintah ini akan membuat kotak surat bernama user@example.com dengan kata sandi MySecretPassword123.
Menghapus kotak surat
Perintah
mogwai emails boxes deleteOpsi
-b,--box=BOX: ID kotak surat..
Contoh perintah
mogwai emails boxes delete -b 1Perintah 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 modeimport- 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_ADDROpsi
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=enDEST_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.comTersedia dua mode:
Mode impor
mogwai emails boxes importDalam 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 --forceMode sinkronisasi
mogwai emails boxes syncDalam 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.txtDeskripsi
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 --helpUntuk mempelajari lebih lanjut tentang perintah tertentu, gunakan:
mogwai command --helpUntuk melihat daftar perintah beserta deskripsinya, gunakan:
mogwai --help-longPengguna
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 listContoh 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.comCatatan: 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.
- PHP:
--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.3Menghapus situs
Perintah
mogwai sites delete --id=IDSitus ID dapat diperoleh dari perintah mogwai sites list.
Contoh perintah
mogwai sites delete --id=987Perintah 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.
- PHP:
--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
--iddenganIDsmasing-masing.
Contoh perintah
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Perintah 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 2Perintah 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
-mdigunakan 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 subdirektorilogs/). 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.67Kemungkinan 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
-mtidak 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.
FASTPANEL