Как установить Bolt CMS с Nginx и Lets Encrypt на FreeBSD 12
На этой странице
- Требования
- Предпосылки
- Начальные шаги
- Шаг 1. Установите MySQL и создайте базу данных для Bolt.
- Шаг 2. Установите PHP и необходимые расширения PHP
- Шаг 3. Установите клиент
acme.sh
и получите Let\>) - Шаг 3. Установите NGINX и настройте NGINX для Bolt CMS.
- Шаг 5. Установите Bolt CMS
- Шаг 6. Завершите установку и настройку Bolt CMS
- Ссылки
Bolt – это сложная, легкая и простая CMS, построенная на PHP. Он выпущен под лицензией MIT с открытым исходным кодом, а исходный код размещен в виде общедоступного репозитория на Github. Болт — это инструмент для управления контентом, который стремится быть как можно более простым и понятным. Он быстро устанавливается, легко настраивается, использует элегантные шаблоны. Bolt создан с использованием современных библиотек с открытым исходным кодом и лучше всего подходит для создания сайтов на HTML5 с современной разметкой. В этом руководстве мы рассмотрим установку Bolt CMS в системе FreeBSD 12, используя Nginx в качестве веб-сервера, MySQL в качестве сервера базы данных, и, при необходимости, вы можете защитить транспортный уровень с помощью клиента acme.sh и центра сертификации Lets Encrypt для добавить поддержку SSL.
Требования
Системные требования для Bolt скромные, и он должен работать на любом достаточно современном веб-сервере:
- PHP версии 5.5.9 или выше со следующими распространенными расширениями PHP: pdo, mysqlnd, pgsql, openssl, curl, gd, intl, json, mbstring, opcache, posix, xml, fileinfo, exif, zip.
- Доступ к SQLite (поставляется в комплекте с PHP), или MySQL, или PostgreSQL.
- Apache с включенным
mod_rewrite
(файлы.htaccess
) или Nginx (конфигурация виртуального хоста описана ниже). - Не менее 32 МБ памяти, выделенной для PHP.
Предпосылки
- Операционная система под управлением FreeBSD 12.
- Пользователь без полномочий root с привилегиями sudo.
Начальные шаги
Проверьте свою версию FreeBSD:
uname -ro
# FreeBSD 12.0-RELEASE
Настройте часовой пояс:
tzsetup
Обновите пакеты операционной системы (программное обеспечение). Это важный первый шаг, поскольку он гарантирует наличие последних обновлений и исправлений безопасности для пакетов программного обеспечения вашей операционной системы по умолчанию:
freebsd-update fetch install
pkg update && pkg upgrade -y
Установите несколько основных пакетов, необходимых для базового администрирования операционной системы FreeBSD 12.0:
pkg install -y sudo vim unzip wget bash
Шаг 1. Установите MySQL и создайте базу данных для Bolt.
Bolt поддерживает базы данных MySQL, MariaDB, PostgreSQL и SQLite. В этом руководстве мы будем использовать MySQL в качестве сервера базы данных.
Установите сервер базы данных MySQL:
sudo pkg install -y mysql57-server
Проверьте версию MySQL:
mysql --version
# mysql Ver 14.14 Distrib 5.7.27, for FreeBSD12.0 (amd64) using EditLine wrapper
Включите и запустите службу MySQL:
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Запустите скрипт установки mysql_secure
, чтобы повысить безопасность 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
# Enter password
Создайте пустую базу данных MySQL и пользователя для Bolt и запомните учетные данные:
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
своими именами.
Шаг 2 - Установите PHP и необходимые расширения PHP
Установите 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 php72-sqlite3 php72-pdo_sqlite php72-intl php72-posix
Проверьте версию PHP:
php --version
# PHP 7.2.22 (cli) (built: Sep 7 2019 01:12:40) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.2.22, Copyright (c) 1999-2018, by Zend Technologies
Включите и запустите службу PHP-FPM:
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Мы можем перейти к следующему шагу — получению бесплатных сертификатов SSL от Lets Encrypt CA.
Шаг 3. Установите клиент acme.sh и получите сертификат Lets Encrypt (необязательно)
Защита вашего веб-сайта с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить сертификат TLS от Lets Encrypt, мы будем использовать клиент Acme.sh. Acme.sh — это чистое программное обеспечение оболочки UNIX для получения сертификатов TLS от Lets Encrypt без каких-либо зависимостей.
Загрузите и установите Acme.sh:
sudo pkg install -y acme.sh
Проверьте версию Acme.sh:
acme.sh --version
# v2.8.2
Получите сертификаты RSA и ECC/ECDSA для своего домена/имени хоста:<br>
# 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 для Bolt CMS
Bolt CMS может нормально работать со многими популярными программами для веб-серверов. В этом уроке мы выбрали Nginx.
Загрузите и установите последнюю основную версию Nginx из репозитория FreeBSD:
sudo pkg install -y nginx-devel
Проверьте версию Nginx:
nginx -v
# nginx version: nginx/1.17.1
Включите и запустите Nginx:
sudo sysrc nginx_enable=yes
sudo service nginx start
Настройте Nginx для Bolt, выполнив:
sudo vim /usr/local/etc/nginx/bolt.conf
И заполните файл следующей конфигурацией:
server {
listen 80;
listen 443 ssl;
server_name example.com;
root /usr/local/www/bolt/public;
index index.php;
# RSA
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
# ECC
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /bolt {
try_files $uri /index.php?$query_string;
}
location ^~ /bolt/ {
try_files $uri /index.php?$query_string;
}
location ~ /index.php/(.*) {
rewrite ^/index.php/(.*) /$1 permanent;
}
location ~ /\. { deny all; }
location ~ /\.(htaccess|htpasswd)$ { deny all; }
location ~ /\.(?:db)$ { deny all; }
location ~* /(.*)\.(?:markdown|md|twig|yaml|yml)$ { deny all; }
location ~ [^/]\.php(/|$) {
include fastcgi_params;
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTP_PROXY "";
fastcgi_param HTTPS $https if_not_empty;
fastcgi_pass 127.0.0.1:9000;
}
}
ПРИМЕЧАНИЕ. Полную и готовую к работе конфигурацию Nginx для Bolt CMS см. на https://docs.bolt.cm/3.6/installation/webserver/nginx.
Запустите sudo vim /usr/local/etc/nginx/nginx.conf
и добавьте приведенную ниже строку в блок http {}
, чтобы включить конфигурацию Bolt.
include bolt.conf;
Проверьте конфигурацию Nginx на наличие синтаксических ошибок:
sudo nginx -t
Перезагрузите сервис Nginx:
sudo service nginx reload
Шаг 5. Установите CMS Bolt
Создайте каталог /usr/local/www
:
sudo mkdir -p /usr/local/www
Перейдите в каталог /usr/local/www
:
cd /usr/local/www
Загрузите последнюю версию Bolt CMS через wget и разархивируйте ее:
sudo wget https://bolt.cm/distribution/bolt-latest.zip && sudo unzip bolt-latest.zip
Удалите загруженный файл bolt-latest.zip
:
sudo rm bolt-latest.zip
Переименуйте каталог Bolt-v3.6.10 в просто Bolt:
sudo mv bolt-v3.6.10 bolt
Перейдите в каталог /usr/local/www/bolt
:
cd /usr/local/www/bolt
Для завершения установки вам потребуется переименовать следующие файлы:
sudo mv .bolt.yml.dist .bolt.yml
sudo mv composer.json.dist composer.json
sudo mv composer.lock.dist composer.lock
sudo mv src/Site/CustomisationExtension.php.dist src/Site/CustomisationExtension.php
Измените владельца каталога /usr/local/www/bolt
на www
user:
sudo chown -R www:www /usr/local/www/bolt
Перейдите в папку, в которую вы загрузили Bolt, в веб-браузере и следуйте инструкциям на экране.
Шаг 6. Завершите установку и настройку Bolt CMS
После открытия вашего сайта в веб-браузере вы должны быть перенаправлены на следующую страницу:
Заполните необходимую информацию, чтобы создать пользователя, и нажмите кнопку «Создать первого пользователя», чтобы продолжить. После этого должен появиться интерфейс администратора Bolt CMS:
Установка Bolt CMS завершена. Чтобы получить доступ к администратору Bolt CMS, добавьте /bolt
к IP-адресу или домену вашего сайта.
Ссылки
- https://bolt.cm/
- https://github.com/bolt/bolt