部署说明

### 引言
请确保已经认真阅读前面的文档内容再尝试部署。

## 单体应用
### 后端编译
项目是SpringBoot项目，按照SpringBoot的方式直接打包即可。如果不清楚SpringBoot项目如何打包，请自行百度。

>d **直白一些**
>看图说话
> 
![](/media/202506/b682d94d34a64c788237c2e7efa986638395.png)
==最后在xingyun-api的target目录下得到一个jar包，这个就是打包好的后端程序了。==

### 前端编译
1. 在项目根目录打开终端，输入命令：pnpm install
2. 开始打包，输入命令：pnpm run build
3. 在项目根目录得到dist目录，即为打包好的文件。

### 手动部署

服务器上需要安装nginx，用来部署前端项目以及做后端接口的转发。至于nginx如何使用请自行百度。

nginx的关键配置如下：

```conf
server
{
    listen 80;
    server_name localhost; # 这里可以改成自己的域名
    index index.html index.htm default.htm default.html;
    root /xxx/dist; # 这里为编译后的前端项目路径
    
    # 反向代理，将/api/**的请求转发至后端项目
    location ^~ /api/ {
        proxy_pass http://127.0.0.1:8080/; # 后端默认端口是8080，如果自己修改了端口，这里也要改，端口号后面的/不要丢
        proxy_set_header Host $Host:$server_port;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        add_header X-Cache $upstream_cache_status;

proxy_connect_timeout 30s;
        proxy_read_timeout 86400s;
        proxy_send_timeout 30s;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
    
    # 反向代理，将/dynamic/web/**的请求转发至后端项目，这个location是magic-api的配置页面
    location ^~ /dynamic/web/ {
        proxy_pass http://127.0.0.1:8080/dynamic/web/; # 后端默认端口是8080，如果自己修改了端口，这里也要改，端口号后面的/不要丢
        proxy_set_header Host $Host:$server_port;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        add_header X-Cache $upstream_cache_status;

proxy_connect_timeout 30s;
        proxy_read_timeout 86400s;
        proxy_send_timeout 30s;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Origin "";
    }
    
    # 反向代理，将/dynamic-api/**的请求转发至后端项目，这个location是magic-api的配置页面中请求接口的地址
    location ^~ /dynamic-api/ {
        proxy_pass http://127.0.0.1:8080/dynamic-api/; # 后端默认端口是8080，如果自己修改了端口，这里也要改，端口号后面的/不要丢
        proxy_set_header Host $Host:$server_port;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        add_header X-Cache $upstream_cache_status;

proxy_connect_timeout 30s;
        proxy_read_timeout 86400s;
        proxy_send_timeout 30s;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
  }
  location = /index.html {
    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
    add_header Pragma "no-cache" always;
    add_header Expires "0" always;
  }
  location = /version.json {
    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
    add_header Pragma "no-cache" always;
    add_header Expires "0" always;
  }
  location = /_app.config.js {
    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
    add_header Pragma "no-cache" always;
    add_header Expires "0" always;
  }
  location /assets/ {
    expires 1y;
    add_header Cache-Control "public, immutable" always;
  }
}
```

运行nginx，前端即部署完成。

后端项目只需要将jar传至服务器，然后运行jar即可。运行jar的命令请自行百度。

### 宝塔部署

服务器上需要事先安装宝塔，具体安装方式：[点此查看](https://www.bt.cn/new/download.html)

注意：此部署方式需要学习宝塔的使用，具体的基本配置请直接查看官网，这里不再赘述。

本文档使用的宝塔版本是：免费版 9.6.0。

#### 先点这里

![](/media/202506/5e58eb50b2e942e4a86f72265ae17ef89022.png)

#### 上传JDK

![](/media/202506/421d07f54f574eb19e785c4984c5de743047.png)

![](/media/202506/82155eb8ec43424d96646d3480c0478c5456.png)
#### 创建Java项目

![](/media/202506/6833447598224119b70d2cd8b8f9cb508774.png)

![](/media/202506/ad3a78c007b346d582213e8da67e0b8e5992.png)

#### 创建HTML项目

![](/media/202506/42e92021e24545bf928f9bc94ad6eaa24766.png)

![](/media/202506/8ad097823b5242918d600f9145cabefc8488.png)

![](/media/202506/1e8038f54fd249cfb6f6ccfb26f0c3d97382.png)

![](/media/202603/347ee16b1b934558a5169255a21709d82795_20260327012337146772.png#size=100%&align=left)

### 微服务应用
这里不再赘述，部署和单体应用差别不大，就是多了nacos等中间件。选择微服务应用的人肯定是可以应付得来的。