前后端分离模板在服务器上部署（有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.
如果服务器部署有类似 Cannot find package '@popperjs/core' imported from /var/web-pc/server/chunks/app/_nuxt/index-e5ee63c8.mjs 的错误，要检查是否在用 pnpm run build 命令安装依赖打包，需要使用 npm run build 命令才能正确打包。
服务器上安装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 restart pm2-www | pm2重启 |
| systemctl stop 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-Expose-Headers" "Message" 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;
}
location ^~ /admin { #管理后台
alias /usr/share/nginx/admin/; # 管理后台文件夹
try_files $uri $uri/ /admin/index.html; #vite.config.ts里配置了应用基础请求路径base: '/admin/'
}
}
配置完成保存。 调用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文件夹，存放手机版网页；创建admin文件夹，存放管理后台网页
cd /usr/share/nginx/
mkdir mobile
mkdir admin
电脑版网页由Nginx转发到Node服务端口；手机版网页存放在mobile文件夹，管理后台网页存放在admin文件夹。下面演示手机版网页文件上传。先进入mobile文件夹
cd mobile
将打包好的bbs-web-mobile网页文件上传到刚才创建的mobile目录
这时打开浏览器访问绑定在前端的域名即可正常浏览网页