====== Установка DokuWiki на Debian 12 ======

Официальная инструкция по установке

[[https://www.dokuwiki.org/ru:install]]


Системные требования

[[https://www.dokuwiki.org/ru:requirements]]


===== Установка =====

Установить пакеты

<code>
apt-get install nginx php8.2-fpm php8.2-gd php8.2-xml
</code>

Скачать архив с DokuWiki

[[https://download.dokuwiki.org/]]


Распаковать архив

<code>
tar -xzvf dokuwiki-*.tgz
</code>

Скопировать архив в /var/www/ или другое место

<code>
cp -R dokuwiki /var/www/
</code>

Изменить владельца файлов для веб-сервера

<code>
chown -R www-data:www-data /var/www/dokuwiki/
</code>


===== Настройка Nginx =====

Создать конфигурацию сайта в ngnix

<code>
nano /etc/nginx/conf.d/dokuwiki.conf
</code>

Добавить и отредактировать настройку

<code>
server {

    listen 80;
    server_name localhost;
    root /var/www/dokuwiki;
    index index.html index.htm index.php doku.php;
    client_max_body_size 15M;
    client_body_buffer_size 128K;

    location / {
        try_files $uri $uri/ @dokuwiki;
    }

    location ~ /(conf|bin|inc)/ {
        deny all;
    }

    location /data/ {
        internal;
    }

    location ~ /\.ht {
        deny all;
    }

    location @dokuwiki {
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1 last;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}
</code>

Проверить добавленную конфигурацию

<code>
nginx -t
</code>

Применить конфигурацию если все в порядке

<code>
nginx -s reload
</code>


===== Настройка HTTPS =====

SSL Let’s Encrypt SSL/TLS

<code>
apt-get install certbot python3-certbot-nginx
</code>

Регистрация и выпуск сертификата, почту и домен заменить на свой

<code>
certbot register --email example@example.com
certbot certonly --nginx -d example.com -d www.example.com
</code>

Сертификаты будут лежать в каталогах

> Certificate is saved at: /etc/letsencrypt/live/**example.com**/fullchain.pem
> Key is saved at:         /etc/letsencrypt/live/**example.com**/privkey.pem

Отредактировать настройку nginx

<code>
nano /etc/nginx/conf.d/dokuwiki.conf
</code>

<code>
server {

    listen 80;
    listen 443 ssl;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    server_name example.com;
    root /var/www/dokuwiki;
    index index.html index.htm index.php doku.php;
    client_max_body_size 15M;
    client_body_buffer_size 128K;

    if ($scheme != "https") {
        return 301 https://$host$request_uri;
    }

    location / {
        try_files $uri $uri/ @dokuwiki;
    }

    location ~ /(conf|bin|inc)/ {
        deny all;
    }

    location /data/ {
        internal;
    }

    location ~ /\.ht {
        deny all;
    }

    location @dokuwiki {
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1 last;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}
</code>


===== Завершение =====

Перейти на сайт для настройки

[[http://localhost/install.php]]


Инструкция по настройке

[[https://www.dokuwiki.org/ru:installer]]


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

<code>
rm /var/www/dokuwiki/install.php
</code>