Docker Compose 部署 Z-BlogPHP

使用 Docker Compose 快捷部署 Z-BlogPHP + MySQL；

镜像

Z-BlogPHP：https://github.com/zblogcn/zblogphp-docker-image

MySQL：mysql/mysql-server:5.7

前置

# 安装 Docker Compose
sudo curl -L https://github.com/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` \
 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

生成最新版 Docker Compose 安装命令：https://demo.wdssmq.com/tools/GenShell/

使用

1、拉取项目代码并初始化文件：

# 克隆项目文件
git clone https://github.com/wdssmq/zbp-docker-compose.git zbp-dc

# 进入项目文件夹
cd zbp-dc

# 复制配置文件
cp .env.sample .env

2、配置.env变量：

• 数据库密码
• Z-BlogPHP 用户名及密码

3、启动

# 初始运行，会输出各种日志；
# ctrl + c 中止，可多次执行直到不报错
docker-compose up

# 正式运行（后台启动）
# docker-compose down
docker-compose up -d

4、备份及恢复

# 停用容器
docker-compose down

# 打包 zbp-dc 文件夹整体
cd .. # 返回上级目录
tar -czvf zbp-dc.tar.gz zbp-dc

恢复时需要确保容器内文件权限：

# 权限恢复，以实际路径为准
sudo chown -R 1000:1000 data-www

# MySQL 数据
sudo chown -Rv 27:sudo data-mysql

5、自定义 Nginx 配置

# 容器内复制相应文件到 data-nginx
docker cp zbp_def:/opt/docker/etc/nginx/vhost.common.d data-nginx

# docker-compose.yml 中启用相应的 volumes 映射后重启容器
docker-compose restart

# 修改 data-nginx 中的配置文件后可单独重启 Nginx
docker exec -it zbp_def nginx -s reload

# docker cp zbp_def:/opt/docker/etc/nginx data-nginx

6、其他命令

# 查看配置
docker-compose config

# 重启
docker-compose restart

# 停止
docker-compose stop

# 完全移除容器
docker-compose down

# 查看启动的容器情况
docker-compose ps

# 查看容器输出日志
docker logs $container_name

# 进入容器内部
docker exec -it $container_name /bin/bash

phpMyAdmin 连接管理数据库

如果需要 phpMyAdmin 可单独配置：

# 强制删除容器
docker rm --force phpMyAdmin
docker run --name phpMyAdmin \
  --network=zbp-dc_net_web \
  -p 9100:80 \
  -e PMA_HOST=MySQL \
  -e UPLOAD_LIMIT=4096K \
  -d phpmyadmin/phpmyadmin

# 关闭（但不删除）
docker stop phpMyAdmin

# 启用
docker start phpMyAdmin

注：

• -e PMA_HOST=MySQL中MySQL为 docker-compose.yml 文件内定义的服务名；
• -e UPLOAD_LIMIT=4096K用于设置导入文件的大小限制，可以按需要设置，比如20M；
• --network=zbp-dc_net_web实际所需需要的值可以执行docker network ls查看；
  • 默认情况下以文件夹名为前缀；

docker network ls
# NETWORK ID     NAME             DRIVER    SCOPE
# 8fe33d9c54d0   bridge           bridge    local
# 4579b81d15b4   host             host      local
# 2e9e3da577ef   none             null      local
# a620eec8f4dc   zbp-dc_net_web   bridge    local

# 调试命令
sudo docker-compose down && rm -rf data-www/ data-mysql && sudo docker-compose up