Поиск по сайту:

Как установить «Докувики» на Ubuntu 22.04

Это руководство существует для этих версий ОС

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

На этой странице

  1. Предпосылки
  2. Установите Apache и PHP
  3. Установите «ДокуВики» Ubuntu 22.04.
  4. Создание виртуального хоста Apache для «Докувики»
  5. Включить SSL на веб-сайте «ДокуВики»
  6. Доступ к «Докувики»
  7. Настройка автоматического продления
  8. Заключение

«Докувики» — это простое, удобное в использовании и многофункциональное вики-программное обеспечение, написанное на PHP. Он бесплатный, с открытым исходным кодом и использует простой формат файла для хранения своих данных вместо использования какой-либо системы баз данных. Он предлагает множество функций, которые помогут вам легко масштабировать и оптимизировать ваш вики-сайт. Он набирает популярность благодаря чистому и удобочитаемому синтаксису. Используя «Докувики», вы можете создавать свои личные или деловые веб-сайты через веб-панель «Докувики».

В этом руководстве мы покажем вам, как установить «Докувики» с Apache и SSL-сертификатом Lets Encrypt в Ubuntu 22.04.

Предпосылки

  • Сервер под управлением Ubuntu 22.04.
  • Действительное доменное имя указывает на ваш сервер.
  • На вашем сервере настроен пароль root.

Установите Апач и PHP

Во-первых, вам нужно будет установить веб-сервер Apache, PHP и другие библиотеки PHP в вашей системе. Вы можете установить их все, выполнив следующую команду:

apt-get install apache2 php php-gd php-xml php-json -y

после установки всех пакетов запустите службу Apache и включите ее запуск при загрузке с помощью следующей команды:

systemctl start apache2
systemctl enable apache2

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

Установите «ДокуВики» Ubuntu 22.04.

Затем посетите официальную страницу загрузки «ДокуВики», скопируйте URL-адрес загрузки и загрузите последнюю версию «ДокуВики» с помощью следующей команды:

wget https://download.dokuwiki.org/out/dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz

После завершения загрузки создайте каталог «ДокуВики» внутри корневого веб-каталога Apache и извлеките «ДокуВики»:

mkdir /var/www/html/dokuwiki
tar -xvzf dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz -C /var/www/html/dokuwiki/ --strip-components=1

Затем скопируйте образец файла .htaccess с помощью следующей команды:

cp /var/www/html/dokuwiki/.htaccess{.dist,}

Затем измените владельца dokuwiki на www-data:

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

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

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

Далее вам нужно будет создать файл конфигурации виртуального хоста Apache для обслуживания веб-сайта «ДокуВики». Вы можете создать его с помощью следующей команды

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

Добавьте следующие строки:

<VirtualHost *:80>
        ServerName    doku.example.com      
        DocumentRoot  /var/www/html/dokuwiki

        <Directory ~ "/var/www/html/dokuwiki/(bin/|conf/|data/|inc/)">
            <IfModule mod_authz_core.c>
                AllowOverride All
                Require all denied
            </IfModule>
            <IfModule !mod_authz_core.c>
                Order allow,deny
                Deny from all
            </IfModule>
        </Directory>

        ErrorLog   /var/log/apache2/dokuwiki_error.log
        CustomLog  /var/log/apache2/dokuwiki_access.log combined
</VirtualHost>

Сохраните и закройте файл, когда закончите. Затем включите файл конфигурации виртуального хоста DokuWiki и перезагрузите службу Apache с помощью следующей команды:

a2ensite dokuwiki.conf
systemctl reload apache2

Теперь вы можете проверить статус Apache с помощью следующей команды:

systemctl status apache2

Вы должны увидеть следующий вывод:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-06-25 15:44:31 UTC; 4min 30s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 52450 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 52131 (apache2)
      Tasks: 6 (limit: 4579)
     Memory: 16.9M
        CPU: 331ms
     CGroup: /system.slice/apache2.service
             ??52131 /usr/sbin/apache2 -k start
             ??52454 /usr/sbin/apache2 -k start
             ??52455 /usr/sbin/apache2 -k start
             ??52456 /usr/sbin/apache2 -k start
             ??52457 /usr/sbin/apache2 -k start
             ??52458 /usr/sbin/apache2 -k start

Jun 25 15:44:30 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

На этом этапе веб-сервер Apache настроен для обслуживания сайта «ДокуВики». Теперь вы можете приступить к установке Lets Encrypt SSL на свой сайт.

Включить SSL на веб-сайте «ДокуВики»

Чтобы включить SSL в «ДокуВики», вам необходимо установить клиент Certbot в вашей системе. Certbot — это инструмент Lets Encrypt, используемый для загрузки и управления SSL.

Вы можете установить Certbot с помощью следующей команды:

apt-get install certbot python3-certbot-apache -y

После установки выполните следующую команду, чтобы установить Lets Encrypt SSL для вашего веб-сайта:

certbot --apache -d dokuwiki.linuxbuz.com

Вам будет предложено указать действующий адрес электронной почты и принять условия обслуживания, как показано ниже:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): 

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

Obtaining a new certificate
Performing the following challenges:
http-01 challenge for dokuwiki.linuxbuz.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabled Apache socache_shmcb module
Enabled Apache ssl module
Deploying Certificate to VirtualHost /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabling available site: /etc/apache2/sites-available/dokuwiki-le-ssl.conf

Затем выберите, следует ли перенаправлять HTTP-трафик на HTTPS, как показано ниже:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Введите 2 и нажмите Enter, чтобы начать процесс. После завершения установки вы должны получить следующий вывод:

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/dokuwiki.conf to ssl vhost in /etc/apache2/sites-available/dokuwiki-le-ssl.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://dokuwiki.linuxbuz.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=dokuwiki.linuxbuz.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/dokuwiki.linuxbuz.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/dokuwiki.linuxbuz.com/privkey.pem
   Your cert will expire on 2020-09-05. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

На данный момент ваш сайт «Докувики» защищен с помощью Lets Encrypt SSL.

Доступ к «Докувики»

Теперь откройте веб-браузер и введите URL-адрес https://dokuwiki.linuxbuz.com/install.php. Вы должны увидеть экран установки «ДокуВики»:

Укажите свое имя вики, имя пользователя администратора, пароль, адрес электронной почты, выберите свою политику и нажмите кнопку «Сохранить». Вы будете перенаправлены на следующую страницу:

Нажмите на \ваша новая ДокуВики\. Вы должны увидеть следующий экран:

Нажмите кнопку «Войти». Вы будете перенаправлены на экран входа в «ДокуВики», как показано ниже:

Укажите имя пользователя и пароль администратора и нажмите кнопку «Войти». Вы должны увидеть панель инструментов «ДокуВики» на следующем экране:

Настройка автоматического продления

По умолчанию сертификаты Let’s Encrypt действительны в течение 90 дней. Итак, вам нужно будет настроить задание cron для автоматического обновления сертификата SSL. Безопасно создавать задание cron, которое выполняется каждую неделю или даже каждый день.

Если вы хотите обновить сертификат SSL вручную, выполните следующую команду:

certbot renew --dry-run

Вы можете настроить задание cron для автоматического обновления сертификата SSL каждый день в 6:00, отредактировав следующий файл:

crontab -e

Добавьте следующую строку:

00 06 * * *   root /usr/bin/certbot renew >/dev/null 2>&1

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

Заключение

Поздравляем! вы успешно установили «ДокуВики» и защитили ее с помощью Lets Encrypt SSL в Ubuntu 22.04. Теперь вы можете создать свой собственный вики-сайт с помощью DokuWiki. Не стесняйтесь спрашивать меня, если у вас есть какие-либо вопросы.