FASTPANELWIKI

CLI

Chuyển người dùng giữa các FASTPANEL

Trên trang này

Giới thiệu

Bài viết này mô tả quy trình chuyển các tài khoản người dùng và dữ liệu liên quan của chúng (website, cơ sở dữ liệu, email, v.v.) từ một máy chủ FASTPANEL sang máy chủ khác bằng tiện ích di chuyển tích hợp sẵn.

Các thuật ngữ chính

  • Máy chủ nguồn - Máy chủ mà từ đó dữ liệu đang được chuyển đi.
  • Máy chủ đích - Máy chủ mà dữ liệu đang được chuyển đến.

Lưu ý quan trọng

  • Theo mặc định, việc di chuyển chỉ hoạt động chính xác đối với các website có cấu hình FASTPANEL tiêu chuẩn.

  • Các website có thay đổi cấu hình thủ công chỉ có thể được chuyển nếu sử dụng cờ -m để ánh xạ địa chỉ IP.

  • Nếu không có sẵn mật khẩu được mã hóa của chủ sở hữu cơ sở dữ liệu, cơ sở dữ liệu sẽ không được chuyển.

  • Nếu một website không được chuyển, các cơ sở dữ liệu liên kết với nó cũng sẽ không được chuyển.

  • Chỉ có thể chuyển các cơ sở dữ liệu cục bộ.

Quy trình di chuyển

Kết nối

Máy chủ đích kết nối tới máy chủ nguồn qua SSH. Trong lần kết nối đầu tiên, máy chủ đích cài đặt một khóa SSH trên máy chủ nguồn (được cung cấp trước hoặc được tạo từ mật khẩu).

Các bước di chuyển

  • Cài đặt mô-đun
  • Thu thập thông tin về các đối tượng có thể chuyển
  • Tạo người dùng
  • Chuyển chứng chỉ SSL
  • Tạo website, tài khoản FTP, miền email và tài khoản email
  • Tạo cơ sở dữ liệu và người dùng cơ sở dữ liệu
  • Chuyển các tệp website và hộp thư email
  • Chuyển các cron job

Việc chuyển tệp được thực hiện bằng rsync. Các cơ sở dữ liệu được chuyển bằng cách tạo dump thông qua đường hầm SSH.

Lệnh để bắt đầu di chuyển

Lệnh được chạy trên máy chủ đích bởi người dùng có quyền root:

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

Các cờ dòng lệnh

Kết nối SSH

  • --remote_host="SOURCE_IP" - Địa chỉ IP của máy chủ nguồn.
  • --remote_port="SSH_PORT" - Cổng SSH.
  • --remote_username="SSH_USER" - Người dùng (phải là root).
  • --remote_password="USER_PASSWORD" - Mật khẩu cho người dùng SSH đã chỉ định.
  • --ssh_key_path="PATH_TO_KEY" - Đường dẫn đến khóa SSH riêng tư trên máy chủ đích để kết nối tới máy chủ nguồn. Nếu sử dụng khóa, thì không cần mật khẩu (--remote_password).

Địa chỉ IP

Bạn chỉ được sử dụng một trong các cờ sau để quản lý địa chỉ IP của website trong quá trình chuyển. Cờ -m có độ ưu tiên cao hơn.

  • -i "IP_ADDRESS_ON_DESTINATION" - Gán địa chỉ IP đã chỉ định cho tất cả website được chuyển trên máy chủ đích. Để chỉ định nhiều IP (ví dụ: nếu có nhiều IP trên máy chủ nguồn), hãy lặp lại cờ cho từng IP nguồn cần được chuyển.

  • -m "SOURCE_IP,DESTINATION_IP" - Phương thức được khuyến nghị. Thiết lập ánh xạ trực tiếp: tất cả website sử dụng SOURCE_IP trên máy chủ nguồn sẽ sử dụng DESTINATION_IP trên máy chủ đích. Cờ này có thể được chỉ định nhiều lần cho các cặp IP khác nhau. Bắt buộc khi chuyển các website có chỉnh sửa cấu hình thủ công, vì nó cho phép thay thế chính xác các địa chỉ IP trong các chỉ thị listen.

Cài đặt bổ sung

  • --users="USER_LIST" - Chỉ chuyển những người dùng được chỉ định (phân tách bằng dấu phẩy). Nếu không được chỉ định, tất cả người dùng sẽ được chuyển.
  • --disable_disk_quota - Tắt việc chuyển hạn ngạch đĩa của người dùng.
  • --with_user_data - Bao gồm việc sao chép toàn bộ nội dung các thư mục home của người dùng (ngoại trừ thư mục con logs/). Hãy sử dụng cẩn thận, vì điều này có thể làm tăng đáng kể thời gian chuyển và lượng dữ liệu được chuyển.
  • --only_data - Chỉ chuyển dữ liệu (tệp website, tệp thư, dump cơ sở dữ liệu). Hữu ích nếu quá trình di chuyển cấu trúc ban đầu (người dùng, website, CSDL, v.v.) đã thành công, nhưng đã xảy ra lỗi trong giai đoạn sao chép tệp hoặc dump. Cho phép chỉ chạy lại phần sao chép dữ liệu.
  • --transfer_timeout - Đặt thời gian chờ thao tác (mặc định là 60 phút).

Lệnh ví dụ

Chuyển tất cả người dùng từ máy chủ 11.22.33.44 sang máy chủ hiện tại. Trên máy chủ cũ, các website sử dụng IP 11.22.33.44 và 11.22.33.55; trên máy chủ mới, tương ứng chúng phải sử dụng 99.88.77.66 và 99.88.77.67. Kết nối qua SSH bằng mật khẩu.

/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

Các vấn đề có thể xảy ra và các loại lỗi

Lỗi trong nhật ký di chuyển không phải lúc nào cũng cho thấy một vấn đề nghiêm trọng, nhưng có thể chỉ ra lý do vì sao một đối tượng cụ thể không được chuyển.

  • Xung đột: Xảy ra khi không thể chuyển một đối tượng do cấu hình hiện tại của máy chủ đích (ví dụ: người dùng hoặc website có cùng tên đã tồn tại) hoặc nếu cấu hình website trên máy chủ nguồn không được panel nhận biết (ví dụ: do chỉnh sửa thủ công quá nhiều).

  • Thiếu mật khẩu đã lưu: Như đã đề cập trước đó, người dùng cơ sở dữ liệu MySQL không có mật khẩu được lưu trong FASTPANEL trên máy chủ nguồn thì không thể được chuyển.

  • Cài đặt thủ công và địa chỉ IP: Nếu một website trên máy chủ nguồn có các chỉnh sửa cấu hình máy chủ web thủ công và cờ -m không được sử dụng trong quá trình di chuyển để ánh xạ địa chỉ IP của nó, website như vậy sẽ không được chuyển vì panel không biết cần chỉ định IP nào trong cấu hình trên máy chủ đích.

Cơ sở dữ liệu

Trên trang này

Lấy danh sách máy chủ cơ sở dữ liệu

Lệnh

mogwai databases servers list

Ví dụ đầu ra

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

Máy chủ IDs được sử dụng trong các lệnh khác.

Lấy danh sách cơ sở dữ liệu

Lệnh

mogwai databases list

Ví dụ đầu ra

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

Đồng bộ hóa danh sách cơ sở dữ liệu

Nếu gần đây bạn đã thêm hoặc xóa cơ sở dữ liệu và chúng vẫn chưa xuất hiện trong FASTPANEL, bạn có thể buộc đồng bộ hóa các danh sách

Lệnh

mogwai databases sync

Tạo cơ sở dữ liệu mới

Lệnh

mogwai databases create [flags]

Tùy chọn

  • -n, --name=NAME : Tên cơ sở dữ liệu.
  • -o, --owner="fastuser" :  người dùng FASTPANEL mà cơ sở dữ liệu sẽ được thêm vào.
  • -s, --site=SITE : Trang web trong FASTPANEL mà cơ sở dữ liệu sẽ được thêm vào.
  • -c, --charset="utf8mb4" : Mã hóa cơ sở dữ liệu.
  • -u, --username=USERNAME : Tên người dùng cơ sở dữ liệu.
  • -p, --password=PASSWORD : Mật khẩu người dùng cơ sở dữ liệu.

Ví dụ lệnh

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

Lệnh này sẽ tạo một cơ sở dữ liệu có tên db1 trên máy chủ cơ sở dữ liệu mặc định (--server=1) và "liên kết" nó với trang example.com.

Email

Trên trang này

Lấy danh sách miền email

Lệnh

mogwai emails domains list

Ví dụ đầu ra

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

Miền IDs được sử dụng trong các lệnh khác.

Thêm miền email

Lệnh

mogwai emails domains create

Tùy chọn

  • --domain=DOMAIN : Tên miền email.
  • -o, --owner="fastuser" : Người dùng FASTPANEL mà miền email sẽ được thêm vào.

Ví dụ tạo miền email example1.com cho người dùng fastuser

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

Lấy danh sách hộp thư

Lệnh

mogwai emails boxes list

Tùy chọn

  • --domain=DOMAIN : Tên miền thư

Lệnh ví dụ

mogwai emails boxes list --domain example.com

Ví dụ đầu ra

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 từ đầu ra của lệnh được sử dụng trong các lệnh khác.

Tạo hộp thư

Lệnh

mogwai emails boxes create

Tùy chọn

  • --domain=DOMAIN : Tên miền email.
  • -l, --login=LOGIN : Tên của hộp thư, không bao gồm miền.
  • -p, --password=PASSWORD : Mật khẩu cho hộp thư.

Lệnh ví dụ

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

Lệnh này sẽ tạo một hộp thư có tên user@example.com với mật khẩu MySecretPassword123.

Xóa hộp thư

Lệnh

mogwai emails boxes delete

Tùy chọn

  • -b, --box=BOX : ID của hộp thư..

Lệnh ví dụ

mogwai emails boxes delete -b 1

Lệnh này sẽ xóa hộp thư có ID là 1.

Nhập hộp thư và email

Lệnh

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

Tùy chọn

  • -i, --import_config=IMPORT_CONFIG : Đường dẫn đến tệp danh sách nhập
  • --force : Chỉ dành cho chế độ import - xóa các hộp thư hiện có.

Để nhập thư, bạn cần chuẩn bị một danh sách các hộp thư trên máy chủ theo định dạng:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Tùy chọn

  • IMAP_HOST : Địa chỉ của máy chủ thư IMAP.
  • SOURCE_ADDR : Hộp thư trên máy chủ nguồn.
  • SOURCE_PASSWORD : Mật khẩu cho kết nối IMAP tới hộp thư trên máy chủ nguồn. Một số dịch vụ, chẳng hạn như Google, yêu cầu tạo mật khẩu ứng dụng để truy cập IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Hộp thư trên máy chủ FASTPANEL mà thư sẽ được chuyển tới.

Ví dụ nội dung tệp

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

Có hai chế độ khả dụng:

Chế độ nhập

mogwai emails boxes import

Trong chế độ này, tất cả thư được sao chép đầy đủ, các hộp thư trên máy chủ FASTPANEL không được tồn tại hoặc phải trống - khi lệnh được thực thi, FASTPANEL sẽ tạo các hộp thư cần thiết. Nếu các hộp thư đã có nội dung tồn tại, một lỗi sẽ được hiển thị. Bạn có thể sử dụng cờ --force - khi đó hộp thư sẽ được xóa sạch.

Ví dụ chạy lệnh với danh sách hộp thư được lưu trong tệp /root/import.txt và sử dụng khóa --force

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

Chế độ đồng bộ

mogwai emails boxes sync

Trong chế độ này, Bảng điều khiển tải thư từ máy chủ nguồn xuống mà không xóa bất kỳ thứ gì. Nên sử dụng chế độ này nếu các thư mới đã xuất hiện trong hộp thư gốc sau lần nhập đầu tiên và cũng cần được chuyển đi.

Lệnh ví dụ

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

Mô tả

Trên trang này

FASTPANEL cung cấp giao diện dòng lệnh (CLI) được triển khai thông qua tiện ích mogwai (/usr/local/bin/mogwai). Tiện ích này chỉ hoạt động khi được chạy dưới dạng root.

Trợ giúp

Để xem danh sách các lệnh khả dụng, hãy dùng:

mogwai --help

Để tìm hiểu thêm về một lệnh cụ thể, hãy dùng:

mogwai command --help

Để xem danh sách các lệnh kèm mô tả, hãy dùng:

mogwai --help-long

Người dùng

Trên trang này

Tạo người dùng mới

Lệnh

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

Tùy chọn

  • -u, --username=USERNAME : Chỉ định tên người dùng cho người dùng mới.
  • -p, --password=PASSWORD : Chỉ định mật khẩu cho người dùng mới.
  • -r, --role="USER" : Chỉ định vai trò cho người dùng mới. Các vai trò được hỗ trợ là RESELLER và USER. Vai trò mặc định là USER.

Thông tin sử dụng

Để tạo một người dùng mới với tên người dùng testuser, mật khẩu My$ecretPassword123 và vai trò RESELLER, hãy sử dụng lệnh sau:

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

Ghi chú bổ sung

  • Tên người dùng phải là duy nhất và không được chứa dấu cách hoặc dấu chấm.
  • Mật khẩu phải có ít nhất 8 ký tự. Chúng tôi khuyến nghị sử dụng ít nhất một chữ cái viết hoa, một chữ cái viết thường, một chữ số và một ký tự đặc biệt.

Trang web

Trên trang này

Liệt kê các site trên máy chủ

Lệnh

mogwai sites list

Ví dụ đầu ra

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

Lưu ý: Các site IDs từ danh sách này được sử dụng trong các lệnh khác.

Tạo site mới

Lệnh

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

Tùy chọn

  • --owner : Người dùng trên hệ thống FASTPANEL sẽ sở hữu site này.
  • --server-name=SERVER-NAME : Tên miền của site.
  • -a, --alias=ALIAS : Bí danh cho site, chẳng hạn như các tên miền phụ www. Có thể chỉ định nhiều bí danh.
  • --ip=IP : Địa chỉ IP của máy chủ nơi site sẽ chạy. Có thể chỉ định nhiều địa chỉ IP.
  • -h, --handler=HANDLER : Trình xử lý backend. Có thể là:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Phiên bản PHP hoặc Node.js (ví dụ: 8.2, 8.3, 20.15.1).
  • --create-user : Tạo người dùng cho site.

Ví dụ lệnh

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

Xóa site

Lệnh

mogwai sites delete --id=ID

Có thể lấy site ID từ lệnh mogwai sites list.

Ví dụ lệnh

mogwai sites delete --id=987

Lệnh này sẽ xóa site có ID 987

Sửa đổi cài đặt site

Lệnh

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

Có thể lấy site ID từ lệnh mogwai sites list.

Tùy chọn

  • -i, --id=ID : ID của site.
  • -a, --add-alias=ADD-ALIAS : Thêm bí danh, có thể chỉ định nhiều bí danh.
  • --del-alias=DEL-ALIAS : Xóa bí danh, có thể chỉ định nhiều bí danh.
  • --add-ip=ADD-IP : Thêm địa chỉ IP từ cài đặt site, có thể chỉ định nhiều địa chỉ IP.
  • --del-ip=DEL-IP : Xóa địa chỉ IP khỏi cài đặt site, có thể chỉ định nhiều địa chỉ IP.
  • -h, --handler=HANDLER : Trình xử lý backend. Có thể là:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Phiên bản PHP hoặc Node.js (ví dụ: 8.2, 8.3, 20.15.1).
  • --gzip : Bật nén.
  • --no-gzip : Tắt nén.
  • --gzip-comp-level=LEVEL : Đặt mức nén, 1-9.
  • --expires=EXPIRES : Đặt thời gian lưu bộ nhớ đệm cho nội dung tĩnh.
  • --worker-count=WORKER-COUNT : Đặt số lượng worker cho PHP-FPM

Bạn cũng có thể cập nhật cài đặt cho nhiều site trên máy chủ bằng lệnh

mogwai sites batch-update
  • Để thay đổi cài đặt cho tất cả site, hãy sử dụng cờ -a.
  • Để thay đổi cài đặt cho các site đã chọn, hãy chỉ định nhiều cờ --id cùng với IDs của chúng.

Ví dụ lệnh

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

Lệnh này sẽ thêm bí danh www1.example.com, thay đổi handler thành cgi và đổi Phiên bản PHP thành 5.6 cho site có ID 3

Ví dụ lệnh

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

Lệnh này sẽ thay đổi trình xử lý PHP cho các site có ID 2 và 3