将Arco框架的前端项目部署至CentOS 7并访问WebAPI

本文通过将 arco 框架的前端项目，部署至 CentOS 7，并访问同服务器的 WebAPI 接口，来简单演示一下，如何将前端项目发布至 Linux 系统。

关于 ASP.NET WebAPI 发布至 Linux 的步骤，可以参考博主过往文章： https://www.cnblogs.com/hnzhengfy/p/18384107/webapi_centos 。

一、简单创建一个前端项目，基于 Arco Design Vue

环境准备和项目创建。首先是要提前安装好nodejs，注意版本会有影响，本文推荐直接安装 18.20.0 版本，下文 1.2 中问题汇总再详解。

下载地址可使用阿里云镜像地址： https://mirrors.aliyun.com/nodejs-release/ .

然后安装arco cli： npm i -g arco-cli

上述环境准备好后，就可以进行项目的初始化了。如下： npm init web.test.arco

最后，直接运行项目： E:\OneSelf\ArcoDesignVueWorkSpace\web.test.arco>npm run dev

通过地址 http://localhost:5173/ 进行访问，直接登录后即可查看示例页面：

最后，可以通过命令 npm run build 将示例项目打包，备用。

1.2 遇到的问题

1.2.1 初始化失败【Error: spawnSync npm.cmd EINVAL】

原因是child_process.spawn有漏洞(CVE-2024-27980)-(HIGH)，调用要加 { shell: true }。2024.4.10 node 修复了这个漏洞，代码执行就报错了。cli 下载 arco-design-pro-vue 执行到 .arco-cli\init.js 就出现 spawn 报错。

解决办法：使用 18.20.2,20.12.2,21.17.3 之前的版本就可以了。我用 18.20.0 版本就可以了。各版本阿里云下载地址： https://mirrors.aliyun.com/nodejs-release/

参考： https://github.com/arco-design/arco-cli/issues/92

1.2.2 镜像地址证书过期

更新镜像地址即可。

先备份npm配置，可以防止在更换过程中出现意外导致配置丢失

npm config get > npm_config.txt

npm config set registry https://registry.npmmirror.com

npm install --save-dev @arco-design/web-vue

npm i -g arco-cli

1.2.3 项目依赖安失败

解决方案：

• 打开命令行，切换到项目目录，例如：cd your_project_directory。
• 运行以下命令来清除之前的依赖缓存：yarn cache clean。
• 更新项目的依赖包：yarn upgrade。
• 重新安装项目依赖：yarn install。

二、Nginx 安装和配置

安装步骤详见博主过往文章（ Nginx的安装和测试：https://www.cnblogs.com/hnzhengfy/p/Nginx.html#_label3 ），本文不在赘述。

配置文件位置：/usr/local/nginx/conf 中的 nginx.conf。

执行程序位置：/usr/local/nginx/sbin 中的 nginx。

2.1 Nginx 文件配置

先将打包好的前端测试文件，上传到 Linux 中，本文示例是复制到 /home/web.arco 文件夹。

配置大概思路：

• 在前端项目中，其实是分两种请求的，一种是页面加载，另一种是访问后端接口进行数据操作。
• 如何区分这两种操作？那就只能通过请求路径了，给接口请求的路径统一加个标记，比如 /apiarco。
• 然后，这个路径中的标记在后端接口中又是没有的，那就需要在 Nginx 中做下替换，即 URL 重写。
• 经过重写后的请求，就会直接到达候选 api 服务，当然后端也有必要配置允许跨域访问。

如下 Nginx 配置文件中的 server 模块：

    server {
        listen       8001;
        listen       [::]:8001;
        server_name  _;
        root         /home/web.arco; # 设置服务器的根目录为 /home/web.arco

        location / {
                root   /home/web.arco;
                index  index.html index.htm; # 尝试按照顺序查找 index.html 或 index.htm 文件
                try_files $uri $uri/ /index.html; # 如果找不到这些文件，它将返回 /index.html
        }
        # /apiarco 路径中包含此标识，进行特殊处理
        location /apiarco {
                proxy_pass http://localhost:5000/; # 将请求代理到本地的 5000 端口，就是 api 接口地址
                rewrite ^/apiarco/(.*)$ /$1 break; # URL 重写为去掉 /apiarco 前缀
        }
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }

当同时部署多个前端服务时，可以再配置一个 server 节点。

    server {
        listen       8002;
        listen       [::]:8002;
        server_name  _;
        root         /home/web.arco.new;

        location / {
                root   /home/web.arco.new;
                index  index.html index.htm;
                try_files $uri $uri/ /index.html;
        }
        location /apiarconew {
                proxy_pass http://localhost:5000/;
                rewrite ^/apiarconew/(.*)$ /$1 break;
        }
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }