JPress项目Docker Compose部署指南

概述

本文详细解析JPress项目中的docker-compose.yml配置文件，帮助开发者理解如何通过Docker容器快速部署JPress网站系统。JPress是一个基于Java开发的现代化开源CMS系统，采用Docker部署可以大大简化环境配置过程。

核心服务配置

MySQL数据库服务

db:
  image: mysql:5.7
  command: --default-authentication-plugin=mysql_native_password
  restart: always
  environment:
    MYSQL_ROOT_PASSWORD: jpress
    MYSQL_DATABASE: jpress
    MYSQL_USER: jpress
    MYSQL_PASSWORD: jpress
  volumes:
    - "./docker_volumes/mysql:/var/lib/mysql"

这部分配置定义了一个MySQL 5.7数据库服务，关键点包括：

1. 使用mysql_native_password认证插件，确保兼容性
2. 设置了root用户密码为jpress
3. 创建了名为jpress的数据库和同名用户
4. 通过volume挂载实现数据持久化，防止容器重启后数据丢失

JPress应用服务

jpress:
  depends_on:
    - db
  links:
    - db
  image: fuhai/jpress:v5.1.1
  ports:
    - "8080:8080"
  restart: always
  environment:
    TZ: Asia/Shanghai
    JPRESS_DB_HOST: db
    JPRESS_DB_PORT: 3306
    JPRESS_DB_NAME: jpress
    JPRESS_DB_USER: jpress
    JPRESS_DB_PASSWORD: jpress
  volumes:
    - "./docker_volumes/webapp/attachment:/opt/jpress/webapp/attachment"
    - "./docker_volumes/webapp/addons:/opt/jpress/webapp/addons"
    - "./docker_volumes/webapp/WEB-INF/addons:/opt/jpress/webapp/WEB-INF/addons"
    - "./docker_volumes/webapp/wp-content:/opt/jpress/webapp/wp-content"
    - "./docker_volumes/webapp/templates/dockers:/opt/jpress/webapp/templates/dockers"

JPress应用服务配置要点：

1. 明确依赖数据库服务(depends_on和links)
2. 使用官方提供的fuhai/jpress:v5.1.1镜像
3. 将容器8080端口映射到宿主机8080端口
4. 设置时区为Asia/Shanghai
5. 配置数据库连接参数，指向之前定义的db服务
6. 通过多个volume挂载确保重要目录数据持久化

持久化存储设计

该配置精心设计了多个volume挂载点，确保以下数据不会因容器重启而丢失：

1. MySQL数据库文件
2. JPress附件文件
3. 插件(addons)目录
4. 主题模板(templates)目录
5. WordPress兼容内容目录(wp-content)

这种设计既考虑了数据安全，又便于备份和迁移。

部署实践建议

1. 首次部署：直接运行docker-compose up -d即可启动完整服务
2. 数据备份：定期备份docker_volumes目录下的数据
3. 版本升级：修改jpress服务的image标签为新版本号后重新部署
4. 端口冲突：如需修改8080端口，同步调整防火墙/安全组规则
5. 性能调优：可根据实际需求添加资源限制(resources)配置

常见问题解答

Q：为什么使用MySQL 5.7而不是更新版本？

A：JPress对MySQL 5.7有更好的兼容性测试，且5.7版本在稳定性和性能方面已经足够成熟。

Q：如何修改管理员密码？

A：首次启动后，访问8080端口完成web安装向导，在安装过程中设置管理员密码。

Q：挂载目录权限问题如何解决？

A：确保宿主机上的docker_volumes目录对Docker进程有读写权限，可尝试chmod -R 777 docker_volumes。

通过这份docker-compose配置，开发者可以快速搭建一个生产可用的JPress环境，所有关键数据都得到妥善持久化处理，为后续运维提供了良好基础。