Как установить DokuWiki на Debian 12

DokuWiki — это простое, универсальное программное обеспечение для вики с открытым исходным кодом, которое не требует базы данных. Оно известно своей простотой в обслуживании, читаемостью и управлением пользователями, что делает его идеальным для создания и управления документацией в корпоративной или совместной среде. Работая на PHP, это универсальное программное обеспечение для вики и встроенные средства управления доступом (ACL) поддерживают основные драйверы аутентификации. DokuWiki обеспечивает простое администрирование, его легко установить, поддерживать и создавать резервные копии с одного хоста на другой.

В этом руководстве мы проведем вас через установку DokuWiki на сервере Debian 12. Вы установите DokuWiki с LAMP Stack (Apache2, MariaDB и PHP), UFW и сертификатами SSl/TLS через Letsencrypt.

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

Убедитесь, что у вас есть следующее, чтобы продолжить это руководство:

Сервер Debian 12.
Непривилегированный пользователь с правами администратора.
Доменное имя, указывающее на IP-адрес сервера.

Установка зависимостей

По умолчанию пакет DokuWiki доступен в репозитории Debian. Но, чтобы убедиться, что у вас установлена последняя версия DokuWiki, вы будете устанавливать DokuWiki вручную на ваш сервер Debian.

В этом разделе вы установите зависимости для DokuWiki, включая пакеты LAMP Stack (Apache2, MariaDB и PHP), UFW и Certbot.

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

sudo apt update

Установите пакеты LAMP Stack, UFW и Certbot, используя следующую команду apt install. Нажмите Y и нажмите ENTER, когда будет предложено.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

install deps

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

Выполните следующую команду, чтобы проверить службу apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Когда apache2 работает, вы должны получить вывод ‘active (running)’. А вывод ‘enabled’ подтверждает, что apache2 будет запущен при загрузке системы.

verify apache2

Теперь выполните следующую команду, чтобы проверить службу mariadb.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Убедитесь, что служба mariadb ‘enabled’ и ‘active (running)’ на вашем компьютере с Debian.

verify mariadb

Настройка UFW

В этом руководстве вы защитите свой сервер Debian с помощью UFW (Uncomplicated Firewall). В этом случае вам необходимо открыть порт SSH для удаленного доступа и порты для протоколов HTTP и HTTPS для запуска установки DokuWiki.

Запустите следующую команду, чтобы добавить профили OpenSSH и ‘WWW Full‘ в UFW.

Профиль OpenSSH откроет порт SSH по умолчанию 22, в то время как профиль ‘WWW Full’ открывает порты HTTP и HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Теперь выполните следующую команду, чтобы запустить и включить UFW на вашем компьютере с Debian.

sudo ufw enable

Введите y, когда будет предложено подтвердить, и вы должны получить вывод, такой как ‘Firewall is active and enabled on system startup‘. UFW будет автоматически запущен при загрузке системы.

setup ufw

Наконец, выполните следующую команду, чтобы проверить статус UFW. Убедитесь, что оба профиля OpenSSH и ‘WWW Full’ перечислены в ваших правилах, включенных в UFW.

sudo ufw status

verify ufw

Настройка php.ini

В следующем разделе вы настроите PHP, изменив файл php.ini по умолчанию и настроив некоторые параметры для установки DokuWiki.

Запустите следующую команду редактора nano, чтобы открыть файл конфигурации PHP ‘/etc/php/8.2/apache2/php.ini‘.

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

Измените конфигурацию по умолчанию на следующую. Убедитесь, что вы изменили параметр memory_limit в соответствии с вашей текущей оперативной памятью сервера.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Сохраните и закройте файл, когда закончите.

Теперь выполните команду systemctl ниже, чтобы перезапустить службу apache2 и применить ваши изменения.

sudo systemctl restart apache2

Настройка сервера MariaDB

Теперь, когда вы настроили PHP, следующий шаг — настроить установку вашего сервера MariaDB, а затем создать новую базу данных и пользователя, которые будут использовать DokuWiki.

Начните процесс настройки MariaDB, выполнив команду mariadb-secure-installation ниже.

sudo mariadb-secure-installation

Введите Y, когда будет предложено применить новую конфигурацию к MariaDB, или вы также можете ввести n для отказа. Ниже приведены некоторые из конфигураций MariaDB, которые вам будут предложены:

По умолчанию установка MariaDB не имеет пароля, нажмите ENTER, когда будет предложено ввести пароль.
Теперь введите Y, чтобы установить пароль root для MariaDB. Затем введите новый пароль для MariaDB и повторите пароль.
Введите Y, чтобы удалить анонимного пользователя из вашей установки MariaDB.
Введите Y снова, когда будет предложено отключить удаленный вход для пользователя root MariaDB.
Введите Y, чтобы удалить тестовую базу данных по умолчанию из вашей MariaDB.
Наконец, введите Y, чтобы перезагрузить привилегии таблиц и применить новые изменения.

После завершения настройки MariaDB вам нужно создать новую базу данных и пользователя, которые будут использоваться DokuWiki.

Войдите на сервер MariaDB, выполнив команду mariadb ниже. Введите свой пароль root MariaDB, когда будет предложено.

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных dokuwikidb, пользователя dokuwiki с паролем ‘p4ssword‘. Обязательно измените пароль на свой новый пароль.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

create database user

Далее проверьте пользователя dokuwiki, чтобы убедиться, что у него есть привилегии на базу данных dokuwikidb.

SHOW GRANTS FOR dokuwiki@localhost;

В следующем выводе вы настроили пользователя dokuwiki с полными привилегиями для базы данных dokuwikidb.

show dtabase user

Наконец, введите quit, чтобы выйти из сервера MariaDB и перейти к следующему шагу.

Загрузка исходного кода DokuWiki

В этом разделе вы загрузите исходный код DokuWiki и настроите каталог установки с правильными правами.

Перейдите в каталог /var/www/ и загрузите последнюю стабильную версию DokuWiki, используя команду wget ниже.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Теперь извлеките файл dokuwiki-stable.tgz и переименуйте извлеченный каталог в dokuwiki. Это означает, что ваш каталог установки DokuWiki будет доступен по адресу /var/www/dokuwiki.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Наконец, выполните команду ниже, чтобы изменить владельца каталога /var/www/dokuwiki на пользователя www-data и группу www-data. Таким образом, ваш веб-сервер Apache2 сможет читать исходный код DokuWiki.

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

Настройка виртуального хоста Apache2

После загрузки DokuWiki вы теперь создадите новый файл виртуального хоста Apache2 для запуска DokuWiki. Убедитесь, что ваше доменное имя готово, прежде чем начать. В этом примере мы будем использовать домен wiki.howtoforge.local.

Теперь выполните команду редактора nano ниже, чтобы создать новую конфигурацию виртуального хоста Apache2 /etc/apache2/sites-available/dokuwiki.conf.

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

Вставьте следующую конфигурацию и убедитесь, что вы изменили доменное имя wiki.howtoforge.local на ваше доменное имя.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined

Когда закончите, сохраните и закройте файл.

Далее выполните следующую команду, чтобы включить виртуальный хост dokuwiki.conf и проверить синтаксис Apache, чтобы убедиться, что ошибок нет.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Если у вас правильный синтаксис и нет ошибок, вы увидите вывод ‘Syntax OK‘.

setup apache2

Наконец, выполните команду ниже, чтобы перезапустить сервер Apache2 и применить ваши изменения.

sudo systemctl restart apache2

Защита DokuWiki с помощью сертификатов SSL/TLS

На данный момент ваш DokuWiki работает и доступен. Но чтобы убедиться, что ваша установка безопасна, вы настроите сертификаты SSl/TLS через Letsencrypt.

Выполните команду certbot ниже, чтобы сгенерировать сертификаты SSL/TLS для вашего доменного имени DokuWiki. Убедитесь, что вы изменили адрес электронной почты и доменное имя на свои данные.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

После завершения процесса ваша установка DokuWiki должна быть автоматически настроена с HTTPS. А ваши сертификаты SSL/TLS должны быть доступны в каталоге /etc/letsencrypt/live/yourdomain.com.

Установка DokuWiki через веб-установщик

Откройте веб-браузер и посетите ваше доменное имя для установки DokuWiki, например https:/wiki.howtoforge.local/install.php. Вы должны увидеть веб-установщик DokuWiki.

Выберите опцию Включить ACL, введите своего администратора, электронную почту и пароль для DokuWiki, а затем нажмите Сохранить.

install dokuwiki

После успешной установки вы должны получить вывод ‘The configuration was finished successfully.‘.

installation finished

Теперь вернитесь в свой терминал и удалите скрипт install.php, используя команду ниже.

sudo rm /var/www/dokuwiki/install.php

Далее нажмите на ссылку ‘ваш новый DokuWiki‘, чтобы продолжить. И вы должны получить домашнюю страницу DokuWiki, как показано ниже.

dokuwiki homepage

Теперь нажмите на кнопку Войти, и вы должны увидеть страницу входа DokuWiki, как показано ниже.

Введите своего администратора и пароль, затем нажмите Войти. При успешном входе вам будет представлен интерфейс DokuWiki.

dockuwiki dashboard

Заключение

Поздравляем! Вы завершили установку DokuWiki на сервере Debian 12. Вы установили DokuWiki с LAMP Stack (Apache2, MariaDB и PHP). Вы также защитили свою установку DokuWiki с помощью UFW (Uncomplicated Firewall) и сертификатов SSL/TLS от Letsencrypt.