Cách cài đặt BookStack trên Ubuntu 18.04 LTS

[theanh]

BookStack là một nền tảng quản lý kiến thức mã nguồn mở và miễn phí có thể được sử dụng để tạo tài liệu và nội dung wiki cho người dùng của bạn. BookStack được viết bằng ngôn ngữ PHP và sử dụng khung web Laravel. BookStack cho phép bạn thiết lập BookStack theo nhu cầu của mình như thay đổi tên, Logo và tùy chọn đăng ký. BookStack cung cấp nhiều tính năng như, Hỗ trợ đa ngôn ngữ, Trình chỉnh sửa Markdown, Có thể tùy chỉnh, Có thể tìm kiếm, Giao diện WYSIWYG, Quản lý vai trò và quyền, Xác thực tích hợp và nhiều tính năng khác.

Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách cài đặt Bookstack với Apache trong máy chủ Ubuntu 18.04.

Yêu cầu​

• Máy chủ chạy Ubuntu 18.04.
• Người dùng không phải root có quyền sudo.

Bắt đầu​

Trước khi bắt đầu, bạn sẽ cần cập nhật hệ thống của bạn lên phiên bản mới nhất. Bạn có thể thực hiện việc này bằng cách chạy lệnh sau:

sudo apt-get update -y
sudo apt-get upgrade -y

Sau khi hệ thống của bạn được cập nhật, hãy khởi động lại hệ thống để áp dụng các thay đổi.

Cài đặt LAMP Server​

Trước tiên, bạn sẽ cần cài đặt máy chủ web Apache, máy chủ MariaDB, PHP và các mô-đun PHP khác vào hệ thống của mình. Bạn có thể cài đặt tất cả chúng bằng cách chạy lệnh sau:

sudo apt-get install apache2 mariadb-server php7.2 libapache2-mod-php7.2 php7.2-common php7.2-sqlite3 php7.2-curl php7.2-intl php7.2-mbstring php7.2-xmlrpc php7.2-mysql php7.2-gd php7.2-xml php7.2-cli php7.2-tidy php7.2-zip unzip wget git -y

Sau khi tất cả các gói được cài đặt, hãy mở tệp php.ini và thực hiện một số thay đổi:

sudo nano /etc/php/7.2/apache2/php.ini

Thực hiện các thay đổi sau:

memory_limit = 256Mupload_max_filesize = 150Mmax_execution_time = 360date.timezone = Asia/Kolakata

Lưu và đóng tệp.

Cấu hình MariaDB​

Theo mặc định, MariaDB không được bảo mật. Vì vậy, trước tiên bạn cần bảo mật nó. Bạn có thể bảo mật nó bằng cách chạy lệnh sau:

sudo mysql_secure_installation

Trả lời tất cả các câu hỏi như sau:

Nhập mật khẩu hiện tại cho root (nhập nếu không có): ENTER Đặt mật khẩu root? [Y/n]: N Xóa người dùng ẩn danh? [Y/n]: Y Không cho phép root đăng nhập từ xa? [Y/n]: Y Xóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào cơ sở dữ liệu đó? [Y/n]: Y Tải lại bảng đặc quyền ngay bây giờ? [Y/n]: Y

Sau khi MariaDB được bảo mật, hãy đăng nhập vào shell MariaDB:

mysql -u root -p

Cung cấp mật khẩu root của bạn. Sau đó, tạo cơ sở dữ liệu và người dùng cho Bookstack:

MariaDB [(none)]> CREATE DATABASE bookstackdb;
MariaDB [(none)]> CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'password';

Thay thế từ 'password' trong lệnh trên bằng mật khẩu an toàn và không lưu lại để sử dụng sau. Tiếp theo, cấp tất cả các quyền cho Bookstack bằng lệnh sau:

MariaDB [(none)]> GRANT ALL ON bookstackdb.* TO 'bookstack'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Thay thế từ 'password' một lần nữa ở đây bằng cùng mật khẩu bạn đã sử dụng ở trên. Tiếp theo, xóa các quyền và thoát khỏi shell MariaDB:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Cài đặt Bookstack​

Trước tiên, bạn sẽ cần cài đặt Composer vào hệ thống của mình. Composer là trình quản lý phụ thuộc cho PHP. Bạn có thể cài đặt Composer bằng lệnh sau:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Tiếp theo, hãy thay đổi thư mục thành /var/www/html và tải xuống phiên bản Bookstack mới nhất từ kho lưu trữ Git bằng lệnh sau:

cd /var/www/html/
sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch

Tiếp theo, hãy thay đổi thư mục thành Bookstack và cài đặt tất cả các phụ thuộc mà PHP yêu cầu bằng lệnh sau:

cd Bookstack
sudo composer install

Sau khi tất cả các phụ thuộc đã được cài đặt, hãy sao chép tệp cấu hình môi trường mẫu bằng lệnh sau:

sudo cp .env.example .env

Tiếp theo, hãy cập nhật cài đặt cơ sở dữ liệu trong tệp .env:

sudo nano .env

Thực hiện các thay đổi sau:

# Chi tiết cơ sở dữ liệuDB_HOST=localhostDB_DATABASE=bookstackdbDB_USERNAME=bookstackDB_PASSWORD=password

Lưu và đóng tệp. Sau đó, tạo khóa ứng dụng và di chuyển cơ sở dữ liệu bằng lệnh sau:

sudo php artisan key:generate

Đầu ra:

**************************************** Ứng dụng đang trong giai đoạn sản xuất! ******************************************* Bạn có thực sự muốn chạy lệnh này không? (có/không) [không]: > cóKhóa ứng dụng [base64:KTcNpGD5CacIz20eiKpusk02YaHm14OQTZTERizEDBw=] đã được thiết lập thành công.

Tiếp theo, bạn sẽ cần di chuyển cơ sở dữ liệu. Bạn có thể di chuyển cơ sở dữ liệu bằng lệnh sau:

sudo php artisan migrate

Bạn sẽ thấy đầu ra sau:

**************************************** Ứng dụng đang trong giai đoạn sản xuất! **************************************** Bạn có thực sự muốn chạy lệnh này không? (có/không) [không]: > yesBảng di chuyển đã được tạo thành công.

Tiếp theo, cấp quyền thích hợp cho thư mục Bookstack bằng lệnh sau:

sudo chown -R www-data:www-data /var/www/html/BookStack/
sudo chmod -R 755 /var/www/html/BookStack/

Cấu hình Apache cho Bookstack​

Tiếp theo, bạn sẽ cần tạo tệp máy chủ ảo Apache cho Bookstack. Bạn có thể tạo tệp này bằng lệnh sau:

sudo nano /etc/apache2/sites-available/bookstack.conf

Thêm các dòng sau:

 ServerAdmin [emailprotected] DocumentRoot /var/www/html/Bookstack ServerName example.com ServerAlias www.example.com  Tùy chọn FollowSymlinks AllowOverride All Require all granted  ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined

Thay thế 'example.com' và 'www.example.com' trong tệp trên bằng tên miền của riêng bạn. Sau đó lưu và đóng tệp và bật tệp máy chủ ảo Apache và viết lại mô-đun bằng các lệnh sau:

sudo a2ensite bookstack.conf
sudo a2enmod rewrite

Cuối cùng, khởi động lại dịch vụ web Apache để áp dụng tất cả các thay đổi:

sudo systemctl restart apache2

Access Bookstack​

Mở trình duyệt web của bạn và nhập URL, trong trường hợp của tôi là http://example.com, bạn sẽ được chuyển hướng đến trang sau:



Bây giờ, cung cấp tên người dùng mặc định là [emailprotected] và password làm mật khẩu, sau đó nhấp vào nút ĐĂNG NHẬP. Bạn sẽ được chuyển hướng đến bảng điều khiển Bookstack ở trang sau:





Bước tiếp theo là thay đổi mật khẩu mặc định để bảo mật Đăng nhập BookStack.

Kết luận​

Xin chúc mừng! Bạn đã cài đặt thành công Bookstack trên máy chủ Ubuntu 18.04 LTS. Bây giờ bạn có thể dễ dàng tạo trang wiki của riêng mình bằng Bookstack. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.