迅睿CMS 安装部署完整教程（环境要求与常见报错）

先说结论

迅睿CMS 安装不难，90% 的失败都出在三个地方：PHP 版本不符、目录权限不对、伪静态没配。按下面流程走，一次装好的概率很高。

一、环境要求

二、安装步骤

1. 上传程序：把源码解压到网站根目录，确认 index.php 在根目录。
2. 设置权限：cache/、uploadfile/、config/ 需要可写（一般 755，部分环境需 777）。
3. 创建数据库：新建库，字符集选 utf8mb4，记下账号密码。
4. 访问安装页：浏览器打开域名，自动跳转安装向导。
5. 填写环境信息：数据库地址（一般 localhost）、库名、账号、密码、表前缀。
6. 设置管理员：账号密码务必用强密码，安装完成后立即删除 install 目录。

三、常见报错与处理

1. 提示「目录不可写」

原因：PHP 运行用户（www / nginx / apache）没有写权限。处理：

chown -R www:www /www/wwwroot/你的站
chmod -R 755 /www/wwwroot/你的站
chmod -R 777 cache uploadfile config

2. 数据库连接失败

• 检查库名/账号/密码是否有多余空格；
• 确认 MySQL 允许本地连接；
• 若用宝塔，确认数据库已创建且用户已授权。

3. 安装到一半白屏

通常是 PHP 扩展缺失或超时。在 php.ini 中把 max_execution_time 调到 300 再试，并确认 fileinfo 已启用。

4. 安装完首页 404

伪静态没配。Nginx 需在站点配置里引入迅睿的 rewrite 规则，见下一篇专题。

5. 后台登录后跳回登录页

多为 cookie 域或 session 目录权限问题。检查 session.save_path 是否可写，以及域名是否带 www 不一致。

四、安装后必做的 5 件事

1. 删除 install/ 目录；
2. 改后台默认路径（若支持）；
3. 开启伪静态并测试；
4. 配置定时备份；
5. 关闭错误显示，开启错误日志。

总结

迅睿CMS 的安装门槛主要在环境和权限，不在程序本身。装之前先确认 PHP 版本与扩展齐全，装完立刻做安全收尾，就能避免绝大多数「装完就出问题」的情况。