1. 为什么选择Docker来部署WordPress?
如果你刚接触服务器运维,或者想快速搭建一个WordPress博客,听到“Docker”这个词可能会觉得有点高大上。别担心,我刚开始也这么觉得。简单来说,你可以把Docker想象成一个标准化的集装箱系统。以前,你要在服务器上装WordPress,得先装好PHP、Apache/Nginx、MySQL,然后配置它们互相通信,版本不匹配、依赖冲突是常有的事,一个环节出错就得折腾半天。现在呢,Docker把WordPress、MySQL这些软件连同它们运行所需的环境,一起打包成了一个个独立的“集装箱”(也就是镜像)。你只需要一条命令,就能把这个集装箱从仓库里拉下来,在服务器上启动运行。整个过程干净利落,不会污染你的服务器系统,想删除的时候也一键清空,不留痕迹。
在Debian 12上这么做,优势就更明显了。Debian系统以稳定著称,而Docker提供了极致的应用隔离和部署一致性。这意味着,你今天在本地开发机用Docker搭好的WordPress环境,可以原封不动地部署到云服务器的Debian 12上,完全不用担心“在我电脑上是好的”这种问题。对于个人博主、初创团队或者需要快速验证想法的开发者来说,这能节省大量搭建和调试环境的时间。我自己就经常用这种方式,十分钟内就能让一个全新的WordPress站点跑起来,把精力集中在内容创作和主题开发上,而不是和环境配置“斗智斗勇”。
接下来,我会手把手带你走一遍整个流程。从准备一台干净的Debian 12服务器,到安装配置Docker,再到用Docker Compose一键启动WordPress和MySQL。整个过程我会穿插我实际踩过的坑和优化建议,保证你跟着做一次就能成功。我们不光要让站点跑起来,还会聊聊如何配置国内镜像加速让你的下载速度飞起,以及如何通过简单的配置让这个站点更健壮、更易管理。放心,所有命令我都会给出详细解释,你直接复制粘贴就行。
2. 前期准备:配置你的Debian 12服务器
2.1 系统更新与基础工具安装
拿到一台新的Debian 12服务器(我以腾讯云或阿里云的轻量应用服务器为例),第一件事就是用SSH工具(比如Termius、FinalShell或者系统自带的终端)连接上去。通常你会使用root账号登录,如果使用的是具有sudo权限的普通用户,记得在下面的命令前加上sudo。
登录后,我们首先更新系统的软件包列表,并升级所有可升级的软件包。这是一个好习惯,能确保我们从一个最新的基础开始工作。
apt update && apt upgrade -y
这条命令中,apt update是刷新软件源索引,apt upgrade -y则是自动确认并安装所有更新。执行完后,系统就处于最新状态了。
接下来,安装一些后续步骤必需的软件包:
apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
我来解释一下这几个包是干嘛的:
apt-transport-https:让apt包管理器能够通过HTTPS协议下载软件。ca-certificates:一些常见的CA证书,用于验证HTTPS连接的安全性。curl:一个命令行工具,用于从网络下载文件或数据,我们用它来下载Docker的GPG密钥。gnupg:用于加密和数字签名的工具,我们需要它来处理Docker的软件包签名密钥。lsb-release:这个工具能帮助我们获取当前系统的版本信息,在配置Docker软件源时会用到。
2.2 安装Docker引擎与Compose插件
Docker官方提供了便捷的安装脚本,但为了更好的可控性和兼容性(尤其是国内网络环境),我们选择通过添加Docker官方APT仓库的方式来安装。这样以后也能通过apt方便地更新Docker。
第一步,添加Docker的官方GPG密钥。 这个密钥用于验证从仓库下载的软件包是否来自Docker官方,确保安全。考虑到国内网络,我们使用阿里云的镜像地址来获取密钥,速度会快很多。
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
如果阿里云镜像某天不可用,你也可以使用官方源(将地址中的 mirrors.aliyun.com 替换为 download.docker.com),但速度可能较慢。
第二步,将Docker的APT仓库添加到系统源列表。 这里用到了一个命令替换 $(lsb_release -cs),它会自动获取你当前Debian系统的代号(比如Bookworm)。
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \
$(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
同样,这里也使用了阿里云镜像。这条命令创建了一个新的源列表文件 /etc/apt/sources.list.d/docker.list。使用tee命令同时完成写入文件和显示内容(但我们用> /dev/null将输出屏蔽了)。
第三步,正式安装Docker。 添加仓库后,先更新本地软件包索引,然后安装Docker引擎、命令行工具、容器运行时以及Docker Compose插件。
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
注意,我们安装的是 docker-compose-plugin,这是Docker官方推荐的Compose V2版本,它作为一个Docker CLI插件存在,使用命令是 docker compose(注意中间没有横线)。这比旧版的独立docker-compose软件包更好管理。
第四步,验证安装。 安装完成后,启动Docker服务并设置开机自启,然后检查版本和状态。
systemctl start docker
systemctl enable docker
docker version
systemctl status docker
运行 docker version 会输出客户端和服务端的版本信息。systemctl status docker 则会显示Docker服务的运行状态,看到绿色的“active (running)”字样就说明服务已经成功跑起来了。
3. 优化配置:为Docker换上国内镜像加速器
Docker默认从Docker Hub拉取镜像,服务器如果在国外速度尚可,但在国内下载几百兆的镜像可能会非常慢,甚至失败。为了解决这个问题,我们需要为Docker Daemon配置一个国内的镜像加速器。这就像是给Docker换上一个离你更近的“下载站点”,速度会有质的提升。
配置方法很简单,就是创建一个Docker的守护进程配置文件。我们用nano这个简单的文本编辑器来操作:
nano /etc/docker/daemon.json
如果这个文件不存在,nano会新建一个。如果已存在,则会打开它。在文件中输入以下内容(我以配置腾讯云镜像加速器为例,因为我的服务器在腾讯云,同地域内网加速效果最好):
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com"
]
}
输入完成后,按 Ctrl+O 回车保存,再按 Ctrl+X 退出nano编辑器。
这里我多给你几个常用的国内镜像加速器地址,你可以根据自己服务器的云服务商或网络情况选择:
| 镜像加速器地址 | 提供方 | 特点 |
|---|---|---|
https://registry.docker-cn.com | Docker中文社区 | 老牌稳定 |
https://docker.mirrors.ustc.edu.cn | 中国科学技术大学 | 教育网友好 |
https://hub-mirror.c.163.com | 网易 | 速度不错 |
https://mirror.baidubce.com | 百度云 | 百度云用户适用 |
你可以只配置一个,也可以像下面这样配置多个(Docker会按顺序尝试):
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com",
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com"
]
}
配置完成后,需要重启Docker服务使配置生效:
systemctl restart docker
重启后,你可以运行 docker info 命令,在输出结果中查找 Registry Mirrors 部分,如果能看到你刚才配置的地址,就说明镜像加速器已经生效了。这个配置是一次性的,以后所有docker pull命令都会默认从这些镜像站拉取镜像,下载WordPress、MySQL这些大镜像时,你会感受到飞一般的速度。
4. 核心实战:编写Docker Compose编排文件
好了,基础环境已经就绪,现在进入最核心的部分——使用Docker Compose来定义和运行我们的WordPress服务。Docker Compose的魅力在于,它用一个YAML格式的配置文件(docker-compose.yaml),就能描述清楚整个应用需要用到的所有服务(比如Web应用、数据库)、它们之间的依赖关系、网络、数据卷等。我们再也不需要手动去启动一个个容器,并用复杂的参数把它们连接起来了。
首先,我们创建一个专门的项目目录,这样所有的相关文件都会放在一起,便于管理。
mkdir ~/my-wordpress-site && cd ~/my-wordpress-site
我习惯在用户主目录下创建,你也可以放在任何你喜欢的位置,比如/opt目录下。
接下来,创建并编辑 docker-compose.yaml 文件:
nano docker-compose.yaml
将下面的配置内容完整地复制粘贴进去。别急,我会逐段解释每个部分的作用,让你不仅知其然,更知其所以然。
version: '3.8'
services:
wordpress:
depends_on:
db:
condition: service_healthy
image: wordpress:php8.3-apache
container_name: my-wp-app
restart: unless-stopped
ports:
- "8080:80"
volumes:
- ./wp-content:/var/www/html/wp-content
- ./uploads.ini:/usr/local/etc/php/conf.d/uploads.ini
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wordpressuser
WORDPRESS_DB_PASSWORD: your_strong_password_here
WORDPRESS_DB_NAME: wordpressdb
networks:
- wp-network
db:
image: mysql:8.0
container_name: my-wp-db
restart: unless-stopped
volumes:
- ./mysql-data:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: another_strong_root_password
MYSQL_DATABASE: wordpressdb
MYSQL_USER: wordpressuser
MYSQL_PASSWORD: your_strong_password_here
networks:
- wp-network
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-p$$MYSQL_ROOT_PASSWORD"]
interval: 10s
timeout: 5s
retries: 5
networks:
wp-network:
driver: bridge
现在,我们来拆解这个配置文件:
-
版本与服务定义:
version: '3.8'指定了Compose文件的语法版本。services:下面定义了两个服务:wordpress(网站前端)和db(MySQL数据库)。 -
WordPress服务详解:
depends_on: 告诉Compose,wordpress服务依赖于db服务,并且要等到db服务通过健康检查(condition: service_healthy)后再启动。这确保了数据库先就绪,WordPress才尝试连接,避免了启动报错。image: 指定使用的镜像。我们用了wordpress:php8.3-apache,这是包含Apache和PHP 8.3的官方镜像标签,性能更好。你也可以用更通用的wordpress:latest。container_name: 为容器指定一个自定义名字,方便管理,不然Docker会分配一个随机名字。restart: unless-stopped: 设置容器重启策略。除非我们手动停止,否则如果容器异常退出,Docker会自动重启它,非常适合生产环境。ports: 端口映射。"8080:80"表示将容器内部的80端口(Apache服务端口)映射到宿主机的8080端口。这样你访问服务器IP的8080端口就能看到网站了。强烈建议不要直接映射到80端口,先用一个非常用端口测试。volumes: 数据卷映射。这是持久化数据的关键!./wp-content:/var/www/html/wp-content:将本地的wp-content目录挂载到容器内。这样,你安装的主题、插件以及上传的媒体文件都会保存在宿主机上,即使删除容器也不会丢失。./uploads.ini:/usr/local/etc/php/conf.d/uploads.ini:这是一个可选但很实用的优化。你可以创建一个uploads.ini文件,内容为upload_max_filesize = 64M,来修改PHP上传文件大小限制。
environment: 设置环境变量,这是WordPress容器连接数据库的配置。请务必将your_strong_password_here替换成你自己设定的强密码!networks: 让WordPress容器加入一个自定义的桥接网络wp-network,这样两个容器可以通过服务名(db)直接通信,无需知道IP地址。
-
MySQL数据库服务详解:
image: mysql:8.0:使用MySQL 8.0镜像。你也可以用mysql:5.7,但8.0性能更优。volumes: ./mysql-data:/var/lib/mysql:极其重要! 将数据库文件持久化到宿主机的./mysql-data目录。没有这个,容器删除后所有文章、评论数据就都没了。environment: 设置数据库的root密码、创建初始数据库和用户。这里的MYSQL_PASSWORD要和上面WordPress环境变量里的WORDPRESS_DB_PASSWORD一致。MYSQL_ROOT_PASSWORD是root用户的密码,也要设一个强密码并保管好。healthcheck: 定义了健康检查命令。Compose会定期执行mysqladmin ping来检查数据库是否就绪,这被wordpress服务的depends_on所依赖。
-
网络定义:在文件最后,我们定义了一个名为
wp-network的桥接网络。两个服务都加入这个网络后,它们处于一个隔离的虚拟网络中,WordPress容器可以通过db这个主机名直接访问MySQL容器的3306端口,安全又方便。
5. 一键启动与管理你的WordPress站点
配置文件准备就绪,现在就是见证奇迹的时刻。在存放 docker-compose.yaml 文件的目录下(也就是我们刚才创建的 ~/my-wordpress-site),执行一条命令:
docker compose up -d
那个 -d 参数代表“detached”,意思是在后台运行。执行这条命令后,Docker Compose会做以下几件事:
- 检查本地是否有
wordpress:php8.3-apache和mysql:8.0镜像,如果没有,就从配置的镜像加速器拉取。 - 为我们创建配置文件中定义的
wp-network网络。 - 先启动
db服务(MySQL),并等待其健康检查通过。 - 再启动
wordpress服务。 - 将两个容器以后台模式运行起来。
你可以通过以下命令观察启动日志和状态:
# 查看所有由当前compose文件管理的容器状态
docker compose ps
# 查看实时的日志输出(类似 tail -f)
docker compose logs -f
# 如果想同时查看两个服务的日志
docker compose logs -f wordpress db
如果看到 State 显示为 Running,并且日志中没有持续报错,就说明启动成功了。
现在,打开你的浏览器,访问 http://你的服务器IP地址:8080。你应该能看到WordPress著名的“五分钟安装”界面了!按照提示选择语言,设置站点标题、管理员用户名、密码和邮箱,点击“安装WordPress”。稍等片刻,恭喜你,你的个人博客站点就正式上线了!
几个常用的管理命令,你一定会用到:
- 停止服务:
docker compose down。这条命令会停止并删除本次up创建的所有容器和网络,但不会删除数据卷(即mysql-data和wp-content目录里的数据)。下次up时数据还在。 - 停止服务并清理数据:
docker compose down -v。这个命令会同时删除数据卷,请谨慎使用,除非你想清空所有数据和上传的文件。 - 重启服务:
docker compose restart。 - 查看服务资源占用:
docker compose top。 - 更新服务(例如,想用新版本的镜像):先修改
docker-compose.yaml中的镜像标签,然后运行docker compose pull拉取新镜像,再运行docker compose up -d。Compose会智能地重建容器。
6. 进阶配置:绑定域名与HTTPS加密
让站点跑在8080端口只是第一步。一个正式的网站通常需要用自己的域名(比如 blog.yourname.com)并通过HTTPS(443端口)访问,这样更专业、更安全。我们不需要修改Docker Compose的配置,而是通过在宿主机上配置一个反向代理服务器(比如Nginx)来实现。
思路是这样的:用户访问 https://blog.yourname.com -> Nginx监听443端口,处理SSL加密 -> Nginx将请求转发给本地localhost:8080(即Docker WordPress容器)-> 容器处理请求后返回给Nginx -> Nginx再返回给用户。这样,对用户来说访问的是标准的HTTPS网站,而我们的Docker服务结构完全不用动。
6.1 安装与配置Nginx
首先,在Debian 12上安装Nginx:
apt install -y nginx
systemctl enable nginx
systemctl start nginx
安装后,默认的网站配置文件在 /etc/nginx/sites-available/default。我们不直接修改它,而是为我们的WordPress站点创建一个新的配置文件。
nano /etc/nginx/sites-available/my-wordpress
将以下配置粘贴进去。你需要修改两个地方:server_name 换成你自己的域名;proxy_pass 中的端口号确保和docker-compose.yaml里映射的宿主机端口一致(我这里是8080)。
server {
listen 80;
listen [::]:80;
server_name blog.yourdomain.com; # 改为你的域名
# 将HTTP请求重定向到HTTPS(如果你有SSL证书)
# return 301 https://$server_name$request_uri;
# 如果暂时没有证书,可以先注释掉上面这行,用HTTP
location / {
proxy_pass http://localhost:8080; # 指向Docker容器的端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
这段配置的核心是 location / 块中的 proxy_pass 指令和一系列 proxy_set_header。它们的作用是将收到的请求原样转发给后端的WordPress容器,并传递真实的客户端IP、协议等信息,这样WordPress才能正确生成链接和进行一些判断。
保存退出后,需要创建一个符号链接,将这个配置文件启用:
ln -s /etc/nginx/sites-available/my-wordpress /etc/nginx/sites-enabled/
然后测试Nginx配置语法是否正确:
nginx -t
如果显示 syntax is ok 和 test is successful,就可以重载Nginx使配置生效:
systemctl reload nginx
现在,你应该可以通过你的域名(或者服务器IP)的80端口访问网站了(前提是域名已解析到服务器IP)。
6.2 申请并配置SSL证书(HTTPS)
让网站支持HTTPS是现在的标准做法。你可以从云服务商(如腾讯云、阿里云)免费申请一年期的SSL证书,也可以使用Let‘s Encrypt的免费证书。这里以使用certbot工具自动获取Let‘s Encrypt证书为例,这是最通用的方法。
首先安装certbot和Nginx插件:
apt install -y certbot python3-certbot-nginx
然后运行以下命令,它会自动读取你的Nginx配置,引导你完成证书申请和配置:
certbot --nginx -d blog.yourdomain.com
按照提示操作,输入邮箱同意协议,选择是否将HTTP流量重定向到HTTPS(强烈建议选择是)。成功后,certbot会自动修改你的Nginx配置文件,添加SSL相关配置,并设置自动续期任务。
完成后,再次访问你的域名,前面就应该出现一把安全的小锁,表示HTTPS已经生效了。你的Docker WordPress站点,现在就是一个拥有独立域名、支持HTTPS加密的正式网站了。
7. 日常维护与故障排查心得
站点上线后,日常的维护和偶尔的问题排查是免不了的。这里分享几个我常用的命令和遇到问题的解决思路,能帮你省下不少搜索的时间。
数据备份:这是最重要的事!你的数据都在两个地方:数据库(mysql-data目录)和上传的文件(wp-content目录)。定期备份这两个目录即可。你可以写一个简单的脚本,用tar命令打包,然后通过scp或rsync传到另一台机器或对象存储。
# 示例备份脚本
cd ~/my-wordpress-site
tar -czf wp-backup-$(date +%Y%m%d).tar.gz mysql-data wp-content
# 然后可以将这个tar.gz文件传输到安全的地方
查看日志:当网站出现白屏、数据库连接错误等问题时,首先查看容器日志。
# 查看WordPress容器最近100行日志
docker compose logs --tail=100 wordpress
# 查看MySQL容器的错误日志
docker compose logs db | grep -i error
WordPress的日志通常会明确告诉你问题所在,比如“无法连接到数据库”、“内存耗尽”等。
进入容器内部调试:有时候需要检查容器内的文件或执行命令。
# 进入WordPress容器的bash shell
docker compose exec wordpress bash
# 进入后,你可以查看PHP配置文件、检查文件权限等
ls -la /var/www/html
cat /etc/apache2/envvars
性能监控与清理:运行一段时间后,可以查看资源使用情况。
# 查看所有容器的资源占用(CPU,内存)
docker stats
# 清理无用的Docker镜像、容器、网络等,释放磁盘空间
docker system prune -a
使用 docker system prune 时要小心,它会删除所有已停止的容器、未被任何容器使用的网络、悬空的镜像和构建缓存。确保你理解其作用后再执行。
版本升级:当有新的WordPress或MySQL镜像版本时,升级流程很平滑。
- 备份数据。
- 修改
docker-compose.yaml中的镜像标签(如wordpress:php8.3-apache改为wordpress:latest)。 - 执行
docker compose pull拉取新镜像。 - 执行
docker compose up -d,Compose会自动用新镜像重建容器,而你的数据卷保持不变。
最后,关于安全性再多说两句。务必使用强密码替换示例中的密码;定期更新系统和Docker镜像以修复安全漏洞;如果服务器有防火墙(如UFW),记得只开放必要的端口(如80,443,SSH端口)。Docker本身提供了一定的隔离,但良好的安全习惯才是根本。
430



被折叠的 条评论
为什么被折叠?



