服务器部署,用 nginx 部署后页面刷新 404 问题,宝塔面板修改(修改 nginx.conf 配置文件)

如果你的项目使用了 vue,并使用了路由且路由配置为 history 模式,就会出现这种情况。

当你使用 nginx 部署前端项目时,发现页面刷新或不用根目录访问页面时,出现404页面

宝塔面板

解决方法:修改 nginx 配置,我这边用的宝塔部署,所以改配置也是相对简单的,只需要加一行代码就行。具体步骤如下

1. 部署网站后,在宝塔网站中点击设置

2. 在设置中的配置文件,server中添加相应代码即可,

try_files $uri $uri/ /index.html; #解决刷新页面变成404问题的代码

3. 保存立即生效,快去试试吧。

修改配置文件

如果不是宝塔的话,可以找一下你项目对应的 nginx.conf 这个文件,对这个文件进行修改就可以了。

server
{
		listen 8081;
    server_name 地址;
    index index.php index.html index.htm default.php default.htm default.html;
    root 目录;


# gzip on;
#     gzip_min_length 1k;
#     gzip_comp_level 9;
#     gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;
#     gzip_vary on;
#     gzip_disable "MSIE [1-6].";
    
    try_files $uri $uri/ /index.html;    #解决刷新页面变成404问题的代码


    #SSL-START SSL相关配置,请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    #SSL-END

    #ERROR-PAGE-START  错误页配置,可以注释、删除或修改
    #error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END

    #PHP-INFO-START  PHP引用配置,可以注释或修改
    include enable-php-80.conf;
    #PHP-INFO-END

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/lin-blog.com.conf;
    #REWRITE-END

    #禁止访问的文件或目录
    location ~ ^/(.user.ini|.htaccess|.git|.env|.svn|.project|LICENSE|README.md)
    {
        return 404;
    }

    #一键申请SSL证书验证目录相关设置
    location ~ .well-known{
        allow all;
    }

    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/.well-known/.*.(php|jsp|py|js|css|lua|ts|go|zip|tar.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }

    location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*.(js|css)?$
    {
        expires      12h;
        error_log /dev/null;
        access_log /dev/null;
    }
    access_log  /www/wwwlogs/xxx.log;
    error_log  /www/wwwlogs/xxx.com.error.log;
}

主要就是添加一行代码,在 server 中就可以了。

try_files $uri $uri/ /index.html; #解决刷新页面变成404问题的代码

### 宝塔面板修改Nginx和PHP网站根目录后的配置调整 当通过宝塔面板修改网站的根目录时,需要同步调整Nginx和PHP的相关配置文件及参数,以确保服务正常运行并避免诸如404错误等问题。 #### 1. 调整Nginx配置文件宝塔面板中,Nginx的站点配置文件通常位于`/www/server/panel/vhost/nginx/`路径下的对应站点`.conf`文件中。如果更改了网站根目录,则需要编辑该文件中的`root`指令指向新的根目录位置[^1]: ```nginx server { listen 80; server_name yourdomain.com; root /new/path/to/root; # 更改为新根目录的位置 index index.php index.html; location / { try_files $uri $uri/ =404; } # 如果有其他特定需求(如伪静态规则),也需要一并调整 } ``` 完成上述修改后,保存配置文件并通过命令行重新加载Nginx配置使其生效: ```bash nginx -s reload ``` #### 2. 更新PHP-FPM配置 对于基于PHP的应用程序,在修改网站根目录的同时还需要确认PHP-FPM的配置是否正确关联到新的根目录。这一步骤主要涉及FastCGI处理部分的设置,例如`fastcgi_pass`指令及其相关参数。 在宝塔面板中,默认情况下PHP-FPM的配置会自动绑定至对应的虚拟主机上。然而,手动检查以下内容仍然是必要的: - **脚本解析**:确保`location ~ \.php$ {}`块内的配置能够正确定位到目标PHP文件。 以下是典型的PHP-FPM配置片段示例: ```nginx location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/tmp/php-cgi-74.sock; # 根据实际使用的PHP版本调整sock地址 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } ``` 注意这里的`SCRIPT_FILENAME`变量应始终指向当前请求的实际物理路径[^2]。 #### 3. 自定义日志记录 为了便于后续排查可能产生的访问异常情况,可以考虑自定义Nginx的日志格式以便更清晰地跟踪流量数据。此操作可通过编辑全局或单个站点级别的HTTP上下文中实现。例如增加如下字段用于增强日志信息量[^3]: ```nginx log_format custom '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent"' 'rt=$request_time ut="$upstream_response_time" cs=$upstream_cache_status'; access_log /www/wwwlogs/custom_access.log custom; error_log /www/wwwlogs/error.log warn; ``` #### 4. 特殊场景——动态路由支持 某些框架依赖于动态URL重写机制工作,因此单纯改变根目录可能导致内部链接失效而引发404错误。针对此类情形,可在Nginx配置里加入适当的try_files语句来优先匹配真实存在的资源;若未找到则交由应用层进一步处理[^4]: ```nginx location / { try_files $uri $uri/ /index.php?$query_string; } ``` 以上即为使用宝塔面板管理环境下,因切换网站根目录所必需执行的一系列核心改动要点概述。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值