Hướng Dẫn Sửa Lỗi FASTPANEL Không Khởi Động Sau Khi Tự Update

Đây là hướng dẫn sửa lỗi cho ubuntu 20.04, nếu bạn sử dụng phiên bản khác, vui lòng sửa file ubu20.yml thành phiên bản của bạn, ví dụ như ubuntu 22.04 thì file sẽ là ubu22.yml

1. Hiện tượng lỗi

Khi kiểm tra log:

journalctl -u fastpanel2 -n 50 --no-pager

Xuất hiện lỗi:

ERROR: Unable to load './config/modules' config:
Cannot parse 'config/modules/ubu20.yml' file:
yaml: unmarshal errors:

line 723: cannot unmarshal !!str `24.6.0` into int
line 729: cannot unmarshal !!str `23.11.1` into int
...

Service liên tục restart:

fastpanel2.service: Scheduled restart job, restart counter is at 129316

FASTPANEL không thể khởi động.

2. Nguyên nhân

FASTPANEL tự động cập nhật lên phiên bản mới.

Trong file:

/usr/local/fastpanel2/config/modules/ubu20.yml

Các version NodeJS được khai báo dạng chuỗi, ví dụ:

24.6.0
23.11.1
22.18.0

Trong khi phiên bản FASTPANEL mới yêu cầu kiểu dữ liệu integer (major version), ví dụ:

24
23
22

Do sai kiểu dữ liệu nên YAML không parse được, dẫn tới service không khởi động.

Ngoài ra còn thiếu cột site_id trong database SQLite sau update.

3. Cách Fix Chi Tiết

Bước 1: Backup file cấu hình

cp /usr/local/fastpanel2/config/modules/ubu20.yml \
   /usr/local/fastpanel2/config/modules/ubu20.yml.bak

Bước 2: Chuyển version NodeJS từ x.y.z về x

Sửa các dòng dạng:

nodejs 24.6.0:

Thành:

nodejs 24:

Chạy lệnh:

sed -i -E 's/nodejs ([0-9]+)\.[0-9]+\.[0-9]+:/nodejs \1:/g' \
/usr/local/fastpanel2/config/modules/ubu20.yml

Bước 3: Sửa format version trong YAML

Chuyển:

version: '24.6.0'

Thành:

version: 24

Chạy:

sed -i -E "s/version: '([0-9]+)\.[0-9]+\.[0-9]+'/version: \1/g" \
/usr/local/fastpanel2/config/modules/ubu20.yml

Bước 4: Restart FASTPANEL

systemctl restart fastpanel2

Nếu vẫn chưa lên, tiếp tục bước sửa database.

Bước 5: Backup database FASTPANEL

cp /usr/local/fastpanel2/app/db/fastpanel2.db \
   /usr/local/fastpanel2/app/db/fastpanel2.db.backup

Bước 6: Thêm cột thiếu trong SQLite

Mở database:

sqlite3 /usr/local/fastpanel2/app/db/fastpanel2.db

Thêm cột:

ALTER TABLE site_upstream_target ADD COLUMN site_id INTEGER;

Thoát:

.exit

Bước 7: Restart lại service

systemctl restart fastpanel2

Kiểm tra trạng thái:

systemctl status fastpanel2 --no-pager

Nếu hiển thị:

Active: active (running)

Là đã fix thành công.

4. Kết quả sau khi sửa

Service chạy bình thường:

Active: active (running)
Main PID: xxxx (fastpanel)

FASTPANEL truy cập lại được bình thường.

5. Khuyến nghị

• Tắt auto update FASTPANEL nếu có thể.
• Hoặc kiểm soát update các module trong thư mục:

  /usr/local/fastpanel2/config/modules/

• Nên backup định kỳ:
  • Thư mục /usr/local/fastpanel2
  • Database /usr/local/fastpanel2/app/db/fastpanel2.db

Bài viết Hướng Dẫn Sửa Lỗi FASTPANEL Không Khởi Động Sau Khi Tự Update đã xuất hiện đầu tiên vào ngày Hướng dẫn TENTEN.

I. FastPanel là gì?

FastPanel là một web control panel miễn phí rất tốt ở thời điểm hiện tại. Với rất nhiều tính năng như:

• Tạo website chỉ với vài cú nhấp chuột.
• Quản lý email.
• Quản lý cơ sở dữ liệu.
• Quản lý sao lưu/khôi phục lên đám mây.
• Phân tích lưu lượng truy cập website.
• Tạo người dùng.
• Có hỗ trợ xác thực hai yếu tố.
• Hỗ trợ SSL.
• Hỗ trợ tường lửa.
• Hỗ trợ cron.
• Hỗ trợ nhiều phiên bản PHP.
• Tích hợp quét mã độc AI-BOLIT.
• Tích hợp Spam Asasin.
• Hỗ trợ thao tác lệnh mà không cần SSH thông qua giao diện điều khiển.
• Và còn rất nhiều tính năng khác, mình sẽ đề cập trong các bài viết khác

II. Hướng dẫn cài đặt nhiều phiên bản PHP trên FastPanel

Để cài đặt nhiều phiên bản PHP trên FastPanel chúng ta thực hiện ba bước sau.

Bước 1: Truy cập vào trang quản trị FastPanel

Để truy cập vào giao diện FasPanel chúng ta truy cập vào đường dẫn có dạng https://IP:8888 trên trình duyệt. Thay IP thành IP VPS hoặc máy chủ FasPanel của bạn.

Dưới đây là giao diện FasPanel của mình.

Bước 2: Thao tác cài đặt nhiều phiên bản PHP trên FastPanel

Sau khi đã truy cập vào giao diện FASTPANEL chúng ta thực hiện theo thứ tự hình ảnh bên dưới:

• Khu vực tìm kiếm ứng dụng (4).
• Danh sách phiên bản PHP hỗ trợ có thể cài đặt (5).
• Khu vực Action(hành động) các bạn có thể cài đặt hoặc gỡ cài đặt ứng dụng (6).

Mình sẽ chọn cài đặt phiên bản PHP 8.0. Sau khi nhấp vào nút cài đặt bạn sẽ nhận được thông báo quá trình cài đặt như hình bên dưới.

Chờ khoảng vài phút để tiến trình cài đặt diễn ra, thời gian cài đặt nhanh hay chậm sẽ tùy thuộc vào sức mạnh VPS/Server và băng thông.

Bước 3: Lựa chọn phiên bản PHP mới vừa cài đặt

Thử thêm một website mới đến bước lựa chọn PHP chúng ta cần chọn PHP mode khác với Apache module là có thể lựa chọn phiên bản PHP mới.

Để thay đổi PHP cho website đang hoạt động có thể truy cập Control Panel -> Domain -> Settings -> PHP settings và chọn phiên bản PHP cần thay đổi.

Bài viết Hướng dẫn cài đặt nhiều phiên bản PHP trên FastPanel đã xuất hiện đầu tiên vào ngày Hướng dẫn TENTEN.

I. FastPanel là gì?

FastPanel là một web control panel miễn phí rất tốt ở thời điểm hiện tại. Với rất nhiều tính năng như:

• Tạo website chỉ với vài cú nhấp chuột.
• Quản lý email.
• Quản lý cơ sở dữ liệu.
• Quản lý sao lưu/khôi phục lên đám mây.
• Phân tích lưu lượng truy cập website.
• Tạo người dùng.
• Có hỗ trợ xác thực hai yếu tố.
• Hỗ trợ SSL.
• Hỗ trợ tường lửa.
• Hỗ trợ cron.
• Hỗ trợ nhiều phiên bản PHP.
• Tích hợp quét mã độc AI-BOLIT.
• Tích hợp Spam Asasin.
• Hỗ trợ thao tác lệnh mà không cần SSH thông qua giao diện điều khiển.
• Và còn rất nhiều tính năng khác, mình sẽ đề cập trong các bài viết khác.

II. Tạo website trên FastPanel

Bước 1: Truy cập FastPanel

Để truy cập vào giao diện FastPanel chúng ta truy cập vào đường dẫn có dạng https://IP:8888 trên trình duyệt. Thay IP thành IP VPS hoặc máy chủ FastPanel của bạn.

Dưới đây là giao diện FastPanel của mình. Cũng như cách để thêm 1 website mới.

Bước 2: Khởi tạo website

Chúng ta chọn dấu + màu xanh ở góc phải để thêm website mới.

Sau khi chọn vào nút thêm website chúng ta bắt đầu điền tên miền và bấm Next.

Ở bước Configuration chúng ta sẽ cấu hình phiên bản PHP, PHP mode và thông tin database sẽ tạo. Nếu bạn nào chưa có phiên bản PHP mới thì nên tham khảo bài hướng dẫn sau.

Các bạn nhớ nút hỗ trợ PHP phải luôn luôn bật, nếu không bật thì bạn đưa mã nguồn lên nó sẽ không chạy được.

Ở đây mình chọn PHP mode là PHP-FPM và chọn PHP versions là php7.4 vì trước đó mình có cài phiên bản php này rồi. Chọn Save để lưu lại và tiến hành cấu hình thông tin database.

Ở đây bạn có thể thấy hệ thống tự động tạo thông tin như:

• Tên Database
• Người dùng có quyền truy cập Database đó.
• Mật khẩu người dùng có quyền truy cập Database đó.

Ở bước 3 Backups chúng ta sẽ chưa cấu hình backup và có thể cấu hình thiết đặt sau chức năng này. Tiếp tục chọn Next để bỏ qua bước 3.

Tại bước cuối cùng này mọi thông tin cài đặt, cấu hình sẽ được hiển thị để bạn có thể lưu lại. Ngoài ra bạn còn có cả thông tin người dùng được tạo ra để quản trị cho riêng website này.

Tại bước này chúng ta sẽ có rất nhiều thông tin như thông tin database được tạo (1), thông tin FTP (2), thông tin quản trị gói hosting website này (3). Nhưng cái nút chúng ta cần nhất ở đây là cài đặt WordPress (4). Nhấp vào nút này và chọn thông tin quản trị admin website WordPress như hình bên dưới và chọn Install WordPress để cài đặt WordPress.

Quá trình cài đặt diễn ra trong vài giây và có thể truy cập website.

III. Tổng kết

Qua bài viết này chúng ta đã nắm được cách để tạo website cài đặt WordPress lên FastPanel. Cũng như thao tác cơ bản để tạo thêm một website trên giao diện FastPanel.

Chúc các bạn thực hiện thành công.

Bài viết Hướng dẫn tạo website và cài đặt WordPress trên FastPanel đã xuất hiện đầu tiên vào ngày Hướng dẫn TENTEN.

FastPanel hiện là một trong những phần mềm quản lý máy chủ phổ biến nhất hiện nay. Nó tương tự như cPanel hoặc DirectAdmin. Tuy nhiên, nó rất đơn giản nên chạy nhanh hơn nhiều so với các phần mềm quản lý máy chủ khác và đặc biệt là nó hoàn toàn miễn phí.

Fastpanel có những tính năng gì?

Fastpanel có đầy đủ tính năng của hosting quản lý phần mềm. Bao gồm:

• Domain management
• Filemanager
• Database management
• Backup
• Free Let’s Encrypt SSL certificate
• VPS tracking statistics,
• Emails
• FTP and SFTP
• Apache & NginX
• Multi PHP
• Virus Scanner AI-BOLIT

Chuẩn bị cài đặt Fastpanel

Các bước chuẩn bị. Trước khi cài đặt, bạn cần chuẩn bị những điều sau:

• 1 VPS mới hoàn toàn với một trong những hệ điều hành sau: Centos 7, Debian 8 9 10, Ubuntu 18.04 20.04, AlmaLinux 8 và Rocky 8. Trong bài này mình sẽ hướng dẫn trên Centos 7 x64
• Phần mềm để login vào SSH như Putty, MobaXterm,…

Trước tiên, bạn cần truy cập trang chủ của FastPanel tại: https://fastpanel.direct/ để tạo tài khoản và đăng ký giấy phép. Hiện tại, FastPanel cho phép mọi người đăng ký giấy phép miễn phí lên đến 2038. Thật tuyệt phải không?

Sau khi đăng ký giấy phép qua email, bạn cần nhập email để kích hoạt giấy phép miễn phí ở bước cuối cùng.

Cài đặt Faspanel

Bước 1: Đăng nhập vào SSH

Bước 2: Cập nhập hệ điều hành

Đối với Centos, AlmaLinux và Rocky:

yum update -y

Đối với Debian và Ubuntu:

apt update 
apt upgrade -y

Bước 3: Chạy lệnh sau để bắt đầu cài đặt

wget http://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -

Mặc định FastPanel sẽ sử dụng Mariadb 10.3 là dịch vụ lưu database, để sử dụng Mariadb mới hơn có thể sử dụng câu lệnh bên dưới:

wget http://repo.fastpanel.direct/install_fastpanel.sh

Kiểm tra các phiên bản Mariadb hiện có:

bash install_fastpanel.sh -h
Usage:  /tmp/22985_install_fastpanel.sh [-h|--help]
        /tmp/22985_install_fastpanel.sh [-f|--force] [-m|--mysql <mysql_version>]

Options:
    -h, --help             Print this help
    -f, --force            Skip check installed software (nginx, MySQL, apache2)
    -m, --mysql            Set MySQL version on fork for installation
            Available versions: default|mariadb10.3|mariadb10.4|mariadb10.5|mariadb10.6|mysql8.0|percona8.0

Cài đặt FastPanel với Mariadb 10.5:

bash install_fastpanel.sh -m mariadb10.5

Bước 4: Chờ đợi khoảng 10 phút. Sau đó thấy kết quả hiện ra như bên dưới có nghĩa là cài đặt thành công

Congratulations! FASTPANEL® successfully installed and available now for you at https://ip:8888

Login: fastuser

Password: password

Sau khi có thông tin bạn đăng nhập và tạo trang web theo từng bước rất dễ dàng.

Bài liên quan

• Tặng ngay 50K khi khách hàng đăng ký tài khoản VPS mới
• Bảng giá thuê VPS Cloud mới nhất
• Hướng dẫn sử dụng VPS với 6 bước đơn giản cho người mới bắt đầu

Bài viết Hướng dẫn cài đặt FastPanel đã xuất hiện đầu tiên vào ngày Hướng dẫn TENTEN.