宝塔面板部署

宝塔面板作为可视化服务器管理工具，能大幅简化 LittlePan_v2 的部署流程，以下是适配宝塔面板的一键式部署+精细化配置教程，覆盖环境搭建、源码上传、站点配置、安装初始化全流程，零基础也可快速完成部署。

一、部署前准备

1. 宝塔面板环境要求

组件	版本/要求
服务器系统	CentOS 7+/Ubuntu 20.04+/Debian 10+（宝塔官方推荐CentOS 7）
宝塔面板	7.9+ 版本（宝塔官网 一键安装）
PHP	7.2+（宝塔面板可一键安装，推荐7.4版本，兼容SAE环境5.4+）
数据库	MySQL 5.6+（宝塔面板默认安装5.7/8.0，需开启PDO_MySQL扩展）
Web服务器	Nginx/Apache（宝塔面板默认Nginx，无需手动开启Rewrite）

2. 提前安装宝塔面板

若未安装宝塔面板，执行以下命令（CentOS 7示例）：

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

安装完成后，记录面板登录地址、账号密码，登录宝塔面板。

二、宝塔面板环境配置

步骤 1：安装运行环境

1. 登录宝塔面板 → 左侧「软件商店」→ 「运行环境」：
   • 安装「PHP 7.4」（或8.0，避免5.6及以下版本）；
   • 安装「MySQL 5.7」（或8.0，记住数据库root密码）；
   • 安装「Nginx」（默认版本即可，Apache同理）。
2. 配置PHP扩展：
   • 点击PHP 7.4右侧「设置」→ 「扩展」→ 勾选并安装「PDO_MySQL」「fileinfo」（必装）；
   • 「选项」→ 调整上传限制：upload_max_filesize设为200M、post_max_size设为200M、max_execution_time设为600（避免大文件上传超时）。

步骤 2：创建数据库

1. 宝塔面板左侧「数据库」→ 「添加数据库」：
   • 数据库名：自定义（如littlepan_db）；
   • 用户名：自定义（如littlepan_user）；
   • 密码：设置强密码（记录好，后续安装需用）；
   • 权限：勾选「本地访问」「远程访问」（可选，仅本机部署可只选本地）；
   • 点击「提交」，记住数据库地址（默认localhost）、端口（3306）、用户名、密码、数据库名。

三、上传源码并配置站点

步骤 1：下载并上传源码

1. 本地下载 LittlePan_v2 源码：GitHub Releases，解压得到源码包；
2. 宝塔面板左侧「文件」→ 进入「/www/wwwroot/」目录 → 「新建文件夹」（如littlepan）；
3. 进入littlepan文件夹 → 「上传」→ 选择解压后的所有源码文件，上传完成后「解压」（若直接上传压缩包，可右键解压）。

步骤 2：创建站点

1. 宝塔面板左侧「网站」→ 「添加站点」：
   • 域名：填写你的域名（如pan.xxx.com，无域名可填服务器公网IP）；
   • 目录：选择/www/wwwroot/littlepan（源码根目录）；
   • PHP版本：选择7.4（必须与之前安装的一致）；
   • 数据库：无需勾选（已手动创建）；
   • 其他：默认勾选「创建目录」「绑定域名」「开启HTTPS」（推荐开启，需提前解析域名）；
   • 点击「提交」，站点创建完成。

步骤 3：设置目录权限

1. 宝塔面板「文件」→ 进入/www/wwwroot/littlepan → 右键「权限」：
   • 所有者：选择「www」（宝塔默认Web运行用户）；
   • 权限：勾选「读、写、执行」（递归到子目录）；
   • 点击「确定」，确保目录可生成config.php、install.lock等文件。

步骤 4：Nginx伪静态配置（关键）

宝塔面板「网站」→ 对应站点右侧「设置」→ 「伪静态」：

1. 清空原有规则，粘贴以下Nginx伪静态规则（适配LittlePan_v2路由）：

rewrite ^/(.*)$ /index.php/$1 last;
# 禁止访问敏感文件
location ~ /install/ { deny all; }
location ~ /config.php { deny all; }

2. 点击「保存」，伪静态配置生效（Apache无需手动配置，源码内置.htaccess）。

四、执行自动安装流程

步骤 1：访问安装页面

1. 打开浏览器，访问站点域名/IP（如http://pan.xxx.com或http://服务器IP），自动跳转至安装页面（install/index.php）；
2. 若未跳转，手动访问http://你的域名/install/，进入安装向导。

步骤 2：环境检测

安装页面自动检测以下项，全部「支持/未锁定」方可继续：

• PDO_MySQL扩展：支持（已在宝塔配置）；
• 目录读写权限：支持（已设置www权限）；
• PHP版本：≥7.0（推荐7.2+）；
• 安装锁状态：未锁定； 若检测不通过，返回宝塔面板检查PHP扩展、目录权限，修复后刷新页面。

步骤 3：填写配置信息

点击「检测通过，下一步」，填写以下信息：

配置项	填写说明
数据库地址	填写localhost（宝塔本地数据库）
数据库端口	填写3306（默认）
数据库用户名	填写步骤2创建的数据库用户名（如littlepan_user）
数据库密码	填写步骤2创建的数据库密码
数据库名称	填写步骤2创建的数据库名（如littlepan_db）
管理员账号	自定义（如admin，默认admin）
管理员密码	设置强密码（记录好，后台登录用）

填写完成后点击「确认无误，下一步」，系统自动：

• 生成config.php数据库配置文件；
• 导入install.sql初始化数据表；
• 创建install.lock安装锁（防止重复安装）。

步骤 4：安装完成

1. 页面提示「数据导入完毕」，显示：
   • 成功执行SQL语句条数、失败条数；
   • 后台地址：http://你的域名/admin/；
   • 管理员账号/密码（即填写的信息）；
2. 关键操作：返回宝塔面板「文件」→ 删除littlepan/install目录（避免恶意重装）；
3. 点击「进入网站首页」，验证首页是否正常加载。

五、部署后配置与验证

1. 后台初始化配置

1. 访问http://你的域名/admin/，用管理员账号密码登录后台；
2. 「系统设置」：
   • 填写网站标题、关键词、描述；
   • 选择存储方式：本地存储（默认）/阿里云OSS/腾讯云COS等（需填写对应AccessKey、SecretKey）；
   • （可选）开启文件加密、IP黑名单、文件类型限制；
   • 保存配置，生效。

2. 功能验证

• 首页访问：http://你的域名/，确认导航栏（首页、上传、管理、API文档、关于）正常显示；
• 文件上传：点击「上传」，上传小文件（如图片），确认无报错，文件可显示/下载；
• 后台管理：进入「文件管理」，确认已上传文件列表正常，可删除/编辑；
• API文档：点击「API文档」，确认接口地址、启用状态正常（需后台开启API）。

六、常见问题排查（宝塔环境专属）

1. 安装页面提示「数据库连接失败」

• 检查数据库是否创建成功：宝塔「数据库」→ 对应数据库「管理」→ 测试连接；
• 确认数据库账号密码正确：宝塔「数据库」→ 对应数据库「修改密码」，重新填写；
• 关闭服务器防火墙/宝塔安全组：宝塔「安全」→ 放行3306端口（MySQL）、80/443端口（Web）。

2. 上传文件提示「权限不足」

• 检查目录权限：宝塔「文件」→ littlepan/uploads（本地存储目录）→ 右键「权限」，设为www用户可读写；
• 调整PHP上传限制：宝塔「PHP设置」→ 「选项」，增大upload_max_filesize/post_max_size；
• 关闭宝塔「网站安全」→ 「防跨站攻击」（若开启，可能拦截上传）。

3. 页面404/伪静态失效

• 确认伪静态规则：宝塔「网站」→ 「伪静态」，检查是否粘贴正确规则；
• 刷新Nginx配置：宝塔「软件商店」→ Nginx → 「重启」；
• 确认站点目录正确：宝塔「网站」→ 「根目录」，是否指向littlepan源码根目录。

4. 后台登录提示「账号密码错误」

• 重置管理员密码：宝塔「数据库」→ 对应数据库「管理」→ 执行SQL：

  UPDATE pre_config SET v='新密码' WHERE k='admin_pwd';
  UPDATE pre_config SET v='新用户名' WHERE k='admin_user';

• 清除浏览器缓存，重新登录。

七、安全优化（宝塔环境）

1. 宝塔「安全」→ 「SSH端口修改」（默认22改为自定义，如2222）；
2. 宝塔「网站」→ 「防护」→ 开启「CC防护」「限IP访问」（可选）；
3. 定期备份：宝塔「备份」→ 「网站备份」+「数据库备份」，设置自动备份（每日/每周）；
4. 禁用危险函数：宝塔「PHP设置」→ 「禁用函数」，添加eval、exec等危险函数；
5. 定期更新：宝塔「软件商店」→ 更新PHP、Nginx、MySQL至最新稳定版。

至此，LittlePan_v2 在宝塔面板环境下部署完成，可正常使用文件上传、管理、外链分享等核心功能，如需适配SAE环境，可参考宝塔「应用商店」是否有SAE相关插件，或单独部署SAE运行环境。