更新工具包
注：此更新步骤仅为建议，非必须
sudo yum -y update
sudo yum -y install vim bash-completion wget tar
更新后重启系统
sudo reboot
安装工具包
sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum makecache fast
sudo yum-config-manager --disable remi-php54
sudo yum-config-manager --enable remi-php72
安装 php 和 Nginx
注：若二者已安装，此步可跳过
sudo yum -y install php-cli php-fpm php-mysql php-zip php-ldap
sudo yum -y install php-devel php-gd php-mcrypt php-mbstring
sudo yum -y install php-curl php-xml php-pear php-bcmath
安装好了后，检查一下 php 版本
php -v
若正常，会显示如下信息：
PHP 7.2.10 (cli) (built: Sep 11 2018 11:22:20) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
注：此处略去安装 Nginx 过程，如有需要，请参考其他教程
安装 Dokuwiki
下载前，先到 Github 检查一下它的最新稳定版本，此处假设为"2018-04-22b"
export RELEASE="2018-04-22b"
wget https://github.com/splitbrain/dokuwiki/archive/release_stable_${RELEASE}.tar.gz
解压下载的安装包，并转移到新建的文件夹 /var/www/html/ 中
tar xvf release_stable_${RELEASE}.tar.gz
sudo mkdir -p /var/www/html/
sudo mv dokuwiki-release_stable_${RELEASE} /var/www/html/dokuwiki
将文件夹 /var/www/html/dokuwiki 所有者权限修改为 nginx_user:nginx_group
注1：更改文件夹的所有者权限，方便 Nginx 有权访问该文件夹中的内容；此处假设 Nginx 进程运行在 nginx_user:nginx_group 下面，如果不是，则相应修改
注2：查看 nginx 所属用户 username 的办法为ps aux | grep nginx
注3：查看某个用户 username 所属组的方法为groups username
sudo chown -R nginx_user:nginx_group /var/www/html/dokuwiki
安装 SSL 证书
目的：支持使用 https 访问
安装 certbot-auto 到本地的 /usr/local/bin 下
目的：方便从 Letsencrypt 机构申请免费证书并简化后续的证书到期更新工作
注：若已安装过 certbot-auto 此步骤可略过
sudo wget https://dl.eff.org/certbot-auto -P /usr/local/bin
sudo chmod a+x /usr/local/bin/certbot-auto
配置 pip 国内源
注：若之前已配置，请跳过此步骤；此步骤的目的是加速 CertBot 下载 python 模块的速度
# 新建 .pip 文件夹并进入
mkdir .pip && cd .pip
# 创建 pip.conf 文件
vi pip.conf
# 在 pip.conf 文件中输入以下内容
[global]
index-url=http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host=mirrors.aliyun.com
# 保存退出
运行脚本，安装依赖
/usr/local/bin/certbot-auto --help
配置 nginx
目的：获取域名证书过程中， Let's Encrypt 会对域名发起访问，以确认申请者对域名的所有权；故需要配置 nginx，以便能够对 Let's Encrypt 的访问返回正确的响应；
# 创建文件夹，用于 Let's Encrypt 访问时返回响应内容
mkdir /home/letsencrypt
# 打开 nginx 配置文件进行编辑，此处假设 nginx 的配置文件在以下路径：/usr/local/nginx/conf/nginx.conf，如不是，则相应修改路径
vi /usr/local/nginx/conf/nginx.conf
// 在 nginx 配置文件中，找到 http，添加一条监听 80 端口的新 server
http {
//...(略)...
// 添加如下内容，此处假设申请域名为 domain.example.com，请修改为实际申请的域名
server {
listen 80;
server_name domain.example.com;
location ~ /.well-known/acme-challenge/ {
defaulf_type "text/plain";
root /home/letsencrypt/;
}
}
// ......以下略......
重启 nginx
# 此处假设 nginx 可执行文件在路径 /usr/local/nginx/sbin 下面，如不是则相应修改路径
# 先使用 -t 参数测试配置文件格式是否正确
/usr/local/nginx/sbin/nginx -t
# 若正确，屏幕上将显示以下字样
> nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
# 重启 Nginx
/usr/local/nginx/sbin/nginx -s reload
运行脚本，申请证书
# 此处为域名 domain.example.com 申请一张证书，其中的 youremail.com 请替换为你自己的邮箱地址
/usr/local/bin/certbot-auto certonly --email youremail.com --webroot -w /home/letsencrypt -d domain.example.com
申请成功后，界面下会有如下的成功提示：
IMPORTANT NOTES:
- Congratulations! Your certificate and chain have been saved at
/etc/letsencrypt/live/helloworld.com/fullchain.pem. Your cert
will expire on 2019-08-26. To obtain a new version of the
certificate in the future, simply run Let's Encrypt again......
注：记下以上提示信息中的 fullchain.pem 和 privkey.pem 两个文件路径，后续配置 nginx 会用到
配置 Nginx
打开 nginx 配置文件
# 配置文件的路径请根据实际情况修改
vi /usr/local/nginx/conf/nginx.conf
在nginx 配置文件中，新增两个 server 条目，内容如下：
server {
listen 443 ssl;
# 注意替换此处的域名
server_name domain.example.com;
root /var/www/html/dokuwiki;
access_log /var/log/dokuwiki.access.log;
error_log /var/log/dokuwiki.error.log;
ssl on;
# 注意替换此处的 fullchain.pem 和 privkey.pem 的路径为正确的实际路径
ssl_certificate /etc/letsencrypt/live/domain.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/domain.example.com/privkey.pem;
ssl_session_timeout 5m;
ssl_ciphers 'AES128+EECDH:AES128+EDH:!aNULL';
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
index index.html index.php doku.php;
location / {
try_files $uri $uri/ @dokuwiki;
}
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 ~ /(data|conf|bin|inc)/ {
deny all;
}
location ~* \.(css|js|gif|jpe?g|png)$ {
expires 1M;
add_header Pragma public;
add_header Cache-Control "public, must-revalidate, proxy-revalidate";
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_intercept_errors off;
fastcgi_buffer_size 16k;
fastcgi_buffers 4 16k;
}
location ~ /\.ht {
deny all;
}
}
# 若想支持 80 端口访问，则可以在原监听 80 端口的 server 条目中添加一些信息
server {
listen 80;
server_name domain.example.com;
location ~ /.well-known/acme-challenge/ {
defaulf_type "text/plain";
root /home/letsencrypt/;
}
# 以上是 location 原申请证书时已写好的信息，下面的新 location 是需要新添加的信息
location / {
add_header Strict-Transport-Security max-age=2592000;
rewrite ^ https://$host$request_uri? permanent;
}
}
配置 php-fpm
打开以下 php-fpm 中的文件
sudo vim /etc/php-fpm.d/www.conf
将文件中以下几个键的值设置为如下：
# 注意替换此处的 nginx_user 和 nginx_group 为实际的用户名和用户组
user = nginx_user
group = nginx_group
listen = /var/run/php-fpm/php-fpm.sock
listen.owner = nginx_user
listen.group = nginx_group
listen.mode = 0660
启动 nginx 和 php-fpm
sudo systemctl start php-fpm
sudo systemctl enable php-fpm
重启 Nginx
# 先使用 -t 参数测试配置文件格式是否正确
/usr/local/nginx/sbin/nginx -t
# 若正确，屏幕上将显示以下字样
> nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
# 重启 Nginx
/usr/local/nginx/sbin/nginx -s reload
配置 DokuWiki
使用浏览器打开网址：https://domain.example.com/install.php，打开后页面如下，配置方法请参考其他教程
注：domain.example.com 请相应替换为实际域名
image
其他
Letsenctrypt 的证书有效期为三个月，当剩余一个月时，Letsenctrypt 会发通知邮件到预留的邮箱；收到通知后，只需要登录服务器，运行相关命令，即可自动更新证书
# 先使用 --dry-run 选项进行测试，非真正执行更新
/usr/local/bin/certbot-auto renew --dry-run
若显示如下字样，则表示自动更新功能测试成功
Congratulations, all renewals succeeded. The following certs have been renewed:
/etc/letsencrypt/live/www.helloworld.com/fullchain.pem (success)
** DRY RUN: simulating 'certbot renew' close to cert expiry
** (The test certificates above have not been saved.)
运行以下实际的更新命令，更新完了后，记得重启 nginx 服务器，以便启用新的证书
/usr/local/bin/certbot-auto renew -v