迅睿CMS目录权限配置从零开始实操指南 解决各类权限报错问题

前置说明

本指南针对生产环境最常用的Linux服务器，Windows服务器默认IIS/Apache权限一般不会触发权限问题，无需额外配置。所有操作同时适用于命令行环境和宝塔等可视化面板，零门槛可跟随操作。

操作前准备

1. 确认网站根目录路径

如果你使用宝塔/堡塔面板，可以直接在「网站-对应站点」中看到根目录路径，默认格式为 /www/wwwroot/你的域名/；如果是手动搭建的环境，默认根目录一般是 /var/www/html/你的站点目录/。判断根目录是否正确：根目录下必须同时存在index.php、vendor、config三个内容，符合就是正确目录。

2. 查询Web服务器运行用户

Linux下权限报错的核心原因绝大多数是目录所属用户错误，必须让Web服务器的运行用户拥有目录读写权限。通过SSH连接服务器后执行以下命令查询：

``` 查询Nginx运行用户 ps -ef | grep nginx | grep -v root | awk '{print $1}' | head -1 查询Apache运行用户 ps -ef | grep httpd | grep -v root | awk '{print $1}' | head -1 ```

查询结果一般为 www、nginx 或 apache，记下这个用户名，后续配置会用到。

具体权限配置步骤

提供两种操作方式，新手推荐选择面板图形化操作，有基础的可以用命令行快速配置。

方式一：SSH命令行配置（全环境通用）

1. SSH连接服务器后，进入你的网站根目录，执行命令： ``` cd 你的根目录路径 示例：cd /www/wwwroot/www.xxx.com ```
2. 修改整个站点目录的所属用户，把下文命令中的www:www替换成你刚才查到的Web用户名，比如查到的是nginx就改成nginx:nginx： ``` chown -R www:www ./ ```
3. 设置全局基础权限，所有目录默认给755，所有文件默认给644，兼顾运行安全和权限需求： ``` find ./ -type d -exec chmod 755 {} \; find ./ -type f -exec chmod 644 {} \; ```
4. 给需要写入的特殊目录设置777权限，依次执行以下命令： ``` chmod -R 777 ./cache/ chmod -R 777 ./config/ chmod -R 777 ./uploadfile/ chmod -R 777 ./dayrui/attachment/ 如果有移动端/多端附件目录，追加执行： chmod -R 777 ./mobile/attachment/ 如果开启静态HTML生成，追加执行： chmod -R 777 ./html/ ```

方式二：宝塔面板图形化配置（新手推荐）

• 登录宝塔面板后台，点击左侧菜单「网站」，找到你的迅睿CMS站点，点击「根目录」进入文件管理页面
• 勾选根目录下所有文件和文件夹，点击顶部菜单栏的「权限」按钮
• 在弹出的权限输入框中，输入 755，勾选「递归设置子目录和文件」，点击确定，等待执行完成
• 回到根目录，依次找到cache、config、uploadfile、dayrui/attachment这四个目录，右键点击单个目录，选择「权限」选项
• 在弹出框输入权限值 777，勾选「递归到子目录和文件」，点击确定，每个目录重复操作一次
• 如果有多端附件目录或者静态生成目录，重复上面第4-5步设置权限即可，配置完成

配置完成验证方法

配置完成后，按照以下步骤验证，避免隐性权限问题：

• 打开迅睿CMS前台首页，刷新多次，确认无报错、图片能正常加载
• 登录后台，进入「系统-缓存更新」，点击更新全部缓存，更新过程无报错说明cache和config权限正常
• 进入「内容管理」，新增一篇文章并上传一张图片，保存后能正常打开文章、图片正常显示，说明附件目录权限正常
• 开启伪静态的站点，点击几个栏目页、内容页，确认能正常打开，无权限类报错，说明全部配置正常

常见问题排查

1. 配置完还是提示缓存目录不可写

大概率是CentOS系统默认开启的SELinux拦截了写入权限，执行以下命令关闭即可永久生效： ``` setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config ``` 执行完成后重启服务器即可解决。

2. 安装阶段提示config目录不可写

未安装时系统需要写入初始配置文件，直接给config目录设置777权限即可，安装完成后也不需要修改回去，不影响系统安全。

3. 修改权限后不生效

检查面板是否开启了防篡改保护、目录只读锁定，关闭保护后重新配置即可；部分面板权限修改需要1-2分钟生效，清空浏览器缓存重新测试即可。

4. 为什么不给所有目录开777？

全目录开启777会带来代码被注入篡改的安全风险，仅给需要写入的目录开放777，是兼顾正常运行和安全的最优配置，按本文操作即可满足需求。