在宝塔面板上部署 cool-admin服务端的要点

之前没怎么接触过 nodejs服务器程序 ，现在手上有套代码 要部署到服务端。

看了一下官方教程，部署真费劲
https://www.bilibili.com/video/BV1m1421S7tm/?vd_source=4f7f6a2009a4ecbe943ac89871bf9771

所以就简单的记录一下：

## 修改本地配置文件

修改 config.prod.ts，把里面的数据库改成 服务器上的信息。

## 压缩 上传

压缩 本地代码，这个要注意，不是所有文件夹都需要上传。这个就很烦人！

![](/media/202601/2026-01-22_141222_4792710.12049198039999631.png)

如上图（官方视频截图），项目下的这7个文件夹，及根目录下的所有文件，压缩 上传到 宝塔。

logs 我觉得没必要了。。

## 全局pnpm

~~~
npm config set registry https://registry.npmmirror.com
npm install pnpm -g
~~~

## 切换到项目文件夹

打开终端

执行 
~~~
pnpm i
pnpm build

~~~

## 添加Node项目

启动文件选成这个，其他的会自动识别

![](/media/202601/2026-01-22_150631_6833700.015740777708931453.png)

## 前端nginx的配置

==这个项目挺奇葩的一点是：打包前端项目的时候，后端的服务不要停掉。。==

至于为什么？听话照做就行了

cool-admin的管理员全部是通过api的前缀 来访问后端的接口，所以需要进行别名映射 。

后端项目文件夹会有一个 nginx.conf 文件，把里面的参数 修改到宝塔的nginx前端网站的配置里。

完整的配置如下：
~~~
user nginx;
worker_processes 1;
error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;
events {
  worker_connections 1024;
}
http {
  include /etc/nginx/mime.types;
  default_type application/octet-stream;
  log_format main '$remote_addr - $remote_user [$time_local] "$request" '
  '$status $body_bytes_sent "$http_referer" '
  '"$http_user_agent" "$http_x_forwarded_for"';
  access_log /var/log/nginx/access.log main;
  sendfile on;
  keepalive_timeout 65;
  upstream cool {
    server midway:8001;
  }

server {
    listen 80;
    server_name localhost;
    location / {
      root /app;
      index index.html;
      try_files $uri $uri/ /index.html;
    }
    location /api/ {
      proxy_pass http://cool/;
      proxy_set_header Host $host;
      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;

#缓存相关配置
      #proxy_cache cache_one;
      #proxy_cache_key $host$request_uri$is_args$args;
      #proxy_cache_valid 200 304 301 302 1h;

#持久化连接相关配置
      proxy_connect_timeout 3000s;
      proxy_read_timeout 86400s;
      proxy_send_timeout 3000s;
      #proxy_http_version 1.1;
      #proxy_set_header Upgrade $http_upgrade;
      #proxy_set_header Connection "upgrade";

add_header X-Cache $upstream_cache_status;

#expires 12h;
    }

# socket需额外配置
    location /socket {
      proxy_pass http://cool/socket;
      proxy_connect_timeout 3600s; #配置点1
      proxy_read_timeout 3600s; #配置点2,如果没效,可以考虑这个时间配置长一点
      proxy_send_timeout 3600s; #配置点3
      proxy_set_header Host $host;
      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;
      #proxy_bind $remote_addr transparent;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      rewrite /socket/(.*) /$1 break;
      proxy_redirect off;
    }
  }
}

~~~

摘取以下 放到nginx的配置里

~~~
 upstream cool {
    server 127.0.0.1:8001;
  }
~~~
上面这个跟server标签平级。如下。

![](/media/202601/2026-01-22_153519_9938170.4734099289024676.png)

然后下面3个location：

~~~

location / {
      root /app;
      index index.html;
      try_files $uri $uri/ /index.html;
    }
    location /api/ {
      proxy_pass http://cool/;
      proxy_set_header Host $host;
      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;

#缓存相关配置
      #proxy_cache cache_one;
      #proxy_cache_key $host$request_uri$is_args$args;
      #proxy_cache_valid 200 304 301 302 1h;

#持久化连接相关配置
      proxy_connect_timeout 3000s;
      proxy_read_timeout 86400s;
      proxy_send_timeout 3000s;
      #proxy_http_version 1.1;
      #proxy_set_header Upgrade $http_upgrade;
      #proxy_set_header Connection "upgrade";

add_header X-Cache $upstream_cache_status;

#expires 12h;
    }

# socket需额外配置
    location /socket {
      proxy_pass http://cool/socket;
      proxy_connect_timeout 3600s; #配置点1
      proxy_read_timeout 3600s; #配置点2,如果没效,可以考虑这个时间配置长一点
      proxy_send_timeout 3600s; #配置点3
      proxy_set_header Host $host;
      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;
      #proxy_bind $remote_addr transparent;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      rewrite /socket/(.*) /$1 break;
      proxy_redirect off;
    }

~~~

插入这个位置：

![](/media/202601/2026-01-22_153726_5038850.03330785184431784.png)

注意一下！！！
~~~
location / {
      root /app;
      index index.html;
      try_files $uri $uri/ /index.html;
    }
	
~~~
==这个里面的 `root /app;` 参数请根据实际情况进行修改！！！==