前后端分离模板在服务器上部署(有SEO)

本教程适合SSR版本的轻论坛前端(Nuxt3 + TypeScript + Vue3 + element-plus方案)。演示主机操作系统为CentOS 8.0,Nginx版本为1.16.1。运行环境请参考其它教程自行安装完成。


设置轻论坛后端

轻论坛后端安装好后,登录管理后台 --> 模板列表 --> 点击列表“使用中”列的按钮,将当前使用的模板切换到“前后端分离模板”





本机Nuxt3项目打包

修改配置文件nuxt.config.ts。(用户需将演示的域名和IP端口替换为自已的域名和IP端口)

修改runtimeConfig的属性API_URL值为http://api.diyhi.com/





然后将前端项目打包

				
					 npm run build
				
			
打包后生成的文件在.output文件夹内




创建普通用户

1、演示创建一个名称为www的用户。#号为注释,不用输入

				
					 useradd www  #创建普通账号
				
			
				
					 passwd www  #根据提示设置密码,需要输入2次
				
			

2、设置账户权限

Linux默认是没有将用户添加到sudoers列表中的,需要root手动将账户添加到sudoers列表中,才能让普通账户执行sudo命令
A.输入visudo命令。这个命令是打开 /etc/sudoer文件,这时编辑框为命令模式,这时输入字母i进入插入模式,就可以编辑文件了
				
					 visudo
				
			
B.按方向键(下)将配置文件拖到root ALL=(ALL) ALL项
C.在这个文件的末尾添加 www ALL=(ALL) ALL (中间的空格是Tab 键)


D. 然后保存(就是先按一 下Esc键,然后输入 :wq )退出

服务器上部署前端项目

1、将打包好的项目文件上传到服务器

				
					 mkdir /var/web-pc   #创建目录
				
			
				
					 cd /var/web-pc   #切换到安装目录
				
			
将打包好的前端项目文件(public,server,nitro.json)上传到/var/web-pc



将/var/web-pc目录所有文件设为www用户所有
				
					  chown -R www:www /var/web-pc
				
			
/var/web-pc目录下上传的网页项目文件权限必须为www用户所有,如果用非www更新的文件,可以尝试执行命令 chown -R www:www /var/web-pc 进行修改


注意:更新前端文件后必须重启pm2服务,否则浏览器访问会报错 Expected a JavaScript module script but the server responded with a MIME type of "text/html". Strict MIME type checking is enforced for module scripts per HTML spec.


服务器上安装Node.js

1、到官网下载页找到下载地址 https://nodejs.org/en/download/

				
					 wget https://nodejs.org/dist/v18.12.1/node-v18.12.1-linux-x64.tar.xz  #下载文件
				
			
				
					 tar -xvf node-v18.12.1-linux-x64.tar.xz  #解压文件
				
			
				
					 mkdir /opt/node  #创建文件夹
				
			
				
					 mv ./node-v18.12.1-linux-x64/* /opt/node  #复制解压的文件到安装目录
				
			

2、配置node 环境变量

				
					 vim /etc/profile
				
			
将以下参数追加到文件末尾
				
					export NODE_HOME=/opt/node
					export PATH=$PATH:$NODE_HOME/bin
					export NODE_PATH=$PATH:$NODE_HOME/lib/node_modules
				
			
保存退出后刷新环境变量,使配置生效
				
					 source /etc/profile
				
			
将/opt/node目录所有文件设为www用户所有
				
					  chown -R www:www /opt/node
				
			

3、验证node是否安装成功

				
					 node -v
					 npm -v
				
			


服务器上安装pm2(在www用户下安装)

1、需要切换到www用户进行安装

				
					 su www  #切换到www用户
				
			


2、安装pm2并配置

				
					 npm install -g pm2
				
			

3、创建配置文件

				
					 cd /var/web-pc   #切换到项目目录
				
			
				
					vim ecosystem.config.js
				
			
将以下内容写入到配置文件里
				
					module.exports = {
					    apps: [
					      {
					        name: 'bbs-web-pc-ssr',
					        exec_mode: 'cluster',
					        instances: 'max',
					        script: '/var/web-pc/server/index.mjs'
					      }
					    ]
					}
				
			



4、启动项目

				
					pm2 start /var/web-pc/ecosystem.config.js
				
			

5、保存当前进程状态

				
					 pm2 save
				
			

6、生成开机自启服务

				
					 pm2 startup
				
			

7、执行上一步结果提示中的开机自启命令

				
					 sudo env PATH=$PATH:/opt/node/bin /opt/node/lib/node_modules/pm2/bin/pm2 startup systemd -u www --hp /home/www
				
			

8、开机启动(后面的www为自己的用户名,如果是root用户安装则为pm2-root)

				
					 systemctl enable pm2-www
				
			

9、查看状态列表

				
					 pm2 ls
				
			


pm2 常用命令
systemctl enable pm2-www 配置开机启动
systemctl start pm2-www 启动pm2
systemctl status pm2-www pm2启动状态
pm2 stop bbs-web-pc-ssr 停止应用(bbs-web-pc-ssr为项目名称)
pm2 restart bbs-web-pc-ssr 重启应用(bbs-web-pc-ssr为项目名称)
pm2 show bbs-web-pc-ssr 显示服务详情(bbs-web-pc-ssr为项目名称)
pm2 logs 查看当前所有启动应用的 log
pm2 logs bbs-web-pc-ssr 查看某一应用的 log(bbs-web-pc-ssr为项目名称)
pm2 delete bbs-web-pc-ssr 删除进程/应用 (bbs-web-pc-ssr为项目名称)
pm2 delete all 删除所有进程/应用
pm2 unstartup systemd 删除初始化脚本
pm2 monit 查看进程/应用的资源消耗情况


配置Nginx

域名规划

后端域名 前端域名
http://api.diyhi.com/ http://bbs.diyhi.com/


打开Nginx的配置文件default.conf

				
					 vim /etc/nginx/conf.d/default.conf
				
			

将下面的代码复制到Nginx配置文件里,将演示的域名和IP端口替换为自已的域名和IP端口

				
					 server{
						listen  80;
						server_name api.diyhi.com;
						location /{
							#请填写具体域名  解决服务端返回401等错误时浏览器报跨域错误。nginx 转发 server 响应的过程中,add_header 只有在 200,201,204,206,301,302,303,304,307 状态码时会添加,而 401、500,都没有添加。解决:在 add_header 最后加上 always,可以让 nginx 在非默认状态码下 add_header 也可以生效。
					
							add_header "Access-Control-Allow-Origin"  "http://bbs.diyhi.com" always;
							add_header Access-Control-Allow-Credentials true always;
							add_header "Access-Control-Allow-Methods" "GET, POST, PUT, OPTIONS, HEAD" always;
							add_header "Access-Control-Allow-Headers" "Origin,X-Requested-With,Content-Type,Cache-Control,Accept,Authorization,BBS-XSRF-TOKEN,Set-Cookie" always;
							#预检命令的缓存,如果不缓存每次会发送两次请求
							add_header Access-Control-Max-Age 3600 always;
					
							if ($request_method = 'OPTIONS') {
								return 204;
							}
					
					        proxy_set_header Host $host;
					        proxy_set_header X-Real-Ip $remote_addr;
					        proxy_set_header X-Forwarded-For $remote_addr;
					        proxy_pass http://127.0.0.1:8080;
							client_max_body_size 100M; #允许上传文件大小,默认是1M
					
						}
					}
					
					#根据设备访问
					map $http_user_agent $is_desktop {
					    default 0;
					    "~*(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino" 1;
					    "~*^(1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-)" 1;
					}
					#根据cookie访问
					map $cookie_accessModule $is_accessModule {
							default $is_desktop;
					    "~*pc" 0; #cookie指定访问电脑版
					    "~*mobile" 1; #cookie指定访问手机版
					}
					
					
					server{
						listen  80;
						server_name bbs.diyhi.com;
					
					
						location /{
						
							proxy_set_header Host $host;
							proxy_set_header X-Real-Ip $remote_addr;
						 	proxy_set_header X-Forwarded-For $remote_addr;
						  
							
							if ( $is_accessModule = 0 ) { 
								 proxy_pass http://127.0.0.1:3000;
								 
							}
							root /usr/share/nginx/mobile;
							try_files $uri $uri/ /index.html;
						
						}
					}
				
			

配置完成保存。 调用nginx -t测试配置文件是否正确

使用配置好的系统服务管理Nginx
systemctl enable nginx 配置开机启动
systemctl start nginx 启动nginx
systemctl stop nginx 停止nginx
systemctl restart nginx 重启nginx
systemctl disable nginx 删除开机启动
systemctl daemon-reload 刷新

Nginx默认的网页文件路径为/usr/share/nginx/html

进入/usr/share/nginx/目录,创建mobile文件夹,存放手机版网页

				
					 cd /usr/share/nginx/
				
			
				
					 mkdir mobile
				
			



电脑版网页由Nginx转发到Node服务端口;手机版网页存放在mobile文件夹。下面演示手机版网页文件上传。先进入mobile文件夹

				
					 cd mobile
				
			

将打包好的bbs-web-mobile网页文件上传到刚才创建的mobile目录







这时打开浏览器访问绑定在前端的域名即可正常浏览网页