You need to enable JavaScript to run this app. cPanel环境子域名部署Laravel出现403 Forbidden错误的修复方法
优惠活动
大模型
产品
解决方案
定价
更多

cPanel环境子域名部署Laravel出现403 Forbidden错误的修复方法

cPanel环境Laravel子域名访问403 Forbidden排查修复指南

1. 先校验文档根与符号链接的匹配逻辑

  • 首先打开cPanel的「域」管理面板,找到对应子域名,核对它绑定的实际文档根路径。多数人创建子域名时会保留cPanel默认生成的独立目录(比如~/子域名.example.com),如果没有把文档根改到你创建的符号链接路径上,请求会直接落在空目录上,没有索引文件就会返回403。
  • 检查符号链接本身的有效性:在cPanel终端执行ls -l ~/,查看输出里public_html对应的链接目标是否和你实际的Laravel入口目录路径一致,排除因为路径拼写错误导致的链接断裂问题。
  • 排查主机的Symlink Protection(符号链接保护)规则:这类cPanel默认开启的安全规则,会直接拦截跨目录、跨属主的符号链接访问,只要符号链接的源路径、目标路径的系统属主不是同一个cPanel账号用户,就会触发403。如果遇到这类规则拦截,需要执行chown -R 你的cPanel账号用户名:你的cPanel账号用户名 ~/app,把项目目录的属主修正为当前账号的系统用户,满足校验要求。
  • 额外避坑:给子域名部署时不要直接覆盖主站点默认的~/public_html路径建符号链接,避免打乱主站点的原有访问结构。正确的做法是把符号链接建在cPanel给子域名分配的专属文档根路径上,比如子域名对应的专属目录是~/sub.example.com,直接执行ln -s ~/app/public_html/ ~/sub.example.com建立关联即可,不会和主站点冲突。

2. 修正权限配置的常见误区

你提到将项目目录设置为644权限,这是典型的目录与文件权限混用问题:

  • 644是普通代码文件、静态资源的适用权限,目录必须配置可执行权限(x位),系统才能遍历进入目录读取内容。把目录设置为644的话,会因为没有目录遍历权限直接触发403。
  • 适配Laravel的正确权限分层规则:
    • 项目根目录(~/app)、Laravel核心功能子目录(app、config、routes、public等)设置755权限
    • 需要PHP进程写入的storage、bootstrap/cache目录设置775权限,保证日志、缓存文件可以正常写入
    • 所有普通代码文件、入口文件、.htaccess文件保持644权限即可

3. 修正Apache目录与重写规则配置

  • 打开符号链接指向的Laravel入口目录,确认Laravel自带的public/.htaccess文件是否完整存在。很多人部署时漏传这个文件,Apache因为找不到默认索引文件,且默认开启了目录访问拦截(-Indexes),会直接返回403。
  • 在入口目录的.htaccess文件开头,增加Options +FollowSymLinks配置,允许Apache跟随目录内的符号链接,不然Apache会因为默认不允许跨路径跟随符号链接直接拦截请求。
  • 确认入口文件index.php的权限为644,没有被其他安全规则拦截。

4. 排查WAF规则误拦

  • 打开cPanel的ModSecurity管理面板,查看最近的拦截日志。如果看到403对应的拦截规则是Symlink Violation、URL Path Violation类的,属于规则对正常访问的误拦,按照规则提示在入口目录的.htaccess中针对该规则ID做局部放行即可,不要全局关闭WAF规则,避免带来安全风险。

内容的提问来源于stack exchange,提问作者Jareer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.22 01:45:10