亲测可用Chevereto V4.0.7开心版安装指南，涵盖宝塔面板环境部署（Nginx 1.22+PHP 8.0+MySQL 5.7）、伪静态规则配置、文件权限设置及常见报错解决方案。从环境搭建到数据库配置全程详解，适合新手站长快速部署图床系统，附中文搜索优化与安全增强教程。
Chevereto V4.0.7 开心版安装教程
一、环境准备（宝塔面板）
- 软件版本要求
- Nginx ≥1.22.0
- PHP ≥8.0（推荐8.1.13，需安装
fileinfo和exif扩展） - MySQL ≥5.7（务必设置默认编码为utf8mb4）
- PHP扩展检查
- 进入宝塔 → PHP管理 → 对应版本 → 扩展安装
- 勾选
fileinfo和exif→ 保存
二、站点创建
- 新建站点流程
- 域名：填写你的Chevereto域名
- 根目录：自动填充（如
/www/wwwroot/yourdomain.com） - 数据库：选择MySQL，编码强制选
utf8mb4_unicode_ci - 安装过程报错Something went wrong，好像关闭防跨站就可以了。
三、Nginx伪静态配置
- 粘贴以下规则到站点配置 → 伪静态 → 自定义：
# Chevereto核心规则
location ~* /(importing|app|content|lib)/.*.(po|php|lock|sql)$ { deny all; }
location ~ .(jpe?g|png|gif|webp)$ { log_not_found off; error_page 404 /content/images/system/default/404.gif; }
location ~* /.*.(ttf|ttc|otf|eot|woff|woff2|font.css|css|js)$ { add_header Access-Control-Allow-Origin "*"; }
location / { index index.php; try_files $uri $uri/ /index.php$is_args$query_string; }
- SSL配置（可选）
- 有证书时：站点设置 → SSL → 部署证书
四、程序部署
- 文件操作
- 清空站点根目录所有文件
- 上传
cheveretoChinaV4.zip→ 解压 - 删除冗余文件：
.htaccess、nginx.conf、原压缩包
- 权限设置
- 选中站点根目录 → 权限 → 设置用户为
www→ 数值设为755
- 选中站点根目录 → 权限 → 设置用户为
五、安装流程（关键排错点）
- 访问域名触发安装
- 浏览器打开域名，自动跳转
/install（未跳转则手动访问yourdomain.com/install）
- 浏览器打开域名，自动跳转
- 数据库配置
- 主机：
localhost（或数据库IP） - 用户名/密码：与宝塔创建的数据库凭证一致
- 数据库名：自定义（需提前在宝塔数据库管理页面创建）
- 主机：
- 常见报错解决方案
- ❌ "Something went wrong"错误
- ✅ 检查PHP扩展：确保
fileinfo和exif已启用 - ✅ 查看日志：宝塔 → 站点日志 → Nginx错误日志（搜索
error关键词） - ✅ 数据库权限：确认数据库用户有
CREATE权限
- ✅ 检查PHP扩展：确保
- ❌ 404页面
- ✅ 检查伪静态规则是否生效
- ✅ 确认根目录文件结构正确（解压后应有
app/、content/等目录）
- ❌ "Something went wrong"错误
六、安装完成
- 创建管理员账户
- 填写邮箱、用户名、密码 → 点击安装
- 安装成功后自动跳转登录页
- 后续优化建议
- 宝塔 → 计划任务 → 添加定时任务（建议每天备份数据库）
- 站点设置 → 防盗链 → 配置图片防盗链规则
附：排错检查清单
- PHP版本是否≥8.0？
fileinfo和exif扩展是否启用？- 数据库编码是否为utf8mb4？
- 伪静态规则是否完整粘贴？
- 站点目录权限是否为755？
通过以上步骤可解决90%以上安装失败问题，如仍遇阻，建议提供具体报错日志进一步分析。
