如何把项目部署到云服务器

# 云服务器

我们需要一台云服务器,我之前免费过一台丐版的,1 核 1G 内存,并且已经安装了宝塔面板。

这是从宝塔面板首页看到的服务器配置详情。

# MySQL

登录宝塔面板,点击「数据库」→「添加数据库」,填写数据库名,宝塔面板会自动帮我们创建一个和数据库同名的账号,注意访问权限选择「本地服务器」。

在 codingmore 栏目中点击「导入」「从本地上传」编程喵的数据库文件。上传完成后点击导入。

DB 文件放在 coding-more/doc 目录下。

建议先做一次备份,点击「无备份」「备份」就可以将我们的数据库文件备份下来了,如果后面想恢复的话,直接点击「恢复」就可以了。

记住用户名,并复制密码,然后在数据库条目中点击「管理」

填写用户名和密码后,点击执行。

就可以看到编程喵的数据库文件了。

# Nginx

Nginx 是一个高性能的 HTTP 和反向代理 Web 服务器,基本上就变成了一个服务器必须安装的前置条件之一。

宝塔面板中安装 Nginx 比较简单,直接在软件商店中搜「Nginx」就可以点击安装了。

# Redis

宝塔面板中安装 Redis 也比较简单,直接在软件商店中搜「Redis」就可以点击安装了。

# 项目打包

# 1)codingmore-admin

编程喵的管理后端,注意修改生产环境下的 MySQL 用户名和密码,在 application-prod.yml 文件中。

然后把 application.yml 文件中的 active 修改为 prod 生产环境。

替换 OSS 配置。

# 2)codingmore-web

编程喵的 Web 前端(网站门户、文章展示 / 文章详情等),注意修改生产环境下的 MySQL 用户名和密码,在 application-prod.yml 文件中。

然后把 application.yml 文件中的 active 修改为 prod 生产环境。

然后就可以双击 Maven 的 package 打包了。

# 3)codingmore-admin-web

admin 管理端的前端界面。在 Visual Studio Code 中,现在终端中执行 yarn install 安装项目的依赖插件。

再执行 yarn run build 就可以构建 codingmore-admin-web 的静态页面了。

会在项目的根目录中生成一个 dist 目录,里面就是打包好的管理端静态页面。

打包的时候有两个要点要补充下,在 config 目录下有三个配置文件,dev.env.js 是开发环境下的一些配置,index.js 是主配置,prod.env.js 是生产环境下的配置。

为了提高网站的性能,我们需要关闭 source map,设置 productionSourceMap: false ,同时开启 js 和 css 的文件压缩功能。

这样打包后的文件大小就会小很多,放到服务器上也能减少网络请求的响应时间。

可以看得出,最大的一个 js 文件为 3.7M,压缩版只有 662kb,体积缩小了五倍。

# 将打包好的文件上传到服务器

在宝塔面板中点击「FTP」「添加 FTP」。

点击「根目录」

跳转到文件页。

点击上传,在 target 目录下选择上传的两个 jar 包,admin 和 web。

点击「开始上传」

还有 codingmore-admin-web 的静态文件。

# 一键部署

在软件商店里搜「Java」关键字,可以看到一个「Java 项目一键部署 3.5」的插件,安装它。

进入「Java 项目一键部署」面板。

可以在「容器管理」面板中选择 Tomcat 8 安装下,如果没有安装 JDK,在安装 Tomcat 8 的时候会默认安装一个 JDK 1.8。

进入 Spring Boot 面板,点击「添加项目」,点击「项目路径」右侧的文件夹图标,就可以上传部署我们的 Spring Boot 项目了。

# codingmore-web(网站前端)

先选择 codingmore-web。

填写域名(编程喵的域名为 codingmore.top),修改端口号为 8081,application.yml 文件中定义的。

点击确定。

可以看到服务已经在启动了,点「日志」看一下。

没问题。

也可以在这个路径下使用终端工具看日志。

在安全面板里确认一下 8081 端口是否放开。

确认放开后,打开 Chrome 浏览器的无痕模式,输入 IP + 端口号。

通过域名 + 端口号的形式也可以访问到。

# codingmore-admin(网站管理端)

再次进入 「Java 项目一键部署」Spring Boot 面板中,添加 codingmore-admin 项目。

稍等片刻,来看一下日志。

启动没问题。

codingmore-admin 只是一个后端服务,界面是用 vue 完成的,所以我们此时可以通过 Swagger 来确认一下接口是否可以正常访问。

先放行 9002 端口。

在浏览器地址栏里输入 http://www.codingmore.top:9002/doc.html ,可以看到我们用 Knife4j+Swagger 生成的 API 文档接口。

OK,这样就可以验证我们的 admin 端服务也正确运行了。

随后,为了减少服务器被攻击的可能性,我们关掉 9002 的端口。

# Nginx 配置

# codingmore-web

域名 + 端口号虽然可以访问,但不够优雅,我们想直接访问域名 codingmore.top,该怎么办呢?

可以使用 Nginx 进行端口转发。

Nginx 的实现原理是,用 Nginx 监听 80 端口,当有 HTTP 请求到来时,将 HTTP 请求的 HOST 等信息与配置文件进行匹配并转发给对应的端口。

比如说,当用户访问 codingmore.top 时,Nginx 从配置文件中得知这是一个 HTTP 请求,于是将此请求转发给 8081 端口的应用处理。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
upstream codingmore_web_pool{
server 127.0.0.1:8081;
}

server {
listen 80;
server_name codingmore.top;
access_log logs/codingmore_web.log;
error_log logs/codingmore_web.error;

#将所有请求转发给pool池的应用处理
location / {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://codingmore_web_pool;
}
}

这就是所谓的端口转发,由软件统一监听某个域名上的某个端口(一般是 80 端口),当访问服务器的域名和端口符合要求时,就按照配置转发给指定的 Tomcat 服务器处理。我们常用的 Nginx 也有端口转发功能。

OK,原理了解完后,我们把这段配置复制到宝塔面板中的 Nginx 配置中。

点击「保存」。

再在浏览器中访问 codingmore.top 就可以请求到内容了。

既然如此,我们顺带把 8081 端口给关掉,减少一个服务器被攻击的可能性。

OK,这样我们就完成了 codingmore-web 也就是编程喵🐱前端的服务部署了。

# codingmore-admin-web

codingmore-admin-web 打包后的文件是静态的,所以我们只需要在 Nginx 里添加 admin 的配置路径就 OK 了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
upstream codingmore_web_pool{
server 127.0.0.1:8081;
}

server {
listen 80;
server_name codingmore.top;
access_log /home/www/codingmore_web.log;
error_log /home/www/codingmore_web.error;

location /admin {
alias /www/wwwroot/itwanger/dist/; # 根目录
index index.html;
}

#将所有请求转发给pool池的应用处理
location / {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://codingmore_web_pool;
}
}

我们在 server 中增加了一个 admin 的 location,也就是说,当我们访问 codingmore.top/admin 的时候,就去请求 /www/wwwroot/itwanger/dist/ 目录下的静态文件。

这里讲一下 root 和 alias 的区别:

  • root:实际访问的地址前缀是 root + 请求的 path 路径,即 admin => /www/wwwroot/itwanger/dist/admin
  • alias: 实际访问的就是 /www/wwwroot/itwanger/dist

注意两者的区别。我们来访问下 codingmore.top/admin

OK。

编程喵🐱是一个前后端分离项目,前端的请求如何访问后端的 API 接口呢?简单聊一下。

打开 codingmore-admin-web/config/prod.env.js 文件,里面有一个 VUE_APP_BASE_API 属性,它的值为 /api ,也就意味着前端的请求会发送到 /api 这个前缀路径下。

1
2
3
4
5
'use strict'
module.exports = {
NODE_ENV: '"production"',
VUE_APP_BASE_API: '"/api"'
}

那我们的 codingmore-admin 后端服务是跑在 9002 端口下的,这就意味着,我们需要在 Nginx 中增加一个路径,将 api 前缀的请求转发到 9002 下。

OK,来看一下完整的配置内容。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
upstream codingmore_web_pool{
server 127.0.0.1:8081;
}

upstream codingmore_admin_pool{
server 127.0.0.1:9002/;
}

server {
listen 80;
server_name codingmore.top;
access_log /home/www/codingmore_web.log;
error_log /home/www/codingmore_web.error;

location /admin {
alias /www/wwwroot/itwanger/dist/; # 根目录
index index.html;
}

location /api/ {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://codingmore_admin_pool;
}

#将所有请求转发给pool池的应用处理
location / {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://codingmore_web_pool;
}
}