在 Ubuntu 22.04 系统上安装配置 WonderCMS 轻量级 CMS 建站教程

本教程适用于以下操作系统版本

Ubuntu 22.04（Jammy Jellyfish）
Ubuntu 18.04（Bionic Beaver）

本页内容

先决条件
安装 Nginx 和 PHP
在 Ubuntu 22.04 上安装 WonderCMS
为 WonderCMS 配置 Nginx
访问 WonderCMS Web 界面
使用 Let's Encrypt SSL 保护 WonderCMS
结论

WonderCMS 是一个开源的、极小的扁平文件 CMS，提供了一种简单、便捷的方式来创建和管理网站。它由 PHP 和 jQuery 编写，无需任何配置。它具备现代 CMS 所拥有的所有必要功能。它快速、响应灵敏，并且不需要任何数据库。它提供了一个用户友好的 Web UI，仅含一个基本的下拉菜单，同时在您的页面上启用了行内编辑控件。

本教程将向您展示如何在 Ubuntu 22.04 上使用 Nginx 和 Let's Encrypt SSL 安装 WonderCMS。

先决条件

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

安装 Nginx 和 PHP

首先，您需要在服务器上安装 Nginx Web 服务器、PHP 以及其他依赖项。您可以通过运行以下命令来安装它们全部：

apt-get install nginx php php-fpm php-mbstring php-curl php-zip -y

所有软件包安装完成后，编辑 PHP 配置文件并修改一些默认设置：

nano /etc/php/8.1/fpm/php.ini

修改以下设置：

upload_max_filesize = 100MB
post_max_size = 100MB
max_execution_time = 300
max_input_vars = 5000
memory_limit = 256M
date.timezone = "UTC"

保存并关闭文件，然后重启 PHP-FPM 服务以使更改生效：

systemctl restart php8.1-fpm

在 Ubuntu 22.04 上安装 WonderCMS

首先，您需要使用以下命令从 GitHub 下载最新版本的 WonderCMS：

wget https://github.com/robiso/wondercms/releases/download/3.3.4/wondercms-334.zip

下载完成后，使用以下命令将下载的文件解压到 Nginx Web 根目录：

unzip wondercms-334.zip -d /var/www/html

接下来，使用以下命令更改 WonderCMS 的所有者和权限：

chown -R www-data:www-data /var/www/html/wondercms
chmod -R 775 /var/www/html/wondercms

完成后，您可以继续进行下一步。

为 WonderCMS 配置 Nginx

接下来，您需要创建一个 Nginx 虚拟主机配置文件，以通过 Nginx 托管 WonderCMS。您可以使用以下命令创建它：

nano /etc/nginx/conf.d/wondercms.conf

添加以下行：

server {
        listen 80;
        # adapt to your server name
        server_name wondercms.example.com;
        # adapt the path
        root /var/www/html/wondercms;
        index index.php;
        # prevent directory listing
        autoindex off;

        # rewrite url to make it pretty
        location / {
            try_files $uri $uri/ @rewrite;
        }
            location @rewrite {
            rewrite ^/(.+)$ /index.php?page=$1 last;
        }

        # prevent access to database.js
        location ~ database.js {
            return 403;
        }

        location ~ cache.json {
            return 403;
        }

        # use php-fpm for dealing with php files

location ~ \.php$ {
      fastcgi_pass unix:/run/php/php-fpm.sock;

      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      include fastcgi_params;
      include snippets/fastcgi-php.conf;
      fastcgi_buffer_size 128k;
      fastcgi_buffers 4 128k;
      fastcgi_intercept_errors on; 
        }
    }

保存并关闭文件，然后使用以下命令检查 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 - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-11-12 14:06:21 UTC; 7s ago
       Docs: man:nginx(8)
    Process: 18137 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 18139 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 18140 (nginx)
      Tasks: 3 (limit: 464122)
     Memory: 3.4M
     CGroup: /system.slice/nginx.service
             ??18140 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"
             ??18141 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
             ??18142 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

Nov 12 14:06:21 ubuntu22041 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 12 14:06:21 ubuntu22041 systemd[1]: Started A high performance web server and a reverse proxy server.