xiaohu2023/dzzoffice

DzzOffice Docker镜像部署文档

镜像概述和主要用途

本镜像基于PHP8.1、Nginx、MariaDB构建，提供DzzOffice开源协同办公平台的完整部署方案，支持快速启动、数据持久化、HTTPS部署及Docker Compose集成，适用于个人、团队或企业快速搭建协同办公系统。

版本与升级说明

• DzzOffice Docker镜像仅用于部署，无固定版本标签（始终为最新部署包），应用更新与镜像无关；
• 数据持久化的用户升级DzzOffice：通过后台「系统工具」在线升级，或下载源码覆盖挂载目录离线升级。

一、部署前提

• 服务器需安装Docker 20.10+、Docker Compose v2+；
• 在线环境（默认）：直接部署，自动拉取镜像；
• 离线环境：需先导入镜像（见下文），再执行部署。

二、离线环境镜像导入（仅离线服务器需做）

1. 联网设备拉取并导出镜像

bash
# 拉取核心镜像
docker pull xiaohu2023/dzzoffice
docker pull redis:alpine
docker pull mariadb:lts

# 导出镜像为tar包（便于离线传输）
docker save -o dzzoffice.tar xiaohu2023/dzzoffice
docker save -o redis.tar redis:alpine
docker save -o mariadb.tar mariadb:lts

现成离线包（amd64架构）：[***]

2. 离线服务器导入镜像

传输tar包到离线服务器并进入tar包所在目录，执行导入：

bash
docker load -i dzzoffice.tar
docker load -i redis.tar
docker load -i mariadb.tar

导入完成后，执行docker images命令验证，若能看到xiaohu2023/dzzoffice、redis:alpine、mariadb:lts 3个镜像，则导入成功。

三、部署方式

方式1：快速启动

默认使用80端口，容器删除后数据会丢失，仅推荐临时测试使用。

bash
docker run -d -p 80:80 xiaohu2023/dzzoffice

方式2：实现数据持久化

创建数据目录并在启动时挂载

bash
mkdir /data
docker run -d -p 80:80 -v /data:/var/www/html xiaohu2023/dzzoffice

方式3：以HTTPS方式启动

若需通过HTTPS访问，需提前准备SSL证书（格式必须为fullchain.pem、privkey.pem）

bash
docker run -d -p 443:443 -v "你的证书目录":/etc/nginx/ssl --name dzzoffice xiaohu2023/dzzoffice

方式4：Docker Compose部署（推荐）

通过Docker Compose同时部署DzzOffice应用和MariaDB数据库，实现应用、数据库数据双重持久化，配置更灵活，推荐生产环境使用。

步骤1：拉取部署脚本

bash
git clone https://github.com/zyx0814/dzzoffice-docker.git
cd ./dzzoffice-docker/compose/

若无法拉取，可自行新建db.env文件设置数据库环境变量并创建docker-compose.yml文件配置映射端口、持久化目录等。

db.env文件内容：

env
MYSQL_PASSWORD=dzzoffice
MYSQL_DATABASE=dzzoffice
MYSQL_USER=dzzoffice

docker-compose.yml文件内容：

yaml
version: '3.5'

services:
  db:
    image: mariadb:lts
    command: --transaction-isolation=READ-COMMITTED
    restart: always
    volumes:
      - "./db:/var/lib/mysql" # ./db是数据库持久化目录，可修改
    environment:
      - MYSQL_ROOT_PASSWORD=dzzoffice
      - MARIADB_AUTO_UPGRADE=1
      - MARIADB_DISABLE_UPGRADE_BACKUP=1
    env_file:
      - db.env
      
  app:
    image: xiaohu2023/dzzoffice
    restart: always
    ports:
      - "8080:80" # 左边8080是映射的主机端口，可修改；右边80是容器端口
    volumes:
      - "./site:/var/www/html" # ./site是站点目录位置，可修改；映射整个项目目录到容器的/var/www/html目录下
    environment:
      - MYSQL_HOST=db
      - REDIS_HOST=redis
    env_file:
      - db.env
    depends_on:
      - db
      - redis

  redis:
    image: redis:alpine
    restart: always

步骤2：自定义配置（可选）

根据需求修改以下文件，默认配置可直接跳过：

• 数据库密码：编辑docker-compose.yml，修改MYSQL_ROOT_PASSWORD=dzzoffice中的“dzzoffice”为自定义密码；
• 端口：编辑docker-compose.yml，修改ports字段（默认站点端口8080）；
• 数据库信息：编辑db.env，修改数据库名称、用户名及密码。

步骤3：启动服务

bash
docker-compose up -d

命令执行后，会自动拉取所需容器并后台运行。

步骤4：访问与初始化

容器启动完成后，通过http://服务器IP:8080访问（端口可在docker-compose.yml中修改），按页面提示完成DzzOffice初始化设置。

四、数据持久化说明

1. 持久化目录结构（Docker Compose部署）

关键数据已通过挂载宿主机目录实现持久化，目录对应关系如下：

2. 运维操作指南

3. 注意事项

• 不要手动修改./db下的文件，应通过SQL命令操作数据库；
• 建议定期备份宿主机上的./db、./site目录，避免数据丢失。

五、数据库地址填写规则（初始化配置用）

初始化DzzOffice时，需根据数据库部署位置填写正确的“数据库地址”，规则如下：

六、环境变量说明

DzzOffice容器支持通过环境变量自动初始化信息。

MYSQL/MariaDB

• MYSQL_DATABASE：数据库名
• MYSQL_USER：数据库用户
• MYSQL_PASSWORD：数据库用户密码
• MYSQL_HOST：数据库服务地址

Redis

• REDIS_HOST：Redis地址
• REDIS_PASSWORD：Redis密码

UID/GID

• PUID：站点运行用户nginx的用户UID
• PGID：站点运行用户nginx的用户组GID

PHP参数

• FPM_MAX：php-fpm最大进程数，默认50
• FPM_START：php-fpm初始进程数，默认10
• FPM_MIN_SPARE：php-fpm最小空闲进程数，默认10
• FPM_MAX_SPARE：php-fpm最大空闲进程数，默认30