DzzOffice 安装全教程

DzzOffice 是一个开源的在线办公套件，类似于 Nextcloud 或 ownCloud，可以用来搭建你自己的私有云盘、在线文档、协作文档等，它基于 PHP 和 Web 服务器技术。

安装前准备（环境要求）

在开始安装之前，请确保你的服务器或本地环境满足以下最低要求，我们以最推荐的 Linux (Nginx + MySQL) 环境为例进行讲解。

系统要求

• 操作系统: Linux (如 CentOS 7+, Ubuntu 18.04+), Windows (需配置好 PHP 环境), macOS (需配置好 PHP 环境)
• 推荐: Linux + Nginx + MySQL + PHP (LNMP) 环境,这是性能和稳定性最好的组合。

软件环境

• Web 服务器: Nginx (推荐) 或 Apache
• 数据库: MySQL 5.6+ 或 MariaDB 5.5+
• PHP: PHP 7.2+ (推荐 7.4 或 8.0/8.1，注意 DzzOffice 对 PHP 8.2+ 的支持可能有限,请优先选择稳定版本)
• PHP 扩展 (必须安装):
  • pdo_mysql
  • curl
  • gd (或 imagick)
  • mbstring
  • zip
  • fileinfo

服务器资源

• 内存: 建议 512MB 以上，推荐 1GB 或以上。
• 硬盘: 建议 1GB 以上可用空间。
• 域名: 一个已解析到服务器 IP 的域名（可选，但推荐使用，方便访问）。

安装步骤

我们将分为几个关键步骤来完成安装。

步骤 1: 安装 LNMP 环境

如果你使用的是全新的云服务器（如阿里云、腾讯云、Vultr 等），首先需要安装 LNMP 环境，这里以在 Ubuntu 20.04 上安装为例。

安装 Nginx

sudo apt update
sudo apt install nginx -y

安装 MySQL/MariaDB

# 安装 MariaDB (MySQL 的一个分支，完全兼容)
sudo apt install mariadb-server mariadb-client -y
# 安全配置
sudo mysql_secure_installation

在 mysql_secure_installation 过程中，会提示你设置 root 密码，以及一些安全选项（如移除匿名用户、禁止root远程登录等），一路按 Y 并回车即可。

安装 PHP 和所需扩展

# 安装 PHP 8.0 和相关扩展 (如果你的系统源支持，也可以安装 7.4)
sudo apt install php8.0-fpm php8.0-mysql php8.0-curl php8.0-gd php8.0-mbstring php8.0-zip php8.0-fileinfo -y

安装完成后，启动并启用 PHP-FPM 服务：

sudo systemctl start php8.0-fpm
sudo systemctl enable php8.0-fpm

步骤 2: 下载并部署 DzzOffice

下载 DzzOffice 前往 DzzOffice 官网下载最新稳定版的安装包。

• 官网地址: https://www.dzzoffice.com/
• 下载地址: https://www.dzzoffice.com/download

假设我们下载了 DzzOffice_Release_v2.x.zip 文件，并将其上传到服务器的 /var/www/ 目录下。

解压并移动文件

# 进入网站根目录
cd /var/www/
# 解压压缩包
unzip DzzOffice_Release_v2.x.zip
# 解压后可能会生成一个类似 DzzOffice_Release_v2.x 的文件夹，将其内容移动到当前目录
# 假设解压后的文件夹名为 DzzOffice_Release_v2.x
mv DzzOffice_Release_v2.x/* ./
# 清理不需要的文件夹
rm -rf DzzOffice_Release_v2.x.zip DzzOffice_Release_v2.x

设置目录权限 这是非常关键的一步，确保 Web 服务器有权限写入必要文件。

# 将网站目录的所有者改为 www-data (Nginx 的默认用户)
sudo chown -R www-data:www-data /var/www/
# 给予必要的写入权限
sudo chmod -R 755 /var/www/
sudo chmod -R 777 /data/ /attachment/ /config/ /misc/ /framework/ /admin.php /index.php /upgrade.php

注意: /data/ 目录用于存储上传的文件，/config/ 用于存储配置文件，必须设置为 777 权限以保证安装和运行正常，安装完成后，你可以考虑将 /config/ 的权限改回 755 以增加安全性。

步骤 3: 配置 Nginx

创建一个新的 Nginx 配置文件来托管 DzzOffice。

创建配置文件

sudo nano /etc/nginx/sites-available/dzzoffice

粘贴以下配置

server {
    listen 80;
    server_name your_domain.com; # 替换成你的域名
    root /var/www;
    index index.php index.html index.htm;
    # 访问日志和错误日志
    access_log /var/log/nginx/dzzoffice.access.log;
    error_log /var/log/nginx/dzzoffice.error.log;
    # 重写规则，将请求转发到 index.php
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    # 处理 PHP 请求
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.0-fpm.sock; # 确保 sock 文件路径正确
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    # 禁止访问敏感文件
    location ~ ^/(data|config|attachment|misc)/ {
        deny all;
    }
}

重要修改:

• 将 server_name your_domain.com; 中的 your_domain.com 替换为你的真实域名。
• fastcgi_pass 路径 unix:/run/php/php8.0-fpm.sock 需要与你安装的 PHP 版本对应，如果不确定，可以使用 find /run/php -name "*fpm.sock" 命令查找。

启用站点

# 创建软链接启用站点
sudo ln -s /etc/nginx/sites-available/dzzoffice /etc/nginx/sites-enabled/
# 测试 Nginx 配置是否有误
sudo nginx -t
# 如果测试通过，重载 Nginx 配置
sudo systemctl reload nginx

步骤 4: 通过 Web 界面完成安装

打开你的浏览器，访问你设置的域名或服务器的 IP 地址。

http://your_domain.com

或者

http://your_server_ip

你应该会看到 DzzOffice 的安装向导界面。

检查环境 安装程序会自动检测你的 PHP 和数据库环境，如果所有项都显示为“√”或绿色“通过”，则说明环境配置正确，如果有红叉,请根据提示返回上一步检查并修复。

数据库配置

• 数据库类型: 选择 MySQL
• 数据库地址: localhost
• 数据库用户名: root
• 数据库密码: 你在步骤 1 中设置的 MySQL root 密码
• 数据库名: 可以自定义一个，dzzoffice
• 数据库表前缀: 使用默认的 dzz_ 即可

点击“创建数据库”按钮，如果提示成功,则继续。

管理员账户配置

• 管理员用户名: 设置一个你想要的管理员账号
• 管理员密码: 设置一个强密码
• 管理员邮箱: 填写你的邮箱

开始安装 点击“开始安装”按钮,程序会自动完成剩余的数据库写入和文件配置过程。

完成安装 安装成功后，会提示你删除 install 目录，为了安全,请务必执行：

sudo rm -rf /var/www/install/

你就可以通过浏览器访问你的 DzzOffice 办公系统了,使用刚刚设置的管理员账号登录。

常见问题与解决方案

• Q1: 安装时提示 "config 目录不可写" 或 "权限错误"

  • A: 请返回 步骤 2，仔细检查并执行 chmod -R 777 /config/ 命令，确保 Web 服务器用户（如 www-data）对该目录有完全控制权。

• Q2: 访问网站出现 404 Not Found 错误

  • A: 通常是 Nginx 配置问题。
    1. 检查 root 指令是否指向正确的网站目录（/var/www）。
    2. 检查 server_name 是否正确。
    3. 运行 sudo nginx -t 检查配置语法，sudo systemctl reload nginx。

• Q3: 页面样式错乱或资源加载失败

  • A: 这通常是由于 Nginx 配置中缺少对 location / 的 try_files 指令，导致静态资源无法正确重定向，请确保你的 Nginx 配置文件中包含了这部分代码。

• Q4: PHP 版本过高导致不兼容

  • A: DzzOffice 对最新 PHP 版本（如 8.2+）的支持可能不完全，建议在安装 PHP 时选择一个稳定且被官方推荐的版本，如 PHP 7.4 或 8.0。

• Q5: 如何升级 DzzOffice？

  • A: DzzOffice 提供了在线升级功能，登录后台，系统会检测到新版本并提供升级包，下载升级包并解压到网站的根目录，然后访问 http://your_domain.com/upgrade.php，按照提示操作即可。升级前务必备份数据库和 /data 目录！