当前位置：首页 > news >正文

前端基础：React项目打包部署服务器教程

news 来源：原创 2025/6/20 13:14:45

问题背景

我做了一个React框架的前端的Node项目，是一个单页面应用。

页面路由用的是，然后使用了React.lazy在路由层级对每一个不同页面进行了懒加载，只有打开那个页面才会加载对应资源。

然后现在我用了Webpack5对项目进行了打包，需要将项目部署到服务器上。

PS：vue项目打包部署同理。

打包好的build文件夹如下图。

问题解决

方法一：Serve静态服务器

使用前服务器环境需要安装好NodeJS和npm。

使用npm -v 和 node -v进行查看。

安装好之后就要安装serve。

# 全局安装serve
npm install -g serve

安装好之后，将本地打包的build文件夹都上传到服务器目录中。

用终端打开对应的项目的文件夹（注意文件路径是在build文件夹的上一层，如下图）。

终端输入serve -s build运行静态服务器。

运行成功的效果如上图所示，该项目就运行在指定的端口中，可以输入 -l 参数，指定运行端口。

serve -s -l 3333 build

方法二：Nginx代理静态页面

先确保服务器安装好Nginx，能正常运行。

将项目的打包build文件夹上传到服务器中。

然后就是改Nginx的配置文件了。

server
{
    listen 80;
	listen 443 ssl http2;
    server_name xxxxxxxxxxxx; # 改成自己的域名或ip 
	index index.php index.html index.htm default.php default.htm default.html;
    root /www/frontTeachingSystem/build;

    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    ssl_certificate    /www/server/panel/vhost/cert/xxxxxxxxxxxx/fullchain.pem;
    ssl_certificate_key    /www/server/panel/vhost/cert/xxxxxxxxxxxx/privkey.pem;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";
    error_page 497  https://$host$request_uri;
		#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-00.conf;
    #PHP-INFO-END

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/xxxxxxxxxxxx.conf;
    #REWRITE-END
    
    location / {
         try_files $uri $uri/ /index.html;
    }

    #禁止访问的文件或目录
    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/xxxxxxxxxxxx.log;
    error_log  /www/wwwlogs/xxxxxxxxxxxx.error.log;
}

以上是我的Nginx的配置文件，我是弄了SSL证书的。

注意一定要加下面这段。

location / {
     try_files $uri $uri/ /index.html;
}

因为我部署的是单页面应用，页面的路由是虚拟路由，实际并没有对应的文件，如果不加这个的话，路由跳转时Nginx会去寻找对应的文件，导致找不到文件404错误，项目无法正常运行。

我一开始在网上搜索资料的时候，查到的让把"root"属性的文件路径改在build文件夹的上一层，然后在index属性中加入"build"，像下面这样

server
{
    listen 80;
	listen 443 ssl http2;
    server_name xxxxxxxxxxxx; # 改成自己的域名或ip 
	index build index.php index.html index.htm default.php default.htm default.html;
    root /www/frontTeachingSystem;
}

但我试了下不能正常运行，改成上面的那样就可以了。