搭建安装教程

本教程以宝塔面板为例，详细介绍如何将泽信网盘系统部署到 Linux 服务器并投入使用。即使您没有深厚的服务器运维经验，按照本教程逐步操作也能完成部署。

环境要求

在部署之前，请确保服务器满足以下最低环境要求：

组件	最低要求	推荐版本
PHP	≥ 7.4	8.0 或更高
MySQL	≥ 5.7	8.0
Web 服务器	Nginx 或 Apache	Nginx 1.20+
PHP 扩展	PDO、PDO_MySQL	同时安装 GD、Fileinfo、OpenSSL

PHP 扩展说明

• PDO / PDO_MySQL： 必须安装，用于连接 MySQL 数据库。
• GD： 可选，用于图片缩略图生成。
• Fileinfo： 可选，用于文件类型识别。
• OpenSSL： 可选，用于 HTTPS 和加密操作。

宝塔环境准备

安装宝塔面板

如果您的服务器尚未安装宝塔面板，可访问 宝塔官网 获取最新安装命令，一般形如：

yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec

安装完成后，根据终端提示的地址、用户名和密码登录宝塔面板。

安装 LNMP 环境

1. 登录宝塔面板，点击左侧「软件商店」。
2. 安装以下软件：
   • Nginx（推荐 1.24+）
   • MySQL（推荐 8.0）
   • PHP（推荐 8.0 或 8.1）
   • phpMyAdmin（可选，用于管理数据库）
3. 等待安装完成。

安装 PHP 扩展

1. 点击宝塔面板左侧「软件商店」→ 找到已安装的 PHP 版本 → 点击「设置」。
2. 切换到「安装扩展」标签页。
3. 依次安装 pdo、pdo_mysql、gd、fileinfo、openssl。
4. 安装完成后重启 PHP 服务。

创建站点

1. 点击宝塔面板左侧「网站」→「PHP 项目」→「添加站点」。
2. 填写域名，例如 pan.yourdomain.com。
3. 根目录保持默认或自定义，例如 /www/wwwroot/pan.yourdomain.com。
4. 选择 PHP 版本为刚刚安装的版本（如 PHP-8.0）。
5. 提交创建站点。

上传程序代码

方式一：通过宝塔文件管理器上传

1. 在本地将泽信网盘系统源码压缩为 zip 文件。
2. 进入宝塔面板「文件」→ 打开站点根目录。
3. 点击「上传」，选择压缩包上传。
4. 上传完成后右键压缩包，选择「解压」，将文件解压到站点根目录。

方式二：通过 Git 拉取

如果源码托管在 Git 仓库，可在站点根目录下执行：

cd /www/wwwroot/pan.yourdomain.com
git clone https://your-git-repo.git .

检查目录结构

解压或拉取完成后，站点根目录应包含以下文件和文件夹：

.
├── app/
├── assets/
├── config/
├── database/
├── help/
├── install/
├── uploads/
├── index.php
└── ...

创建数据库

1. 点击宝塔面板左侧「数据库」→「添加数据库」。
2. 填写数据库名，例如 zexin_pan。
3. 设置用户名和密码，例如 zexin_user。
4. 提交创建，并记录数据库名、用户名和密码。

设置目录权限

在宝塔面板「文件」中，选中站点根目录，为以下目录设置可写权限（建议 755，若不可写可尝试 775 或 777）：

• config/
• uploads/
• install/

设置方法：右键目录 → 权限 → 勾选「应用到子目录」→ 设置为 755 或 775，所有者设置为 www。

Nginx 伪静态配置

泽信网盘系统需要将所有请求转发到 index.php，因此必须配置 URL 重写规则。

宝塔配置方法

1. 进入宝塔面板「网站」→ 点击站点名称 →「设置」。
2. 切换到「伪静态」标签页。
3. 选择伪静态规则为 laravel5 或手动填写以下内容：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

location ~ /\.(?!well-known).* {
    deny all;
}

HTTPS 反向代理注意事项

如果站点通过 CDN 或反向代理使用 HTTPS，请在 Nginx 配置中添加协议头转发，避免系统识别为 HTTP 导致 301 重定向丢失 POST 数据：

location / {
    try_files $uri $uri/ /index.php?$query_string;
    proxy_set_header X-Forwarded-Proto $scheme;
}

运行安装向导

1. 在浏览器中访问站点域名，例如 https://pan.yourdomain.com。
2. 系统会自动检测到未安装，并重定向到 /install/ 安装向导。
3. 安装向导共分为四步：
   • 第一步：欢迎协议 — 阅读程序使用协议，勾选同意后点击下一步。
   • 第二步：环境检测 — 系统自动检测 PHP 版本、扩展和目录权限，全部通过后进入下一步。
   • 第三步：数据库配置 — 填写数据库主机（通常为 127.0.0.1 或 localhost）、端口（默认 3306）、数据库名、用户名、密码和表前缀（默认 zx_）。系统会自动创建数据库并导入初始 SQL。
   • 第四步：管理员设置 — 设置站点管理员用户名、邮箱和密码，完成后系统会删除默认管理员并创建 install/install.lock 锁定文件。
4. 安装完成后，访问首页即可看到站点前台。

安装后检查

检查首页访问

访问站点域名，确认首页正常显示，没有 500 错误或空白页面。

检查注册登录

1. 点击「注册」，填写信息完成注册。
2. 使用注册账号登录，进入「我的文件」页面。
3. 尝试上传一个小文件，确认上传和下载功能正常。

检查后台访问

1. 使用安装时设置的管理员账号登录。
2. 点击「后台」进入管理控制台。
3. 尝试修改站点名称并保存，确认设置能正常写入数据库。

常见问题

访问首页提示 500 错误

1. 检查 config/config.php 是否存在且数据库配置正确。
2. 检查 config/ 目录是否有可写权限。
3. 开启调试模式查看详细错误信息。

安装向导无法创建数据库

1. 确认数据库用户名和密码正确。
2. 确认数据库用户有创建数据库的权限。
3. 如果使用的是宝塔创建的数据库，通常已具备所需权限。

文件上传失败

1. 检查 uploads/ 目录是否有可写权限。
2. 检查 PHP 的 upload_max_filesize 和 post_max_size 是否足够大。
3. 检查磁盘空间是否充足。

样式或 JS 文件加载 404

1. 确认 assets/ 目录已上传到站点根目录。
2. 检查 Nginx 重写规则是否正确，确保静态资源请求不被错误转发。

安装完成后访问 /install/ 仍然显示安装向导

1. 检查 install/install.lock 文件是否存在。
2. 如果不存在，手动创建一个空文件 install/install.lock。