阅读 1321

服务器发布Vue/Nuxt项目指南(多图)

很多前端朋友可能不是那么了解服务器配置。今天突然翻到之前写的这篇文章,修改完善了之后分享给大家一些常见的的Web服务器部署项目的方式。

写在前面

下面讲的每一种服务器深入进去都很复杂,在这篇文章只是讨论一下基本的部署和使用。更高级的知识和用法还需要各位朋友自行去探索和发现, 开始阅读之前希望大家能先了解一些Linux基础,就不至于看起来吃力了。

: 下面所有的例子大多基于vue-routerhistory模式下打包生成的静态文件,其他框架也都大同小异

Nginx服务器

Nginx 是一个高性能的HTTP和反向代理web服务器,在连接高并发的情况下,Nginx表现相当出色。

Nginx安装

这里就不讲这个了吧, 有需要的朋友可以看这个

配置修改

为了支持history模式, 我们要修改nginx/conf/nginx.conf文件

location / {
    root   html;
    try_files $uri $uri/ /index.html; # 只需要加上这么一行
    index  index.html index.htm;
}
复制代码

然后把静态资源放在html文件夹内

然后启动Nginx服务器

cd usr/local/nginx/sbin
./nginx
复制代码

接着访问你的服务器就行OK了。

GZip支持

nginx实现资源压缩的原理是通过ngx_http_gzip_module模块拦截请求,并对需要做gzip的类型做gzip压缩,该模块是默认基础的,不需要重新编译,直接开启即可。大体配置如下

#开启和关闭gzip模式
gzip on|off;

#gizp压缩起点,文件大于1k才进行压缩
gzip_min_length 1k;

# gzip 压缩级别,1-9,数字越大压缩的越好,也越占用CPU时间
gzip_comp_level 1;

# 进行压缩的文件类型。
gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript ;

#nginx对于静态文件的处理模块,开启后会寻找以.gz结尾的文件,直接返回,不会占用cpu进行压缩,如果找不到则不进行压缩
gzip_static on|off

# 是否在http header中添加Vary: Accept-Encoding,建议开启
gzip_vary on;

# 设置压缩所需要的缓冲区大小,以4k为单位,如果文件为7k则申请2*4k的缓冲区 
gzip_buffers 2 4k;

# 设置gzip压缩针对的HTTP协议版本
gzip_http_version 1.1;
复制代码

Nginx配置虽然简单,但是它本身是非常强大的,代理,负载等等都是非常具有实用性的。

Apache服务器

Apache是世界使用排名第一的Web服务器软件, 使用非常广泛。由于VueRouter的hash模式本质上和静态资源没什么区别,在Apache上发布又比较简单,这里就跳过了发布直接进入配置支持History模式

基础配置

  1. 修改Apache默认配置

首先要重新修改\conf\httpd.conf文件让文件支持rewrite

找到

// 这一行需要解开注释 引入这个模块
LoadModule rewrite_module modules/mod_rewrite.so 
复制代码

然后新增或者修改下面得代码

# 重写文件根目录
DocumentRoot "/usr/local/apache/demo"
# 目录
<Directory "/usr/local/apache/demo">
    #
    # Possible values for the Options directive are "None", "All",
    # or any combination of:
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
    #
    # Note that "MultiViews" must be named *explicitly* --- "Options All"
    # doesn't give it to you.
    Options Indexes FollowSymLinks

    #
    # 修改未允许重写
    AllowOverride all

    #
    # Controls who can get stuff from this server.
    #
    Require all granted
</Directory>
复制代码
  1. 新增htacces规则

上面操作时修改服务器得默认配置让服务器支持Rewrite,下面来创建Rewrite规则

首先在和index.html同级得地方新建.htacces文件,具体内容可以参照Vue-Router官网给得例子

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.html$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.html [L]
</IfModule>
复制代码

Apache开启Gzip压缩

/usr/local/apache/bin/apxs -i -c -n -a mod_deflate.so
复制代码

Tomcat服务器部署

现在这种前后端分离的大环境下,一般不会有太多人用Tomcatweb服务器。有的企业可能会配合着SpringMVC来一起使用,这里也来写一下。配置起来也很简单。

配置server.xml

首先找到Tomcat服务器目录中tomcat/conf/server.xml文件,找到Host,修改成你想要的配置。主要是appBase,它决定了静态文件查询的基础目录。

<Host name="localhost"  appBase="webapps"
      unpackWARs="true" autoDeploy="true">
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
          prefix="localhost_access_log." suffix=".txt"
          pattern="%h %l %u %t &quot;%r&quot; %s %b" />

</Host>
复制代码

配置支持History模式

只需要在发布的文件夹中新增WEB-INF配置文件夹中就行。如下图

WEB-INF 文件夹放在项目中那么tomcat会自动扫描文件夹中的web.xml然后添加配置。

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
                      http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  version="3.0"
  metadata-complete="true">
  
  <!-- <display-name>webapp</display-name> -->
  <description>
    webapp
  </description>
  <error-page>  
    <!-- 重写404页面 -->
    <error-code>404</error-code>  
    <location>/index.html</location>
  </error-page>  
</web-app>
复制代码

这就配置完了,可以说是贼简单了。至于怎么安装Tomcat服务器,大家自行解决吧😁

Nuxt项目(服务端渲染)

发布SSR项目的时候官方推荐了两种方式服务端渲染应用部署静态应用部署。静态应用部署的话基本上就失去了SSR的优势,而且部署方式也和上面讲的大同小异。这里只讲服务端渲染应用部署。

服务端渲染应用部署的话不同于静态部署,我们同时要在服务器上部署上Node环境。

Node环境部署

  1. cd到/usr/local文件夹并在这个文件夹下新建一个存放安装环境的文件夹node后进入node文件夹(名字可以随便起,这里做demo就用node了)
cd /usr/local
mkdir -p node
复制代码
  1. 下载Node我这里采用的是最新的长期服务版本,你想安装其他的版本,可以在这里查找,还可以使用nvm来管理你的Node,简单教程
wget https://nodejs.org/dist/v10.13.0/node-v10.13.0-linux-x64.tar.gz
复制代码
  1. 下载完成之后解压并且为文件夹改名
# 解压到当前文件夹
tar -zxvf node-v10.13.0-linux-x64.tar.gz -C ./
# 改名
mv node-v10.13.0-linux-x64/ ./node10.13.0
复制代码
  1. 建立软连接,为node,npm注册环境变量(其他的npm全局包也要这样注册)
# 软链接指向到node npm
ln -s /usr/local/node/node10.13.0/bin/node  /usr/local/bin/node
ln -s /usr/local/node/node10.13.0/bin/npm  /usr/local/bin/npm 
复制代码
  1. 查看软链接建立是否成功
ls -al /usr/local/bin
复制代码

显示如下就表示成功了

接着使用node -v

node -v
# 出现版本号就是安装成功了
v10.13.0
复制代码

到这里为止我们的Node环境就安装成功了,接下来进行nuxt部署

Nuxt部署

  1. 全局安装nuxt,然后按照上面的方式建立软连接
# 安装
npm i nuxt -g
# 建立软连接
ln -s /usr/local/node/node10.13.0/bin/nuxt  /usr/local/bin/nuxt 
复制代码
  1. 代码部署

回到/local文件夹下,我们建立一个nuxt文件用来存放我的nuxt项目。然后进入nuxt文件夹

# 回到local
cd ../
mkdir nuxt
cd nuxt
复制代码

在本地环境中执行nuxt build,然后会生成一个.nuxt文件夹。

然后修改package.json,为它加上新的内容,nuxt应用会根据下面的配置自动配置服务的端口号和地址。

"config": {
  "nuxt": {
    "host": "0.0.0.0", # 通过IPV4访问
    "port": xxxx
  }
},
复制代码

然后将项目中的.nuxt文件夹 static文件夹 package.json nuxt.config.js上传到服务器的nuxt文件夹中,

然后在nuxt文件夹中执行

# 为了方便我这这里服务器上执行了install,正式项目不建议这么干
npm i
复制代码

下载完成之后执行nuxt start出现下面的日志就表示成功启动了我们的nuxt应用

pm2使用

既然使用了Node服务,那我们最好是使用pm2做进程守护,至于pm2是什么,以及pm2是干什么的,这篇文章我们不过多的赘述,有兴趣可以自己看看。

首先安装pm2

npm i pm2 -g
# 建立软连接
ln -s /usr/local/node/node10.13.0/bin/pm2  /usr/local/bin/pm2 
复制代码

然后在package.json中加入pm启动指令或者直接像下面这样启动

# package.json
"scripts": {
    "pm2:nuxt": "pm2 start npm --name 'XXX' -- run nuxt:start", # 启动名字为xxx的进程
    "nuxt:start": "PORT=xxxx nuxt start",
    "start": "nuxt start",
    "generate": "nuxt generate",
    "pm2:stop:all": "pm2 stop all" # 停止所有进程
  }
# 直接启动命令
pm2 start npm --name 'XXX' -- run nuxt:start
复制代码

出现这样的日志就表示成功

下面是一些常用的pm2命令

pm2 start 0        # 启动 id为 0的指定应用程序
pm2 restart 0      # 重启 id为 0的指定应用程序
pm2 stop 0         # 停止 id为 0的指定应用程序
pm2 delete 0       # 删除 id为 0的指定应用程序

pm2 list           # 查看当前正在运行的进程
pm2 start all      # 启动所有应用
pm2 restart all    # 重启所有应用
pm2 stop all       # 停止所有的应用程序
pm2 delete all     # 关闭并删除所有应用
pm2 logs           # 控制台显示所有日志
 
pm2 logs 0         # 控制台显示编号为0的日志
pm2 show 0         # 查看执行编号为0的进程
pm2 monit xxx      # 监控名称为xxxx的进程
复制代码

至此,一个Nuxt应用就算是部署完成了。

出现过的问题

  1. 通过koa server.js启动的的时候外网无法访问。用的是阿里云的服务器,安全组规则都添加了。

    这个问题的具体出现原因我暂时还没找到,只是后来换了nuxt start启动之后外网才可以顺利访问。希望有了解的大佬能解答一下。

  2. 权限不足使用sudo su找不到node npm等命令

    这个很简单, 我们再重新建立一边软链接就行了

sudo ln -s /usr/local/bin/node /usr/bin/node
sudo ln -s /usr/local/lib/node /usr/lib/node
sudo ln -s /usr/local/bin/npm /usr/bin/npm
复制代码

总结

项目做完了,总要整整齐齐的发布了才有成就感对吧😁, 文中的服务器种类有点多,不过多学点也不吃亏😭 ,学会了配置服务器,再配合上Node的自动化脚本发布, 发布体验简直丝滑。

原文地址 如果觉得有用得话给个⭐吧

关注下面的标签,发现更多相似文章
评论