在 AlmaLinux 上使用 Nginx 和 Let's Encrypt SSL 安装 DokuWiki

本页目录

准备工作
安装 Nginx 和 PHP
在 Alma Linux 8 上安装 DokuWiki
为 DokuWiki 创建 Nginx 虚拟主机
访问 DokuWiki Web 管理界面
使用 Let's Encrypt 保护 DokuWiki
总结

DokuWiki 是一款开源的、基于 Web 的维基软件，主要为 Linux 系统设计。它通过简单直观的 Web 界面，允许用户创建和编辑内容，从而实现协作式文档编写与知识管理。DokuWiki 以轻量、易安装而著称，它不需要数据库，因此非常适合小型组织或项目使用。其强大的文本格式化能力、版本控制以及丰富的插件生态，使其成为在 Linux 环境下创建和维护文档、知识库和网站的通用工具。

本教程将向您展示如何在 Alma Linux 上使用 Nginx 安装 DokuWiki。

准备工作

一台运行 Alma Linux 8 的服务器。
一个已指向您服务器 IP 的有效域名。
服务器上已配置 root 密码。

安装 Nginx 和 PHP

默认情况下，Alma Linux 8 的默认仓库中不包含最新版本的 PHP。因此，您需要在系统上安装 EPEL 和 Remi 仓库。

您可以通过运行以下命令来安装两者：

dnf install epel-release -y
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y

两个软件包安装完成后，使用以下命令启用 PHP Remi 仓库：

dnf module enable php:remi-7.4 -y

您应该会看到如下输出：

Dependencies resolved.
==============================================================================================================================================
 Package                           Architecture                     Version                           Repository                         Size
==============================================================================================================================================
Enabling module streams:
 php                                                                remi-7.4                                                                 

Transaction Summary
==============================================================================================================================================

Complete!

接下来，使用以下命令安装 Nginx Web 服务器、PHP 以及其他所需扩展：

dnf install nginx php php-cli php-fpm php-gd php-xml php-zip -y

所有软件包安装完成后，编辑 PHP-FPM 配置文件，并修改 listen、user 和 group 设置：

nano /etc/php-fpm.d/www.conf

修改以下行：

user = nginx
group = nginx

保存并关闭文件，然后使用以下命令启动并设置 Nginx 和 PHP-FPM 服务开机自启：

systemctl start nginx php-fpm
systemctl enable nginx php-fpm

您也可以运行以下命令验证 PHP 版本：

php --version

您将得到如下输出：

PHP 7.4.28 (cli) (built: Feb 15 2022 13:23:10) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.28, Copyright (c), by Zend Technologies

在 Alma Linux 8 上安装 DokuWiki

接下来，您需要从其官方网站下载最新版本的 DokuWiki。您可以使用以下命令进行下载：

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

下载完成后，在 Nginx 网站根目录中为 DokuWiki 创建一个目录：

mkdir /var/www/html/dokuwiki

接下来，使用以下命令解压下载的文件：

tar xvf dokuwiki-stable.tgz

接下来，将解压后的目录移动到 DokuWiki 目录：

mv dokuwiki-2020-07-29/* /var/www/html/dokuwiki/

接下来，将 DokuWiki 目录的所有权更改为 Nginx：

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

完成后，您可以进入下一步。

为 DokuWiki 创建 Nginx 虚拟主机

接下来，使用以下命令为 DokuWiki 创建 Nginx 配置文件：

nano /etc/nginx/conf.d/dokuwiki.conf

添加以下行：

server {
    listen 80;
    server_name wiki.example.com;
    root /var/www/html/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/ { return 403; }
    location ^~ /data/ { return 403; }
    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-fpm/www.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

保存并关闭文件，然后使用以下命令检查 Nginx 是否存在语法错误：

nginx -t

您将得到如下输出：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

最后，重启 Nginx 服务以使更改生效：

systemctl restart nginx

您也可以运行以下命令查看 Nginx 的状态：

systemctl status nginx

您将得到如下输出：

? nginx.service - The nginx HTTP and reverse proxy server
   Loaded: loaded (/usr/lib/systemd/system/nginx.service; disabled; vendor preset: disabled)
  Drop-In: /usr/lib/systemd/system/nginx.service.d
           ??php-fpm.conf
   Active: active (running) since Sat 2022-03-26 04:26:32 UTC; 4s ago
  Process: 5020 ExecStart=/usr/sbin/nginx (code=exited, status=0/SUCCESS)
  Process: 5018 ExecStartPre=/usr/sbin/nginx -t (code=exited, status=0/SUCCESS)
  Process: 5017 ExecStartPre=/usr/bin/rm -f /run/nginx.pid (code=exited, status=0/SUCCESS)
 Main PID: 5022 (nginx)
    Tasks: 2 (limit: 11412)
   Memory: 3.8M
   CGroup: /system.slice/nginx.service
           ??5022 nginx: master process /usr/sbin/nginx
           ??5023 nginx: worker process

Mar 26 04:26:32 linux systemd[1]: nginx.service: Succeeded.
Mar 26 04:26:32 linux systemd[1]: Stopped The nginx HTTP and reverse proxy server.
Mar 26 04:26:32 linux systemd[1]: Starting The nginx HTTP and reverse proxy server...
Mar 26 04:26:32 linux nginx[5018]: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
Mar 26 04:26:32 linux nginx[5018]: nginx: configuration file /etc/nginx/nginx.conf test is successful
Mar 26 04:26:32 linux systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Mar 26 04:26:32 linux systemd[1]: Started The nginx HTTP and reverse proxy server.