Установка DokuWiki на Ubuntu 18.04

Важно: IP-адрес и имя хоста в примерах замените на реальные значения вашей сети. Пароли задавайте надёжные.

О чём статья

DokuWiki — лёгкое, свободное и расширяемое вики-приложение на PHP. Работает с обычными текстовыми файлами и не требует СУБД. Подходит для документации и внутренних вики. В статье показаны все шаги установки на Ubuntu 18.04 и примечания по отладке и безопасности.

Требования

Сервер с Ubuntu 18.04.
Статический IP, например 192.168.0.101 (замените на свой).
Доступ root или привилегии sudo.

Начало работы — обновление системы

Обновите пакеты и ядро перед установкой:

apt-get update -y  
 apt-get upgrade -y

Перезагрузите систему, если ядро или крупные пакеты обновлялись.

Установка Apache и PHP

Установите Apache, PHP 7.2 и рекомендованные модули для DokuWiki:

apt-get install apache2 php7.2 libapache2-mod-php7.2 php7.2-common php7.2-mbstring php7.2-xmlrpc php7.2-sqlite3 php7.2-soap php7.2-gd php7.2-xml php7.2-cli php7.2-tidy php7.2-intl php7.2-json php7.2-curl php7.2-zip unzip wget git -y

Откройте файл конфигурации PHP и настройте базовые параметры:

nano /etc/php/7.2/apache2/php.ini

Измените или добавьте значения:

memory_limit = 256M
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = Asia/Kolkata

Примечание: установите date.timezone в ваш часовой пояс, например Europe/Moscow.

Запустите и включите Apache:

systemctl start apache2  
 systemctl enable apache2

Скачивание и установка DokuWiki

Скачайте стабильную ветку DokuWiki в корень веб-сервера:

cd /var/www/html/  
 git clone --branch stable https://github.com/splitbrain/dokuwiki.git

Установите права владельца и доступы:

chown -R www-data:www-data /var/www/html/dokuwiki/  
 chmod -R 755 /var/www/html/dokuwiki/

Это дает веб-серверу право записывать в нужные каталоги, но держит общий доступ ограниченным.

Конфигурация Apache для DokuWiki

Создайте виртуальный хост:

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

Добавьте конфигурацию (замените ServerName и ServerAdmin на актуальные):


     ServerAdmin [email protected]
     DocumentRoot /var/www/html/dokuwiki
     ServerName example.com

     
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     

     ErrorLog ${APACHE_LOG_DIR}/doku_error.log
     CustomLog ${APACHE_LOG_DIR}/doku_access.log combined
    
     
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]

Включите сайт и модуль перезаписи URL, затем перезапустите Apache:

a2ensite dokuwiki.conf

a2enmod rewrite  
 systemctl restart apache2

Проверка статуса сервиса:

systemctl status apache2

Вы должны увидеть, что apache2 активен и работает. Если есть ошибки при старте, проверьте синтаксис конфигов командой apachectl configtest.

Доступ к веб-интерфейсу установки

Откройте браузер и перейдите на:

http://example.com/install.php

Вы увидите страницу установщика. Заполните поля суперпользователя: логин, email, пароль и нажмите Save.

Страница установщика DokuWiki

Настройка суперпользователя и пароля в веб-инсталлере:

Установка имени и пароля

После успешной установки перейдите к своему вики:

DokuWiki успешно установлена

Кликните Login и введите данные администратора:

Страница входа в DokuWiki

После входа вы увидите панель управления DokuWiki:

Добро пожаловать в DokuWiki

Поздравляем — DokuWiki установлена и готова к использованию.

Критерии приёмки

Доступ к http://example.com без ошибок и перенаправлений.
Веб-инсталлер открылся и успешно принял данные суперпользователя.
Вход под суперпользователем работает.
Запись страниц в файловую систему успешна (права и владельцы корректны).

Контрольные действия и рольовые чек-листы

Администратор:

Подтвердить работу Apache и PHP.
Проверить права на /var/www/html/dokuwiki.
Настроить резервное копирование каталогов conf и data.

DevOps:

Настроить HTTPS через Let’s Encrypt.
Включить регулярные обновления системы.
Мониторить использование диска и логи.

Редактор/контрибутор:

Проверить создание и редактирование страниц.
Настроить шаблоны и плагины при необходимости.

Быстрый план резервного копирования и обновления

Резервная копия файлов DokuWiki: архив /var/www/html/dokuwiki.
Бэкап конфигурации Apache и php.ini.
Экспорт важных страниц вручную или через плагины.
При обновлении: сначала бэкап, затем git pull и тест в staging.

Безопасность и рекомендации

Включите HTTPS: используйте certbot для автоматического выпуска сертификата.
Ограничьте доступ к панели администрирования по IP, если возможно.
Держите права на файлы минимум необходимыми (www-data владелец, права 755 на каталоги).
Отключите ненужные PHP-модули.
Регулярно обновляйте систему и плагины DokuWiki.

Альтернативные подходы

Установка из tarball: скачайте архив ZIP с релизом вместо git clone.
Docker: запустите контейнер с PHP и Nginx/Apache для изоляции.
Пакеты: некоторые дистрибутивы предоставляют сборки DokuWiki в репозитории.

Когда установка может не пройти и как это исправить

Ошибка прав доступа: проверьте chown и chmod, убедитесь, что www-data владеет папками.
PHP недостающие модули: просмотрите вывод php -m и установите отсутствующие модули.
Ошибки Apache: проверьте apachectl configtest и логи в /var/log/apache2/.
Веб-инсталлер не запускается: убедитесь, что index.php доступен и Rewrite работает.

Короткий план отладки (runbook)

Проверить статус Apache: systemctl status apache2.
Проверить синтаксис конфигурации: apachectl configtest.
Посмотреть логи ошибок: tail -n 200 /var/log/apache2/error.log.
Проверить права: ls -la /var/www/html/dokuwiki.
Проверить версию PHP: php -v.

Совместимость и миграция

DokuWiki не требует СУБД, поэтому миграция сводится к копированию каталога data и conf.
При переносе между версиями PHP проверьте совместимость плагинов.

Краткая методология принятия решений

Если нужен простой, быстрый в разворачивании вики без СУБД — выбирайте DokuWiki.
Если требуется масштабируемая вики с реляционной базой — рассмотрите альтернативы.

1‑строчная глоссарий

DokuWiki — вики на PHP, хранящая содержимое в текстовых файлах.

Итог и дальнейшие шаги

Настройте HTTPS и автоматические бэкапы.
Установите плагины и шаблоны, необходимые для вашего рабочего процесса.
Обучите участников, как создавать и править страницы.

Ресурсы для продолжения: официальная документация DokuWiki, плагины и сообщество пользователей.