发表 admin at 2025年2月28日

类别

未分类

标签

如何使用 Nginx 安装 DokuWiki 并让我们在 CentOS 8 上加密 SSL

在此页

要求
先决条件
初始步骤
第 1 步 - 安装 PHP 和 PHP 扩展
第 2 步 - 安装 acme.sh 客户端并获取 Lets Encrypt 证书（可选）
第 3 步 - 安装和配置 Nginx
第 4 步 - 安装 DokuWiki
第 5 步 - 访问 DokuWiki 网络界面
链接

DokuWiki 是一种简单易用且用途广泛的开源 wiki 软件，不需要数据库。它以其简洁易读的语法而受到用户的喜爱。易于维护、备份和集成，使其成为管理员的最爱。内置的访问控制和身份验证连接器使 DokuWiki 在企业环境中特别有用，其充满活力的社区贡献的大量插件允许超越传统 wiki 的广泛用例。本教程将向您展示如何在全新的 CentOS 8 服务器上安装 DokuWiki。

要求

确保您的服务器满足以下要求。

支持 PHP 的网络服务器软件（Apache、NGINX、IIS、Lighttpd、LiteSpeed）
PHP 版本 5.6 或更高版本，强烈推荐更新版本。

先决条件

CentOS 8 操作系统。
具有 sudo 权限的非根用户。

初始步骤

检查您的 CentOS 版本：

cat /etc/centos-release
# CentOS Linux release 8.0.1905 (Core)

设置时区：

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

更新您的操作系统包（软件）。这是重要的第一步，因为它确保您拥有操作系统默认软件包的最新更新和安全修复程序：

sudo dnf update -y

安装 CentOS 操作系统基本管理所需的一些基本软件包：

sudo dnf install -y curl wget vim git unzip socat bash-completion epel-release

第 1 步 - 安装 PHP 和 PHP 扩展

安装 PHP 和所需的 PHP 扩展：

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

要显示在模块中编译的 PHP，您可以运行：

php -m

ctype
curl
exif
fileinfo
. . .
. . .

检查 PHP 版本：

php --version

# PHP 7.2.11-1-(cli) (built: Oct 26 2019 14:14:18) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.3.11, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.3.11-1~deb10u1, Copyright (c) 1999-2018, by Zend Technologies

启动并启用 PHP-FPM 服务：

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

第 2 步 - 安装 acme.sh 客户端并获取 Lets Encrypt 证书（可选）

没有必要使用 HTTPS 保护您的网站，但这是保护网站流量的好做法。要从 Lets Encrypt 获取 TLS 证书，我们将使用 acme.sh 客户端。 Acme.sh 是一个简单的 UNIX shell 软件，用于以零依赖从 Lets Encrypt 获取 TLS 证书。

下载并安装 acme.sh：

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail 
source ~/.bashrc
cd ~

检查 acme.sh 版本：

acme.sh --version
# v2.8.2

为您的域/主机名获取 RSA 和 ECC/ECDSA 证书：<br>

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

如果你想要假证书进行测试，你可以在上面的命令中添加 --staging 标志。

运行上述命令后，您的证书和密钥将位于：

对于 RSA：/home/username/example.com 目录。
对于 ECC/ECDSA：/home/username/example.com_ecc 目录。

要列出您颁发的证书，您可以运行：

acme.sh --list

创建一个目录来存储您的证书。我们将使用 /etc/letsencrypt 目录。

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

安装/复制证书到 /etc/letsencrypt 目录。

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

所有证书将每 60 天自动更新一次。

获得证书后，从 root 用户退出并返回到普通 sudo 用户：

exit

第 3 步 - 安装和配置 Nginx

DokuWiki 将在任何支持 PHP 的网络服务器上运行。在本教程中，我们将使用 Nginx。如果您更喜欢 Apache 或其他 Web 服务器，则可以使用它来代替 Nginx。

从 CentOS 存储库下载并安装 NGINX：

sudo dnf install -y nginx

检查 Nginx 版本：

sudo nginx -v
# nginx version: nginx/1.14.2

配置 Nginx：

sudo vim /etc/nginx/conf.d/dokuwiki.conf

复制/粘贴以下 Nginx 配置并保存：

server {

    listen [::]:443 ssl;
    listen 443 ssl;
    listen [::]:80;
    listen 80;
    # RSA
    ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/example.com/private.key;
    # ECC
    ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;

    server_name wiki.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;
    
    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 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

检查 Nginx 配置：

sudo nginx -t

重新加载 Nginx：

sudo systemctl reload nginx.service

第 4 步 - 安装 DokuWiki

创建文档根目录：

sudo mkdir -p /var/www/dokuwiki

导航到文档根目录：

cd /var/www/dokuwiki

从 DokuWiki 下载页面下载最新稳定版的 DokuWiki：

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

解压 DokuWiki tarball：

sudo tar xvf dokuwiki-stable.tgz
sudo rm dokuwiki-stable.tgz
sudo mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .
sudo rmdir dokuwiki-2018-04-22b/

将 /var/www/dokuwiki 目录的所有权更改为 www-data:

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

运行 sudo vim /etc/php-fpm.d/www.conf 并将用户和组设置为 nginx。最初，它将设置为用户和组 apache。

sudo vim /etc/php-fpm.d/www.conf

重启php7.3-fpm.service:

sudo systemctl restart php7.3-fpm.service

在浏览器中打开 DokuWiki 安装脚本 install.php 并安装 DokuWiki。安装脚本检查所需 PHP 函数的可用性并检查所需的文件权限。它还会创建一个初始管理员帐户和一个初始 ACL 策略。要运行安装程序，请在浏览器中打开 http://wiki.example.com/install.php 并按照说明进行操作。