安装部署指南
LittlePan_v2 作为轻量级多存储后端外链网盘管理系统，支持常规服务器/虚拟主机、新浪云（SAE）两种核心部署环境，以下是分场景的详细安装部署步骤，覆盖环境准备、安装流程、服务器配置及后续验证全流程。
一、部署前准备
1. 环境要求
| 组件 | 版本/要求 |
|---|---|
| PHP | 7.2+（最低兼容5.4，SAE环境；生产环境推荐7.4/8.0） |
| Web服务器 | Nginx/Apache（需开启 Rewrite 模块） |
| 数据库 | MySQL 5.6+（需支持 PDO_MySQL 扩展） |
| 存储依赖 | 本地存储无额外依赖；云存储（OSS/COS/OBS等）内置SDK，无需手动安装 |
| 权限要求 | 网站根目录具备读写权限（需生成 config.php、install.lock 等文件） |
2. 源码获取
从 GitHub 下载最新版本：LittlePan_v2 Releases，解压后得到完整源码包。
二、常规环境部署（Nginx/Apache 服务器）
步骤 1：上传源码
将解压后的所有源码文件上传至服务器 Web 根目录（如 /var/www/html/littlepan、虚拟主机 public_html 目录），并赋予目录合理权限：
# 示例：Linux 服务器权限配置
chmod -R 755 /var/www/html/littlepan # 目录/文件读写执行权限
chown -R www:www /var/www/html/littlepan # 绑定Web服务运行用户（如nginx/apache的www用户）
步骤 2：自动安装引导
- 访问服务器域名/IP（如
http://你的域名/），系统自动跳转至安装页面（install/index.php）；若未跳转，手动访问http://你的域名/install/。 - 步骤1：环境检测
安装程序自动检测以下项，全部「支持/未锁定」方可继续：
- PDO_MySQL 扩展（必须支持）
- PHP 版本 ≥7.0（生产建议≥7.2）
- 目录读写权限（通过创建 test.txt 验证）
- 安装锁状态（install.lock 未创建） 检测不通过时，根据提示修复（如安装 PDO 扩展、调整目录权限），修复后刷新页面重新检测。
- 步骤2：配置信息填写
填写以下核心信息，确认无误后提交：
配置项 说明 数据库地址 默认为 localhost，远程数据库填写实际IP 数据库端口 默认为 3306，根据MySQL配置调整 数据库用户名/密码 具备目标数据库读写权限的账号密码 数据库名称 需提前创建空的MySQL数据库（字符集建议utf8/utf8mb4） 管理员账号/密码 后台登录凭证，建议设置强密码（默认用户名admin） - 步骤3：安装完成
- 系统自动生成
config.php数据库配置文件，导入install.sql初始化数据表； - 创建
install/install.lock安装锁文件（防止重复安装）； - 页面提示安装成功，显示后台地址（
/admin/）和管理员账号，建议立即删除 install 目录提升安全性。
- 系统自动生成
步骤 3：服务器配置（关键）
Nginx 配置（推荐）
编辑 Nginx 站点配置文件（如 /etc/nginx/conf.d/littlepan.conf），内容如下：
server {
listen 80;
server_name 你的域名; # 替换为实际域名/IP
root /var/www/html/littlepan; # 源码根目录
index index.php index.html;
# Rewrite 规则（保证路由正常）
rewrite ^/(.*)$ /index.php/$1 last;
# PHP 解析配置
location ~ \.php(.*)$ {
fastcgi_pass 127.0.0.1:9000; # PHP-FPM 端口（根据实际调整，如9001）
fastcgi_index index.php;
fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
include fastcgi_params;
}
# 禁止访问敏感文件/目录
location ~ /install/ { deny all; }
location ~ /config.php { deny all; }
}
配置完成后重启 Nginx：systemctl restart nginx。
Apache 配置
- 开启 Rewrite 模块：
a2enmod rewrite（Ubuntu/Debian）、httpd -M | grep rewrite（验证是否开启）； - 确保源码根目录的
.htaccess文件生效，若未生效，添加以下内容：
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
- 重启 Apache：
systemctl restart apache2（Ubuntu/Debian）或systemctl restart httpd（CentOS）。
三、SAE 环境部署（新浪云）
SAE 环境适配了专属安装流程，无需手动配置数据库地址/端口，步骤如下：
- 将源码上传至 SAE 应用目录，访问应用域名时自动跳转至
install/saeinstall.php； - 步骤1：环境检测 检测项简化为：数据库信息（SAE 自动注入）、PDO 扩展、PHP 版本、安装锁状态；
- 步骤2：仅填写管理员账号/密码，提交后系统自动完成数据库连接、表结构导入；
- 安装完成后，可删除 install 目录，或保留
install.lock锁定安装权限。
四、部署后验证与初始化
1. 基础验证
- 访问首页（
http://你的域名/）：确认页面正常加载，可看到上传、管理等导航栏； - 登录后台（
http://你的域名/admin/）：使用安装时设置的账号密码登录，验证后台可正常访问； - 测试文件上传：进入「上传」页面，上传小文件（如图片），确认无报错，文件可正常显示/下载。
2. 初始化配置（后台）
- 进入后台「系统设置」：
- 配置网站标题、关键词、描述等基础信息；
- 选择存储方式（本地/阿里云OSS/腾讯云COS/华为云OBS/又拍云/WebDav）；
- 若使用云存储，填写对应服务商的提供的名称、地域等信息；
- （可选）开启高级功能：
- 文件加密：设置文件访问密码、隐藏文件列表；
- 安全配置：添加黑名单IP、限制文件类型/名称；
- API 配置：开启/关闭 API 接口，设置跨域规则。
五、常见问题排查
1. 安装页面提示「数据库连接失败」
- 检查 MySQL 服务是否启动：
systemctl status mysqld； - 验证数据库账号是否有权限访问目标数据库：
mysql -u 用户名 -p -h 地址 数据库名； - 确认服务器防火墙放行 MySQL 端口（3306），云服务器需配置安全组规则。
2. 上传文件失败/提示权限不足
- 调整 PHP 配置（php.ini）：增大
upload_max_filesize、post_max_size、max_execution_time； - 本地存储时，确认存储目录（如
uploads/）具备读写权限：chmod -R 775 存储目录； - 云存储时，检查 AccessKey/SecretKey 权限（需包含上传、读取、删除权限）。
3. 访问页面出现 404 错误
- 确认 Web 服务器 Rewrite 模块已开启，配置规则生效；
- 检查 Nginx/Apache 根目录是否指向源码根目录，index 优先级包含 index.php；
- 若为子目录部署，调整 Rewrite 规则适配子目录路径。
4. 安装后无法登录后台
- 手动重置管理员密码：登录数据库，执行 SQL 更新
pre_config表：UPDATE pre_config SET v='新密码' WHERE k='admin_pwd';
UPDATE pre_config SET v='新用户名' WHERE k='admin_user'; - 清除浏览器缓存，确认登录地址为
/admin/login.php，而非/admin/。
六、安全建议
- 部署完成后可删除 install 目录，避免恶意重装；
- 修改默认管理员账号密码，定期更换；
- 限制
config.php、includes/等敏感目录的外网访问； - 定期备份数据库（
pre_config、pre_file表）和用户文件； - 禁止上传可执行文件（如 .php、.sh），开启文件类型检测。
部署完成后，可参考项目 API 文档（apidoc.php 或后台链接）测试 API 调用能力，若遇到问题可提交 Issue 至 LittlePan_v2 GitHub 仓库。