Как установить InvoicePlane с Nginx на FreeBSD 12

InvoicePlane — это бесплатное и открытое приложение для выставления счетов. Этот учебник покажет вам, как установить InvoicePlane на систему FreeBSD 12.

Требования

Веб-сервер (Apache, NGINX). В этом учебнике будет использоваться Nginx.
MySQL версии 5.5 или выше или эквивалентная версия MariaDB.
PHP версии 7.0, 7.1 или 7.2 с установленными и активированными следующими расширениями PHP:
- php-gd
- php-hash
- php-json
- php-mbstring
- php-mcrypt
- php-mysqli
- php-openssl
- php-recode
- php-xmlrpc
- php-zlib

Предварительные требования

Сервер с установленной FreeBSD 12.
Пользователь, не являющийся root, с правами sudo.

Начальные шаги

Проверьте вашу версию FreeBSD:

uname -ro  
# FreeBSD 12.1-RELEASE

Настройте часовой пояс:

tzsetup

Обновите пакеты вашей операционной системы (программное обеспечение). Это важный первый шаг, так как он гарантирует, что у вас есть последние обновления и исправления безопасности для стандартных пакетов программного обеспечения вашей операционной системы:

freebsd-update fetch install  
pkg update && pkg upgrade -y

Установите некоторые необходимые пакеты, которые необходимы для базового администрирования операционной системы FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash

Шаг 1 - Установите PHP и необходимые расширения PHP

Веб-приложение InvoicePlane требует PHP версии 7.0 или выше.

Установите PHP, а также необходимые расширения PHP:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-mysqli php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Проверьте версию PHP:

php --version  
  
# PHP 7.2.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies

Включите и запустите службу PHP-FPM:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Шаг 2 - Установите MySQL

Установите сервер базы данных MySQL:

sudo pkg install -y mysql57-server

Проверьте версию MySQL:

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using  EditLine wrapper

Включите и запустите службу MySQL:

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

Запустите скрипт mysql_secure_installation, чтобы улучшить безопасность MySQL и установить пароль для пользователя MySQL root:

sudo mysql_secure_installation

Ответьте на каждый из вопросов:

Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y

Подключитесь к оболочке MySQL как пользователь root:

sudo mysql -u root -p  
# Введите пароль

Создайте пустую базу данных MySQL и пользователя для Matomo и запомните учетные данные:

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

Выйдите из MySQL:

exit

Замените dbname, username и password на ваши собственные имена.

Шаг 3 - Установите acme.sh клиент и получите сертификат Let’s Encrypt (по желанию)

Защита вашего веб-сайта с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить сертификат TLS от Let’s Encrypt, мы будем использовать клиент Acme.sh. Acme.sh — это чистое программное обеспечение UNIX shell для получения сертификатов TLS от Let’s Encrypt без зависимостей.

Скачайте и установите Acme.sh:

sudo pkg install -y acme.sh

Проверьте версию Acme.sh:

acme.sh --version  
# v2.8.2

Получите RSA и ECC/ECDSA сертификаты для вашего домена/имени хоста:

# RSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

После выполнения вышеуказанных команд ваши сертификаты и ключи будут находиться в:

Для RSA: директория /etc/letsencrypt/example.com.
Для ECC/ECDSA: директория /etc/letsencrypt/example.com_ecc.

Шаг 3 - Установите NGINX

Установите веб-сервер NGINX:

sudo pkg install -y nginx

Проверьте версию NGINX:

nginx -v  
# nginx version: nginx/1.14.2

Запустите и включите службу NGINX:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Настройте Nginx для InvoicePlane, выполнив:

sudo vim /usr/local/etc/nginx/invoiceplane.conf

И заполните файл следующей конфигурацией:

server {
    listen 80;
    listen [::]:80;

    server_name example.com;

    root /usr/local/www/invoiceplane;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~* \.php$ {  
      fastcgi_pass 127.0.0.1:9000;  
      include fastcgi_params;  
      fastcgi_index index.php5;  
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    }
}

Проверьте конфигурацию NGINX:

sudo nginx -t

Перезагрузите NGINX:

sudo service nginx restart

Шаг 4 - Установите InvoicePlane

Скачайте последнюю стабильную версию InvoicePlane и извлеките архив:

sudo mkdir -p /usr/local/www  
cd /usr/local/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

Перейдите в директорию /var/www/invoiceplane:

cd /usr/local/www/invoiceplane

Сделайте копию файла ipconfig.php.example и переименуйте копию в ipconfig.php:

sudo cp ipconfig.php.example ipconfig.php

Откройте файл ipconfig.php и добавьте ваш URL в него:

sudo vim ipconfig.php  
# Что-то вроде этого  
IP_URL=http://example.com

Измените владельца директории /usr/local/www/invoiceplane на www:

sudo chown -R www:www /usr/local/www/invoiceplane

Запустите sudo vim /etc/php.ini и установите date.timezone:

date.timezone = Region/City

Перезапустите службу PHP-FPM:

sudo service php-fpm restart

Запустите установщик InvoicePlane из вашего веб-браузера и следуйте инструкциям:

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

После завершения установки вы можете войти в InvoicePlane, используя адрес электронной почты и пароль, которые вы выбрали во время установки.

Если вы хотите защитить вашу установку, вы можете отключить установку. Для этого замените строку DISABLE_SETUP=false на DISABLE_SETUP=true в вашем файле ipconfig.php.