使用Tomcat和Nginx部署前端项目

前言

最近做了一个前后端分离的项目,项目完成后使用Tomcat和Nginx来部署前端项目。下面会对部署步骤和需要注意的一些坑进行讲解。如果你在部署前端项目上存在疑惑,希望这篇文章能够给你提供帮助。

部署方式一:Tomcat做Web服务器

第一种方式,将我们的前端项目放置在webapps目录下

image.png

放置好后回到tomcat的bin目录下,执行./startup.sh,并在网页上查看,会发现这个时候相关的页面并没有展示出来,这是因为tomcat对静态资源的读取是默认从根目录开始的。正确的路径应该是ip地址:8080/music_client/static/...
'
image.png

解决这个问题有两种方式:

1. 使用虚拟路径

进入tomcat安装路径下的conf目录,在server.xml文件中<Host>标签内配置虚拟路径

<Context path="/static" docBase="music_client/static" reloadable="true"></Context>

简单的解释一下参数
path对应用户请求过来的url路径, /static匹配所有以/static开头的请求
docBase表示实际匹配到的路径,这里可以使用绝对路径,也可以使用相对路径
reloadable 如果为true,则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化。(对于静态资源来说,个人觉得这个配置用处不大)
总结起来就是,对于ip:8080/static的资源请求,会通过虚拟路径匹配到我们实际的资源路径music_client/static。
配置好后重启,我们可以发现已经能够看到我们的前端项目了

image.png

2. 将项目直接放置在webapps/ROOT目录下

对于ROOT目录下的资源,tomcat可以直接在根目录下进行访问。通过这种方式,我们可以让项目的路径去适配tomcat访问的路径。
但是这种方式不是特别推荐,当有多个项目在同一个tomcat服务器上的时候,会不方便管理。

部署方式二:直接用Nginx做Web服务器

Nginx是当下热门的服务器,使用起来只需要进行简单的配置即可。对于Nginx的安装大家可以自行百度解决。
我们先进入到usr/local/nginx(具体以实际nginx安装目录为准)下的conf目录,vim编辑nginx.xml。主要进行下面的配置

 server {
        listen       8082;
        server_name  localhost;
        location / {
            root   /usr/local/music_site/music_client/;
            index  index.html index.htm;
            try_files $uri  /index.html;

        }
}

简单的解释一下
listen 表示nginx监听的端口号,也就是你希望暴露哪个端口给用户进行访问
server_name 表示nginx接受请求的域名,一般默认localhost就行
location 模块用于响应请求,这里的 / 表示匹配8082端口的所有请求
root 表示静态资源/项目的路径
index 表示默认的访问资源
配置完成后,进入sbin目录下,通过./nginx -t 检查配置文件的格式是否正确
如正确 ./nginx进行启动或者 ./nginx -s reload进行重启
启动完,我们就可以直接ip:8082直接访问我们的前端项目啦

image.png

部署方式三:Tomcat做Web服务器,Nginx做反向代理服务器

开启nginx的反向代理也比较简单,只需要加上proxy_pass 配置即可

server {
        listen       8082;
        server_name  localhost;

        location / {
             proxy_pass   http://localhost:8080/music_client/;
            index  index.html index.htm;
            try_files $uri  /index.html;

        }

其他可能遇到的坑!!

(一) 路由模式为history时,直接访问url路径出现404问题

出现这个问题的原因是:在history模式下,只是动态的通过js操作window.history来改变浏览器地址栏里的路径,并没有发起http请求,但是当我们直接在浏览器输入这个地址的时候,就会对服务器发起http请求,但是这个目标在服务器上又不存在,所以会返回404。
我们可以通过把所有请求都转发到首页上来解决这个问题。只需要在Nignx中的配置文件加入如下配置:

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

事实上,上面的解决方式也是Vue-Router官方推荐的解决方式(https://router.vuejs.org/zh/guide/essentials/history-mode.html#nginx)。
那上面的try_files为什么能帮助我们解决这个问题呢?我们可以看一下这个属性的作用

try_files:按选项所指定的顺序去检查用户请求的文件是否存在,如果本地存在的话则返回该请求;不存在的话将该请求转发到指定的其它路径。也就是说,比如我们当前的前端项目部署在/usr/myproj目录下,现在我们在浏览器发起ip:port/testApi请求,那么此时uri为testApi,nginx会先去$root/testApi(即/usr/local/myproj/testApi)找是否存在该静态资源,若不存在,则继续寻找$root/testApi/index(即/usr/local/myproj/testApi/index)文件是否存在,如果还是不存在,则会把请求转发到首页。

location / {
  root  /usr/local/myproj;
  index  index.html index.htm;
  try_files $uri $uri/ /index.html;
}

而我们的项目本事就是由Vue-Cli创建的单页面应用,当index页面接收到请求的时候,对应的history模式路由就可以发挥作用了,根据浏览器的路由跳转到对应的页面,这也就保证了我们的路由请求都能够转发给index页面来进行处理。

(二) Nginx缺少SSL模块,配置反向代理到 https的网站时报错

这种问题一般是出现在服务器一开始安装Nginx的时候,没有安装SSL模块。在不重装Nignx的情况下,可以安装如下方式进行操作:

步骤1:停掉本地正常运行的Nginx(如果没有运行,则可以跳过这一步)
步骤2:进入到/usr/local/nginx/nginx-版本号(具体看你nginx当时的解压路径)

执行如下命令

./configure --prefix=/usr/local/nginx --with-http_ssl_module
步骤3:继续执行make命令
make
步骤4:备份一下原有的nginx配置

这一步只是以防万一,可以省略

cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak
步骤5:把刚才编译的nginx 拷贝覆盖原来的nginx
cp ./objs/nginx /usr/local/nginx/sbin/
步骤6:执行一下nginx -V 检测是否安装成功

也可以直接执行./usr/local/nginx/sbin/nginx -t看还会不会报错就行

./usr/local/nginx/sbin/nginx -V

参考文章:

nginx报错: [emerg] https protocol requires SSL support in /usr/local/nginx/conf/nginx.conf:50

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容