【调试笔记-20240525-Windows-配置 QEMU/x86_64 运行 OpenWrt-23.05 发行版并搭建 WordPress 博客网站】

调试笔记-系列文章目录

调试笔记-20240525-Windows-配置 QEMU/x86_64 运行 OpenWrt-23.05 发行版并搭建 WordPress 博客网站

前言

本文记录在 Windows 环境下使用 QEMU 运行 OpenWrt-23.05 发行版本的方法。

实验使用的电脑如下：

CPU：

Intel Core i5 8265U

操作系统：

Microsoft Windows 10  Professional (x64), Version 22H2, Build 19045.4412

一、调试环境

操作系统：Windows 10 专业版

操作系统详细信息如下：

Microsoft Windows 10  Professional (x64), Version 22H2, Build 19045.4412

调试环境

• Windows 系统已安装 QEMU 并成功运行 OpenWrt 发行版

参考【安装笔记-20240520-Windows-在 QEMU 中尝试运行 OpenWRT】

调试目标

在 Windows/QEMU 中运行 OpenWrt-23.05 发行版本。

说明：按照【调试笔记-20240521-Linux-编译 QEMU/x86_64 可运行的 OpenWrt 固件】编译好 OpenWrt 固件后，我们尝试配置好 QEMU ，使其完整运行 OpenWrt 各项功能，包括：

1、能上网
2、可以访问 OpenWrt 配置界面
3、开启对外的 Web 服务功能
4、提供个人博客功能
5、更多……

二、调试步骤

开启 Windows 虚拟化功能 WHPX

• 在 “启用或关闭 Windows 功能” 中勾选 “Windows 虚拟机监控程序平台"

配置上网功能

网络拓扑结构

• OpenWrt eth0： LAN
• OpenWrt 主机配置为客户设备模式，挂在 QEMU 的 SLIRP 网络中
• OpenWrt 主机 LAN 网卡开启 DHCP-client 模式，自动获取 IP 地址
• QEMU 网络设备的设置中增加 Windows 主机端口转发，将 Windows 主机的 50022 端口转发到 QEMU 访客系统（即 OpenWrt 主机）的 22 端口，从而实现从 Windows 主机通过 SSH 连接访问 OpenWrt 主机系统的功能

接下来我们一步一步实现前述功能需求。

配置 OpenWrt 远程连接

1、设置 QEMU 启动选项，输入以下命令：

..\qemu\8.2.0\qemu-system-x86_64.exe -L "D:\qkd-app\vmos\data" -cpu "Penryn,vendor=GenuineIntel,+ssse3,+sse4.2" -M  "q35,accel=whpx,kernel-irqchip=off" 	-m 4G -bios "data\ovmf.fd" -netdev "user,id=hn0,hostfwd=tcp::50022-:22" -device "e1000,netdev=hn0,id=nic1" -debugcon "file:debug.log" -global "isa-debugcon.iobase=0x402" -hda openwrt-23.05.3-x86-64-generic-ext4-combined-efi.img

2、配置 OpenWrt 主机为客户设备模式，并开启 DHCP-client 功能

在 OpenWrt 主机终端输入以下命令：

uci set network.lan.proto="dhcp"
uci commit network
service network restart

然后，输入以下命令检查 OpenWrt 主机是否正确获取到 QEMU SiLRP 网络 DHCP 服务器分配的 IP 地址

ip addr

从上图可见，OpenWrt 主机已经成功获得 10.0.2.15 的 IP 地址

3、从 Windows 主机通过 SSH 连接 OpenWrt 访客主机

主机：localhost
端口：50022

成功登录 OpenWrt 主机后，界面如下：

4、测试网络联通性

在 PuTTY 窗口输入以下命令：

ping www.baidu.com

上图可见，OpenWrt 访客主机能访问到 www.baidu.com ，网络通畅。

配置 LuCI 管理界面

5、修改管理页面 uhttpd 服务器的监听端口，输入以下命令：

uci set uhttpd.main.listen_http='0.0.0.0:50080'
uci add_list uhttpd.main.listen_http='[::]:50080'
uci set uhttpd.main.listen_https='0.0.0.0:50443'
uci add_list uhttpd.main.listen_https='[::]:50443'
uci commit uhttpd
/etc/init.d/uhttpd restart

完成后，使用 netstat 命令确认是否修改成功

netstat -a -n -t

上图可见，已经将 uhttpd 的监听端口修改到 50080 和 50443 了。

6、删除 dnsmasq 包

观察到 OpenWrt 主机的 53 端口有 dnsmasq 进程在监听，此进程提供 DHCP 和 DNS 服务，本例中我们不需要提供这两项服务，执行以下命令删除 dnsmasq 包：

opkg remove dnsmasq

重启 OpenWrt 主机后，输入以下命令确认是否删除并停止了 DHCP 和 DNS 服务：

netstat -p -a -n -t

安装 nginx Web 服务器

7、安装 nginx HTTP 服务器，执行以下命令：

opkg update
opkg install nginx-full

默认 nginx 配置给 OpenWrt 的 LuCI 使用。
因此，我们需要关闭此设置，并设置新的站点，执行以下命令：

uci set nginx.global.uci_enable=false
uci commit

接下来我们为 nginx 创建一个 example.com 的网站，执行以下命令：

uci add nginx server
uci rename nginx.@server[-1]=example_com
uci add_list nginx.example_com.listen='80'
uci add_list nginx.example_com.listen='[::]:80'
uci set nginx.example_com.server_name='example.com'
uci set nginx.example_com.client_header_timeout='10s'
uci add_list nginx.example_com.include='conf.d/example.com.locations'

先设置此站点不可用，执行以下命令：

uci set nginx.example_com=disable
uci commit nginx

创建站点配置文件 /etc/nginx/conf.d/example.com.locations ，内容如下：

location /srv/www {access_log off; # default: not logging accesses.# access_log /proc/self/fd/1 openwrt; # use logd (init forwards stdout).# error_log stderr; # default: logging to logd (init forwards stderr).error_log /dev/null; # disable error logging after config file is read.# (state path of a file for access_log/error_log to the file instead.)index index.html;
}

将配置给 LuCI 的站点设置为不可用，执行以下命令：

uci set nginx._lan=disable
uci set nginx._redirect2ssl=disable
uci commit nginx

修改 nginx 的 uci 模板文件 /etc/nginx/uci.conf.template ，将 root 设置为 /srv/www ，文件内容如下：

# Consider using UCI or creating files in /etc/nginx/conf.d/ for configuration.
# Parsing UCI configuration is skipped if uci set nginx.global.uci_enable=false
# For details see: https://openwrt.org/docs/guide-user/services/webserver/nginx
# UCI_CONF_VERSION=1.2worker_processes auto;user root;include module.d/*.module;events {}http {access_log off;log_format openwrt'$request_method $scheme://$host$request_uri => $status'' (${body_bytes_sent}B in ${request_time}s) <- $http_referer';include mime.types;default_type application/octet-stream;sendfile on;client_max_body_size 128M;large_client_header_buffers 2 1k;gzip on;gzip_vary on;gzip_proxied any;root /srv/www;#UCI_HTTP_CONFIGinclude conf.d/*.conf;
}

创建 HTTP 服务器测试文件，输入以下命令：

mkdir -p /srv/www
echo "<html><head><title>test</title></head><body>Hello, nginx!</body></html>" | tee /srv/www/index.html

设置 example.com 站点为可用，执行以下命令：

uci set nginx.example_com=server
uci commit nginx

重启 nginx 服务，执行以下命令：

service nginx restart

通过 Windows 主机的浏览器访问目标地址 localhost:60080 ，此处需注意，在 QEMU 启动参数中需要添加端口转发设置，将 Windows 主机的 60080 端口转发到 OpenWrt 访客机器的 80 端口，设置如下：

-netdev "user,id=hn0,hostfwd=tcp::50022-:22,hostfwd=tcp::50080-:50080,hostfwd=tcp::50443-:50443,hostfwd=tcp::60080-:80,hostfwd=tcp::60443-:443"

为 example.com 站点配置 SSL，执行以下命令：

uci del_list nginx.example_com.listen='80'
uci del_list nginx.example_com.listen='[::]:80'
uci add_list nginx.example_com.listen='443 ssl'
uci add_list nginx.example_com.listen='[::]:443 ssl'
uci set nginx.example_com.ssl_certificate='/etc/nginx/conf.d/example.com.crt'
uci set nginx.example_com.ssl_certificate_key='/etc/nginx/conf.d/example.com.key'
uci set nginx.example_com.ssl_session_cache='shared:SSL:32k'
uci set nginx.example_com.ssl_session_timeout='64m'
uci commit nginx

添加自签名证书，执行以下命令：

nginx-util add_ssl example.com

重启 nginx 服务，执行以下命令：

service nginx restart

通过 Windows 主机的浏览器访问目标地址 localhost:60443 ，此处需注意，在 QEMU 启动参数中需要添加端口转发设置，将 Windows 主机的 60443 端口转发到 OpenWrt 访客机器的 443 端口，设置如下：

-netdev "user,id=hn0,hostfwd=tcp::50022-:22,hostfwd=tcp::50080-:50080,hostfwd=tcp::50443-:50443,hostfwd=tcp::60080-:80,hostfwd=tcp::60443-:443"

至此，nginx HTTP 服务器配置完成。

安装 PHP8 FPM 服务

8、安装 PHP8 FPM，执行以下命令：

opkg update
opkg install php8-fpm

在 nginx 配置目录中添加配置文件 /etc/nginx/conf.d/php8.locations ，内容如下：

location ~ [^/]\.php(/|$) {fastcgi_split_path_info ^(.+?\.php)(/.*)$;if (!-f $document_root$fastcgi_script_name) {return 404;}# Mitigate https://httpoxy.org/ vulnerabilitiesfastcgi_param HTTP_PROXY "";#error_log /dev/null;fastcgi_connect_timeout 300s;fastcgi_read_timeout 300s;fastcgi_send_timeout 300s;fastcgi_buffer_size 32k;fastcgi_buffers 4 32k;fastcgi_busy_buffers_size 32k;fastcgi_temp_file_write_size 32k;client_body_timeout 10s;send_timeout 60s; # default, increase if experiencing a lot of timeouts.output_buffers 1 32k;fastcgi_index index.php;fastcgi_pass unix:/var/run/php8-fpm.sock;# include the fastcgi_param settinginclude fastcgi_params;# SCRIPT_FILENAME parameter is used for PHP FPM determining#  the script name. If it is not set in fastcgi_params file,# i.e. /etc/nginx/fastcgi_params or in the parent contexts,# please comment off following line:fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;fastcgi_param  PATH_INFO          $fastcgi_path_info;fastcgi_param  PATH_TRANSLATED    $document_root$fastcgi_path_info;
}

同步修改 /etc/php.ini 文件中的以下配置项：

doc_root = "/srv/www"
cgi.force_redirect = 1
cgi.redirect_status_env = "yes"

创建 PHP 测试文件，输入以下命令：

echo "<?php phpinfo(); ?>" | tee /srv/www/index.php

配置成功，显示如下界面：

安装 MariaDB/MySQL 数据库服务

9、安装 MariaDB/MySQL 服务器

opkg install mariadb-server mariadb-server-extra mariadb-client
opkg install coreutils-stty

修改配置文件 /etc/mysql/conf.d/50-server.conf ，确认以下设置：

datadir         = /srv/mysql
tmpdir          = /tmp

创建数据目录，执行以下命令：

mkdir -p /srv/mysql
mysql_install_db --force
chown mariadb.mariadb -R /srv/mysql/

启动 MariaDB，执行以下命令：

uci set mysqld.general.enabled='1'
uci commitservice mysqld restart

检查 MariaDB 的运行状态，执行以下命令：

/etc/init.d/mysqld status

创建 MariaDB 数据库，执行以下命令，并按要求回答：

/usr/bin/mysql_secure_installation -u root

测试数据库连接，执行一下命令：

mysql -u root

在 mysql 客户端输入：

SHOW DATABASES;

支持 MariaDB 数据库服务器安装配置好了。

安装 WordPress 博客 CMS

10、安装 WordPress 博客 CMS，当前版本为 6.5.3

下载最新版本 WordPress，下载地址：

https://cn.wordpress.org/latest-zh_CN.zip

在 OpenWrt 的控制台执行以下命令：

wget https://cn.wordpress.org/latest-zh_CN.zip

WP 6.5.3 的安装要求如下：

解压安装文件，并放到 Web 服务器工作目录中，执行以下命令：

unzip latest-zh_CN.zip
mv wordpress /srv/www/blog

安装 PHP MySQL Improved Extension 模块

opkg update
opkg install php8-mod-mysqli

创建 WP 需要的数据库

mysql -u root

创建 WP 专用数据库，在 MariaDB 的客户终端输入以下命令：

create database wordpress;

创建 WP 专用数据库用户，在 MariaDB 的客户终端输入以下命令：

create user wordpress;

给 WP 数据库用户的赋予该数据库的所有权限，在 MariaDB 的客户终端输入以下命令：

grant all privileges on wordpress.* to 'wordpress' identified by 'wordpress123';

配置好后，在 Windows 主机浏览器中输入网址：

https://localhost/blog/index.php

出现 WP 的安装页面，根据前边的数据库配置填入相应信息：

数据库：wordpress
用户：wordpress
密码：wordpress123
主机：127.0.0.1

需要注意，主机用 “127.0.0.1” 而不是 “localhost”，因为默认 MariaDB 监听端口在 “127.0.0.1:3306”，由于 OpenWrt 主机配置了 IPv4 和 IPv6 地址，当解析 localhost 时，首先解析到 ::1 的 IPv6 地址，这样导致如果主机输入 localhost ，WordPress 首先到 “::1” 的 IPv6 地址端口 “3306” 访问。

站点健康检查，如下图：

安装需要的模块，执行以下命令：

opkg update
opkg install php8-mod-gd
opkg install php8-mod-curl
opkg install php8-mod-exif
opkg install php8-mod-fileinfo
opkg install php8-mod-mbstring
opkg install php8-mod-zip
opkg install php8-mod-filter
opkg install php8-mod-iconv
opkg install php8-mod-intl
opkg install php8-pecl-imagick
service php8-fpm restart

解决读写权限问题，执行以下命令：

chown nobody.nogroup /srv/www/blog/ -R

解决 “XML or PCRE extensions not loaded!” 的问题，执行以下命令：

opkg update
opkg install php8-mod-xml
opkg install php8-mod-xmlreader
opkg install php8-mod-xmlwriter

修改 example.com.locations , 解决 REST API 和 伪静态页面问题

location / {access_log off; # default: not logging accesses.# access_log /var/run/nginx_access_log;# access_log /proc/self/fd/1 openwrt; # use logd (init forwards stdout).# error_log stderr; # default: logging to logd (init forwards stderr).error_log /dev/null; # disable error logging after config file is read.# error_log /var/run/nginx_error_log;# (state path of a file for access_log/error_log to the file instead.)index index.html index.htm index.php;try_files $uri $uri/ /index.php$is_args$args;location /blog/ {try_files $uri $uri/ /blog/index.php?$args;rewrite /wp-admin$ $scheme://$host$uri/ permanent;}
}

安装 WP Fastest Cache 插件，解决没有缓存问题。

检查站点健康状态：

至此，用 WordPress 搭建的个人博客网站已经准备就绪。

三、应用场景

个人博客站点

四、参考资料

1、WSL 的基本命令
2、旧版 WSL 的手动安装步骤
3、Windows 虚拟机监控程序平台
4、Windows Hypervisor Platform API Definitions
5、Windows Hypervisor Platform Instruction Emulator API Definitions and Support DLLs
6、QEMU Documentation/Networking
7、OpenWrt on x86 hardware (PC / VM / server)
8、The UCI system
9、Set up a LAMP webserver stack
10、ownCloud or NextCloud

总结

本文记录在 Windows 环境下用 QEMU 运行 OpenWrt 并安装配置 LNMP 服务器和 WordPress 博客 CMS 的方法，并指出过程中遇到的问题及解决方法。