Cách cài đặt InvoicePlane với Nginx trên Debian 9

[theanh]

InvoicePlanelà một ứng dụng lập hóa đơn miễn phí và mã nguồn mở. Mã nguồn của ứng dụng này có thể được tìm thấy trên Github này. Hướng dẫn này sẽ chỉ cho bạn cách cài đặt InvoicePlane trên hệ thống Debian9 (stretch) mới.

Yêu cầu​

• WebServer (Apache, NGINX).Hướng dẫn này sẽ sử dụng Nginx.
• MySQL phiên bản 5.5 trở lên hoặc phiên bản tương đương của MariaDB.
• PHP phiên bản 7.0, 7.1 hoặc 7.2 với các tiện ích mở rộng PHP sau đã cài đặt và kích hoạt:
• php-gd
• php-hash
• php-json
• php-mbstring
• php-mcrypt
• php-mysqli
• php-openssl
• php-recode
• php-xmlrpc
• php-zlib

Điều kiện tiên quyết​

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

Các bước ban đầu​

Kiểm tra phiên bản Debian của bạn:

lsb_release -ds
# Debian GNU/Linux 9 (stretch)

Thiết lập múi giờ:

sudo dpkg-reconfigure tzdata

Cập nhật các gói hệ điều hành của bạn (phần mềm). Đây là bước đầu tiên cần thiết vì nó đảm bảo bạn có bản cập nhật mới nhất và bản sửa lỗi bảo mật cho các gói phần mềm mặc định của hệ điều hành:

sudo apt update && sudo apt upgrade -y

Cài đặt một số gói thiết yếu cần thiết cho việc quản trị cơ bản hệ điều hành Debian:

sudo apt install -y curl wget vim git unzip socat bash-completion apt-transport-https

Bước 1 - Cài đặt PHP và các tiện ích mở rộng PHP cần thiết​

Ứng dụng web InvoicePlane yêu cầu PHP phiên bản 7.0 trở lên.

Cài đặt PHP cũng như các tiện ích mở rộng PHP cần thiết:

sudo apt install -y php-cli php-fpm php-common php-gd php-json php-mbstring php-mysql php-xmlrpc php-recode

Để hiển thị PHP đã biên dịch trong các mô-đun, bạn có thể chạy:

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Kiểm tra phiên bản PHP:

php --version

#PHP 7.0.9-1~deb10u1 (cli) (xây dựng: 18 tháng 9 năm 2019 10:33:23) (NTS)
# Bản quyền (c) 1997-2018 The PHP Group
# Zend Engine v3.3.9, Bản quyền (c) 1998-2018 Zend Technologies
# với Zend OPcache v7.0.9-1~deb10u1, Bản quyền (c) 1999-2018, của Zend Technologies

Khởi động và kích hoạt dịch vụ PHP-FPM:

sudo systemctl start php7.0-fpm.service
sudo systemctl enable php7.0-fpm.service

Bước 2 - Cài đặt MariaDB​

Cài đặt MariaDB:

sudo apt install -y mariadb-server

Kiểm tra phiên bản MariaDB:

mysql --version

Khởi động và kích hoạt dịch vụ MariaDB:

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Chạy tập lệnh mysql_secure installation để cải thiện bảo mật MariaDB và đặt mật khẩu cho người dùng root MariaDB:

sudo mysql_secure_installation

Trả lời tất cả các câu hỏi như được hiển thị bên dưới:

Nhập mật khẩu hiện tại cho root (nhập nếu không có):
Đặt mật khẩu root? [Y/n]: Y
Xóa người dùng ẩn danh? [Y/n]: Y
Không cho phép đăng nhập root 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

Đăng nhập vào shell MariaDB với tư cách là người dùng root:

mysql -u root -p
# Nhập mật khẩu

Tạo cơ sở dữ liệu MariaDB và người dùng mà bạn sẽ sử dụng để cài đặt InvoicePlane và ghi nhớ thông tin đăng nhập:

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Thoát khỏi shell MariaDB:

quit

Thay thếdbname,username vàpassword bằng tên của riêng bạn.

Bước 3 - Cài đặt NGINX​

Cài đặt máy chủ web Nginx:

sudo apt install -y nginx

Kiểm tra phiên bản NGINX:

nginx -v
# phiên bản nginx: nginx/1.10.3

Khởi động và kích hoạt dịch vụ Nginx:

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Cấu hìnhNGINX cho InvoicePlane. Chạy sudo vim /etc/nginx/sites-available/invoiceplane.conf và điền vào tệp với cấu hình sau:

server { lắng nghe 80; lắng nghe [::]:80; tên_máy_chủ example.com; gốc /var/www/InvoicePlane; chỉ mục index.php index.html; vị trí / { try_files $uri $uri/ /index.php?$query_string; } vị trí ~ \.php$ {
 bao gồm các đoạn mã/fastcgi-php.conf; bao gồm fastcgi_params; fastcgi_param TÊN_TỆP_SCRIPT $document_root$fastcgi_script_name; fastcgi_pass unix:/var/run/php/php7.0-fpm.sock; }}

Kích hoạt cấu hình invoiceplane.conf mới bằng cách liên kết tệp đến thư mục sites-enabled:

sudo ln -s /etc/nginx/sites-available/invoiceplane.conf /etc/nginx/sites-enabled/

Kiểm tra cấu hình NGINX:

sudo nginx -t

Tải lại NGINX:

sudo systemctl reload nginx.service

Bước 4 - Cài đặt InvoicePlane​

Tải xuống phiên bản ổn định mới nhất của InvoicePlane và giải nén tệp lưu trữ:

sudo mkdir -p /var/www
cd /var/www
sudo curl -O -J -L https://invoiceplane.com/download/v1.5.9
sudo unzip v1.5.9.zip
sudo rm v1.5.9.zip
sudo mv ip invoiceplane

Điều hướng đến /var/www/invoiceplanethư mục:

cd /var/www/invoiceplane

Tạo một bản sao của tệp ipconfig.php.example và đổi tên bản sao thành ipconfig.php:

sudo cp ipconfig.php.example ipconfig.php

Mở tệp ipconfig.php và thêm URL của bạn vào đó:

sudo vim ipconfig.php
# Giống như this
IP_URL=http://example.com

Thay đổi quyền sở hữu thư mục /var/www/invoiceplane thành www-data:

sudo chown -R www-data:www-data /var/www/InvoicePlane

Chạy sudo vim /etc/php.ini và đặt date.timezone:

date.timezone = Region/City

Khởi động lại dịch vụ PHP-FPM:

sudo systemctl restart php7.0-fpm.service

Chạy trình cài đặt InvoicePlane từ trình duyệt web của bạn và làm theo hướng dẫn:

http://example.com/index.php/setup

Sau khi quá trình cài đặt hoàn tất, bạn có thể đăng nhập vào InvoicePlane bằng địa chỉ email và mật khẩu đã chọn trong cài đặt.

Nếu bạn muốn bảo mật cài đặt của mình, bạn có thể vô hiệu hóa cài đặt. Để thực hiện việc này, hãy thay thế dòng DISABLE_SETUP=falsebằng DISABLE_SETUP=true trong tệp ipconfig.php của bạn.

Bước 5 - Hoàn tất cài đặt InvoicePlane​

InvoicePlane hiện đã được cài đặt và định cấu hình, đã đến lúc truy cập trình hướng dẫn cài đặt web của nó.

Mở trình duyệt web của bạn và nhập URL

Example Domain

. Bạn sẽ được chuyển hướng đến trang sau:



Bây giờ, hãy nhấp vào nút Cài đặt. Bạn sẽ thấy trang sau:



Tiếp theo, hãy chọn ngôn ngữ và nhấp vào nút Tiếp tục. Bạn sẽ thấy trang sau:



Tiếp theo, nhấp vào nút Tiếp tục. Bạn sẽ thấy trang sau:



Tại đây, hãy cung cấp thông tin chi tiết về cơ sở dữ liệu của bạn và nhấp vào nút Thử lại. Bạn sẽ thấy trang sau:



Bây giờ, hãy nhấp vào nút Tiếp tục. Bạn sẽ thấy trang sau:



Bây giờ, hãy nhấp vào nút Tiếp tục. Bạn sẽ thấy trang sau:



Bây giờ, hãy cung cấp tất cả thông tin chi tiết cần thiết, sau đó nhấp vào nút Tiếp tục. Sau khi cài đặt hoàn tất, bạn sẽ thấy trang sau:



Bây giờ, hãy nhấp vào nút Đăng nhập để truy cập vào quản trị InvoicePlane.

Liên kết​

• https://invoiceplane.com/
• https://github.com/InvoicePlane/InvoicePlane