Docker-compose 安装 wordpress 搭建个人博客非常详细教程

共计 4576 个字符，预计需要花费 12 分钟才能阅读完成。

前言

有人问清朝云如何搭建一个这样的博客，今天就抽空写一下使用 docker-compose 搭建个人博客。这需要你有一定的 docker 或 docker-compose 基础，如果你还不了解 compose，那么可以看看这篇文章 容器编排 Docker-compose 详解。

直接使用 docker run 其实也是可以的，如果你实在不想用 compose，那么你可以让 chatgpt 帮你转成 docker run 运行的方式，但其实对于三个或者三个以上的容器，清朝云觉得还是有必要使用 compose，这样方便管理。

一、搭建

1. 拷贝nginx配置文件

使用 nginx 都躲不了修改配置文件，不管是反向代理博客，或者是反向代理其他都需要进行修改配置，那么将 nginx 配置文件映射到宿主机是很有必要的。

# 创建目录
mkdir -p /home/docker/nginx && \
cd /home/docker/nginx && \
mkdir conf.d && \
mkdir html && \
mkdir logs

# 不映射文件启动容器，然后 使用 docker cp 拷贝配置文件
docker run -d --name nginx -p 88:80 nginx && \
docker cp nginx:/etc/nginx/nginx.conf ./ && \
docker cp nginx:/etc/nginx/conf.d/default.conf ./conf.d/ && \
docker cp nginx:/usr/share/nginx/html/index.html ./html/ && \
docker rm -f nginx

2. 启动

在目录下新建 docker-compose.yaml 文件。

version: '3.1'
services:
  nginx:
    image: nginx
    container_name: nginx
    restart: always
    network_mode: "host"
    volumes:
      - /home/docker/nginx/nginx.conf:/etc/nginx/nginx.conf
      - /home/docker/nginx/conf.d:/etc/nginx/conf.d
      - /home/docker/nginx/logs:/var/log/nginx
      - /home/docker/nginx/www:/www
      - /etc/localtime:/etc/localtime:ro
  blog:
    image: wordpress:6.0.3
    container_name: blog
    restart: always
    ports:
      - 30080:80
    environment:
      WORDPRESS_DB_HOST: mysql
      WORDPRESS_DB_USER: root
      WORDPRESS_DB_PASSWORD: admin@123!
      WORDPRESS_DB_NAME: blog
    volumes:
      - /home/docker/blog:/var/www/html
    depends_on:
     - mysql
  mysql:
   image: mysql:8.0.26
   container_name: mysql
   restart: always
   ports:
     - 30001:3306
   environment:
     MYSQL_DATABASE: blog
     MYSQL_ROOT_PASSWORD: admin@123!
   volumes:
     - /home/docker/mysql/data:/var/lib/mysql
     - /home/docker/mysql/init:/docker-entrypoint-initdb.d

注意这里 nginx 容器网络使用的是 host 模式，也就是说宿主机的 80 和 443 端口不能被占用，否则无法启动 nginx，除非修改 nginx 默认端口号。

如果你使用的是云服务器，那么需要防火墙需要放行这两个端口。

然后运行 docker-compose up -d 启动容器。

/>

此时访问 nginx 的 80 端口，还是 nginx 默认的页面，因为还没有配置转发到博客。

3. 修改nginx配置文件

这里分为两种情况，分为是否使用 https，看自己情况进行哪一步操作，server_name 修改为自己的域名。

3.1 仅 http

cat > /home/docker/nginx/conf.d/default.conf <<EOF
server {
    listen 80;
    server_name test.com www.test.com;
    access_log  /var/log/nginx/blog.access.log  main;
    error_log  /var/log/nginx/blog.error.log notice;

    location ~* /xmlrpc.php {
      deny all;
    }

    location / {
      add_header 'Access-Control-Allow-Origin' '*';
      add_header 'Access-Control-Allow-Credentials' 'true';
      add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
      add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
      proxy_set_header X-Real-IP \$remote_addr;
      proxy_set_header Host \$host;
      proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
      proxy_pass http://localhost:30080/;
    }
}
EOF

3.2 配置 https

cat > /home/docker/nginx/conf.d/default.conf <<EOF
server {
    listen       443 ssl;
    listen  [::]:443 ssl;
    server_name test.com www.test.com;
    ssl_certificate  /etc/nginx/conf.d/cert/test.com/test.cer;
    ssl_certificate_key /etc/nginx/conf.d/cert/test.com/test.com.key;
    access_log  /var/log/nginx/blog.access.log  main;
    error_log  /var/log/nginx/blog.error.log notice;

    location ~* /xmlrpc.php {
      deny all;
    }

    location / {
      add_header 'Access-Control-Allow-Origin' '*';
      add_header 'Access-Control-Allow-Credentials' 'true';
      add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
      add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
      add_header Content-Security-Policy upgrade-insecure-requests;
      proxy_set_header X-Real-IP \$remote_addr;
      proxy_set_header Host \$host;
      proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
      proxy_pass http://localhost:30080/;
    }
}
server {
    listen 80;
    server_name test.com www.test.com;
    rewrite ^(.*)$ https://\$host:443\$1 permanent;
}

需要说明的是，配置 https 需要申请 ssl 证书，下载后放在指定位置，然后配置 ssl_certificate 和 ssl_certificate_key。

此外，由于配置了 rewrite，访问 80 端口会强制跳转到 443。

配置完成后需要重启 nginx。

docker restart nginx

二、安装

如果不出意外，你将得到一个这样的页面，此时说明 mysql 还没启动，博客就尝试去连接了。

/>

此时需要重启下博客容器。

docker restart blog

再次访问，即可进入正常安装页面，这里选择简体中文即可。

/>

点击继续后将进入最终的设置，这里没有让我们输入 mysql 的地址和用户等信息是因为我们在启动容器的时候已经指定过了。

/>

至此，博客就已经安装完成了。

/>

页面很简陋，因为这是 wordpress 的默认主题，想要达到自己想要的效果还要对站点进行装修，即配置主题和做相关美化配置。

三、配置

1. 主题配置

这里不是必要的，因为你可能有其他喜欢的主题，我这里仅做一个简单的演示。

首先下载一个免费版本的 corepress 主题，地址：https://github.com/ghboke/CorePressWPTheme/releases/tag/v5.8.8

/>

下载压缩包后，打开 http://ip/wp-admin， 输入管理员账号密码进入后台页面。

点击主题，可以看见这里有很多预设的主题，但都不是我们想要的，需要点击添加新主题，再点击上传主题。

/>

选择刚刚下载的安装包，点击立即安装。

/>

安装后点击启用即可。

/>

再访问首页，发现样式已经变了，但还不是想要的效果。

/>

需要再后台点击主题设置，发现这里有一大堆可以设置的内容，包括网站logo、默认缩略图、备案号等等信息。

这里的配置清朝云就不再啰嗦，需要自己去探索，点击右上角也有主题的详细 配置文档。

/>

值得一提的是，除了主题设置还有两个新手不太清楚的地方，那就是首页提示的配置菜单和小工具。

2. 菜单配置

菜单的配置需要点击外观里面的菜单进行配置，需要先添加一个菜单，并配置菜单名称和显示位置。

/>

创建菜单后可以看见顶部没有了提示，但是也没有菜单选项。

/>

这是因为没有添加菜单项，回到设置将左边的菜单项添加到菜单即可。

/>

保存后将在顶部可以看见菜单选项。

/>

3. 小工具配置

有些朋友可能不清楚文章右侧的内容如果配置，其实这些东西就是 wordpress 的小工具，可以在外面里面的小工具进行配置。

比如，我这里需要添加一个作者模块到首页，那么我点击添加小工具即可。

/>

再次访问首页，发现作者模块的小工具已经显示出来。

/>

写在最后

到此为止，使用 docker-compose 搭建 wordpress 的教程就结束了，剩下的还需要自己去探索。

使用这种方式搭建的好处显而易见，所有数据全部在 /home/docker 目录，迁移的时候将这个目录完整地迁移，创建 docker-compose.yaml 文件后再运行 docker-compose up -d 即可完美运行。

提醒：本文发布于520天前，文中所关联的信息可能已发生改变，请知悉！