Как установить CMS Pagekit на Debian 9
На этой странице
- Требования
- Предпосылки
- Начальные шаги
- Шаг 1. Установите PHP и необходимые расширения PHP
- Шаг 2. Установите MariaDB и создайте базу данных для Pagekit.
- Шаг 3. Установите клиент Acme.sh и получите сертификат Lets Encrypt (необязательно)
- Шаг 4. Установите NGINX и настройте NGINX для Pagekit.
- Шаг 5. Загрузите и установите CMS Pagekit
- Шаг 6. Завершите настройку Pagekit
- Ссылки
Pagekit — это современная, интуитивно понятная, модульная и гибкая CMS с открытым исходным кодом (лицензия MIT), созданная с использованием компонентов Symfony и Vue.js. Это дает вам инструменты для создания красивых веб-сайтов. Он имеет богатую экосистему тем и плагинов.
В этом руководстве мы познакомим вас с процессом установки Pagekit CMS в операционной системе Debian 9 (stretch) с использованием NGINX в качестве веб-сервера, MariaDB в качестве сервера базы данных и, при необходимости, вы можете защитить транспортный уровень с помощью клиента acme.sh. и Центр сертификации Lets Encrypt для добавления поддержки SSL.
Требования
Чтобы установить Pagekit, убедитесь, что ваш сервер соответствует следующим требованиям:
- Apache версии 2.2 или выше или веб-сервер NGINX.
- MySQL версии 5.1 или выше или SQLite 3.
- PHP версии 5.5.9 или выше.
- Необходимые расширения PHP: JSON, Session, ctype, Tokenizer, SimpleXML, DOM, mbstring, PCRE 8.0+, ZIP и PDO с драйверами MySQL или SQLite.
- Дополнительные расширения PHP: cURL, iconv и XML Parser, а также APC или XCache для кэширования.
Предпосылки
- Система под управлением Debian 9 (растянутая).
- Пользователь без полномочий root с привилегиями sudo.
Начальные шаги
Проверьте версию вашей системы Debian:
lsb_release -ds
# Debian GNU/Linux 9.7 (stretch)
Настройте часовой пояс:
dpkg-reconfigure tzdata
Обновите пакеты операционной системы (программное обеспечение). Это важный первый шаг, поскольку он гарантирует наличие последних обновлений и исправлений безопасности для пакетов программного обеспечения вашей операционной системы по умолчанию:
apt update && apt upgrade -y
Установите несколько основных пакетов, необходимых для базового администрирования операционной системы Debian:
apt install -y curl wget vim git sudo unzip socat bash-completion dirmngr apt-transport-https
Шаг 1 - Установите PHP и необходимые расширения PHP
Для платформы Pagekit CMS требуется PHP версии 7.0 или выше. По умолчанию Debian 9 имеет PHP версии 7.0 в репозиториях программного обеспечения по умолчанию, что подходит для October CMS.
Загрузите и установите PHP 7.0 и необходимые расширения PHP:
sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mbstring php7.0-zip php7.0-mysql php7.0-sqlite3 php7.0-curl php7.0-xml
Чтобы показать PHP, скомпилированный в модулях, вы можете запустить:
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Проверить версию PHP:
php --version
# PHP 7.0.33-0+deb9u1 (cli) (built: Dec 7 2018 11:36:49) ( NTS )
# Copyright (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
# with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies
Служба PHP-FPM автоматически запускается и включается при перезагрузке системы Debian 9, поэтому нет необходимости запускать и включать ее вручную. Мы можем перейти к следующему шагу — установке и настройке базы данных.
Шаг 2. Установите MariaDB и создайте базу данных для Pagekit.
Pagekit CMS поддерживает базы данных MySQL, MariaDB и SQLite. Команда Debian заменила MySQL на MariaDB в качестве базы данных по умолчанию из Debian 9 (stretch), поэтому в этом руководстве мы будем использовать MariaDB в качестве сервера базы данных. Если вы хотите установить оригинальный MySQL, вы можете добавить и использовать официальный репозиторий MySQL, поддерживаемый Oracle.
Установите сервер базы данных MariaDB версии 10.2 из официального репозитория MariaDB:
sudo apt install -y software-properties-common dirmngr apt-transport-https
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] https://mirrors.nxthost.com/mariadb/repo/10.2/debian stretch main'
sudo apt update
sudo apt install -y mariadb-server
ПРИМЕЧАНИЕ. Вам будет предложено ввести пароль пользователя root. Введите надежный пароль и продолжите.
Проверьте версию MariaDB:
mysql --version
# mysql Ver 15.1 Distrib 10.2.22-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2
Запустите скрипт mysql_secure install
, чтобы улучшить безопасность MariaDB, и установите пароль для пользователя root
MariaDB:
sudo mysql_secure_installation
Ответьте на каждый из вопросов:
Enter current password for root (enter for none): Press Enter
Set root password? [Y/n] Y
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
Войдите в MariaDB как пользователь root:
sudo mysql -u root -p
# Enter password
Создайте базу данных MariaDB и пользователя, которого вы будете использовать для установки Pagekit, и запомните учетные данные:
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
Выход из оболочки MariaDB:
quit
Шаг 3. Установите клиент Acme.sh и получите сертификат Lets Encrypt (необязательно)
Защита вашего веб-сайта с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить SSL-сертификат от Lets Encrypt, мы будем использовать клиент Acme.sh. Acme.sh — это чистое программное обеспечение оболочки UNIX для получения SSL-сертификатов от Lets Encrypt без каких-либо зависимостей.
Загрузите и установите acme.sh:
sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
./acme.sh --install --accountemail
source ~/.bashrc
cd ~
Проверьте версию acme.sh:
acme.sh --version
# v2.8.1
Получите сертификаты RSA и ECC/ECDSA для своего домена/имени хоста:
# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256
Если вам нужны поддельные сертификаты для тестирования, вы можете добавить флаг --staging
к приведенным выше командам.
Чтобы просмотреть список выданных сертификатов, вы можете запустить:
acme.sh --list
Создайте каталог для хранения сертификатов. Мы будем использовать каталог /etc/letsencrypt
.
mkdir -p /etc/letsencrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Установите/скопируйте сертификаты в каталог /etc/letsencrypt.
# RSA
acme.sh --install-cert -d example.com \
--cert-file /etc/letsencrypt/example.com/cert.pem \
--key-file /etc/letsencrypt/example.com/private.key \
--fullchain-file /etc/letsencrypt/example.com/fullchain.pem \
--reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc \
--cert-file /etc/letsencrypt/example.com_ecc/cert.pem \
--key-file /etc/letsencrypt/example.com_ecc/private.key \
--fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem \
--reloadcmd "sudo systemctl reload nginx.service"
После выполнения приведенных выше команд ваши сертификаты и ключи будут находиться в:
- Для RSA: /etc/letsencrypt
/example.com
каталог. - Для ECC/ECDSA: /etc/letsencrypt
/example.com_ecc
каталог.
Все сертификаты будут автоматически обновляться каждые 60 дней.
После получения сертификатов выйдите из-под пользователя root и вернитесь к обычному пользователю sudo:
exit
Шаг 4. Установите NGINX и настройте NGINX для Pagekit
Установите веб-сервер NGINX:
sudo apt install -y nginx
Проверьте версию NGINX:
sudo nginx -v
# nginx version: nginx/1.10.3
Настройте NGINX для Pagekit, выполнив:
sudo vim /etc/nginx/sites-available/pagekit.conf
И заполните файл следующей конфигурацией:
server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
listen [::]:80;
listen 80;
server_name example.com;
index index.php index.html;
root /var/www/pagekit;
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
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 ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
}
}
Активируйте новую конфигурацию pagekit.conf
, связав файл с каталогом sites-enabled
.
sudo ln -s /etc/nginx/sites-available/pagekit.conf /etc/nginx/sites-enabled
Проверьте конфигурацию NGINX на наличие синтаксических ошибок:
sudo nginx -t
Перезагрузите сервис NGINX:
sudo systemctl reload nginx.service
Шаг 5. Загрузите и установите CMS Pagekit
Создайте корневой каталог документа, в котором должен находиться Pagekit:
sudo mkdir -p /var/www/pagekit
Измените владельца каталога /var/www/pagekit
на [ваш_пользователь]:
sudo chown -R [your_user]:[your_user] /var/www/pagekit
Перейдите в корень документа:
cd /var/www/pagekit
Загрузите последнюю стабильную версию Pagekit CMS через wget
:
wget https://github.com/pagekit/pagekit/releases/download/1.0.16/pagekit-1.0.16.zip
Распакуйте содержимое Pagekit CMS и удалите загруженный файл .zip
.
unzip pagekit-1.0.16.zip
rm pagekit-1.0.16.zip
Измените владельца каталога /var/www/pagekit
на www-data
.
sudo chown -R www-data:www-data /var/www/pagekit
Шаг 6. Завершите настройку Pagekit
Откройте свой сайт в веб-браузере, и вы должны увидеть следующую страницу:
Нажмите на значок со стрелкой вправо, чтобы продолжить установку. Выберите язык и нажмите кнопку \Далее\:
Затем выберите базу данных SQLite или MySQL, заполните необходимые поля и нажмите кнопку «Далее»:
После этого настройте свой сайт, введя название сайта и создав учетную запись администратора:
И это должно быть так. Вы будете перенаправлены на страницу входа в Pagekit. Укажите свое имя пользователя и пароль для входа в панель управления Pagekit.
Вот и все. Если вы застряли, ознакомьтесь с официальной документацией Pagekit.
Ссылки
- https://pagekit.com/
- https://github.com/pagekit/pagekit