提示: 一切都配置好后, 某些原因,系统重启记得在下面
在 这个应用目录下面
[root@VM-4-8-centos weapp]
cd /data/release/weapp
pm2 start app.js
cd /data/release/weapp
mongod --fork --dbpath /data/mongodb --logpath /data/logs/mongodb/weapp.log
VScode 调试 前需要 [root@VM-4-8-centos weapp]# pm2 stop app.js
1:购买腾讯云
2: 选择了裸的centos 镜像安装
3:安装xftp Xshell 连接到服务器
4:安装 NodeJS 和 NPM
centos7 不支持nodejs 18 版本,只能选16
使用下面的命令安装 NodeJS 和 NPM
curl --silent --location https://rpm.nodesource.com/setup_16.x | sudo bash -
yum install nodejs -y
node -v
[root@VM-4-8-centos ~]# node -v
v16.20.2
5:创建工作目录,使用下面的命令在服务器创建一个工作目录:
mkdir -p /data/release/weapp
cd /data/release/weapp
创建 package.json
在刚才创建的工作目录创建 package.json,添加我们服务器包的名称和版本号,可参考下面的示例。
示例代码:/data/release/weapp/package.json
{
"name": "weapp",
"version": "1.0.0"
}
完成后,使用 Ctrl + S
保存文件
添加 Server 源码
在工作目录创建 app.js,使用 Express.js 来监听 8765
端口,可参考下面的示例代码。
示例代码:/data/release/weapp/app.js
// 引用 express 来支持 HTTP Server 的实现
const express = require('express');
// 创建一个 express 实例
const app = express();
// 实现唯一的一个中间件,对于所有请求,都输出 "Response from express"
app.use((request, response, next) => {
response.write('Response from express');
response.end();
});
// 监听端口,等待连接
const port = 8765;
app.listen(port);
// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${port}`);
本实验会以 8765 端口的打开作为实验步骤完成的依据,为了后面的实验步骤顺利进行,请不要使用其它端口号
运行 HTTP 服务
安装 PM2
在开始之前,我们先来安装 [PM2]
npm install pm2 --global
PM2 安装时间可能稍长,请耐心等候 [?]
安装 Express
我们的服务器源码里使用到了 Express 模块,下面的命令使用 NPM 来安装 Express
cd /data/release/weapp
npm install express --save
启动服务
安装完成后,使用 PM2 来启动 HTTP 服务
cd /data/release/weapp
pm2 start app.js
现在,您的 HTTP 服务已经在 http://<您的 CVM IP 地址>:8765 运行
要查看服务输出的日志,可以使用下面的命令:
pm2 logs
如果要重启服务,可以使用下面的命令:
pm2 restart app
我们使用 PM2 来进行 Node 进程的运行、监控和管理
NPM 仓库在国内访问速度可能不太理想,如果实在太慢可以尝试使用 CNPM 的 Registry 进行安装:
npm install pm2 -g --registry=https://r.cnpmjs.org/
搭建 HTTPS 服务
任务时间:15min ~ 30min
微信小程序要求和服务器的通信都通过 HTTPS 进行
安装 Nginx
在 CentOS 上,可直接使用 yum
来安装 Nginx
yum install nginx -y
安装完成后,使用 nginx
命令启动 Nginx:
nginx
此时,访问 http://<您的域名> 可以看到 Nginx 的测试页面 [?]
如果无法访问,请重试用
nginx -s reload
命令重启 Nginx
配置 HTTPS 反向代理
外网用户访问服务器的 Web 服务由 Nginx 提供,Nginx 需要配置反向代理才能使得 Web 服务转发到本地的 Node 服务。
先将之前下载的 SSL 证书(解压后 Nginx 目录分别以 crt 和 key 作为后缀的文件)通过拖动到左侧文件浏览器/etc/nginx目录
的方式来上传文件到服务器上
修改nginx.conf 增加上如下代码
示例代码:/etc/nginx/nginx.conf
server {
listen 443 ssl;
server_name hook.fit; # 改为绑定证书的域名
# ssl 配置
#ssl on;
ssl_certificate hook.fit_bundle.pem; # 改为自己申请得到的 pem 文件的名称
ssl_certificate_key hook.fit.key; # 改为自己申请得到的 key 文件的名称
ssl_session_timeout 5m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;
location / {
proxy_pass http://127.0.0.1:8765;
}
}
按 Ctrl + S
保存配置文件,让 Nginx 重新加载配置使其生效:
nginx -s reload
在浏览器通过 https 的方式访问你解析的域名来测试 HTTPS 是否成功启动
在小程序中测试 HTTPS 访问
打开配套的小程序,点击 实验一:HTTPS
,点击 发送请求
来测试访问结果。
如果服务器响应成功,请点击下一步。
安装 MongoDB
使用 Yum 在机器上安装 [MongoDB] 及其客户端命令行工具:
第一步:配置 mongodb源
cd /etc/yum.repos.d
vim mongodb-org-4.0.repo
mongodb-org-4.0.repo中的内容
[mngodb-org]
name=MongoDB Repository
baseurl=http://mirrors.aliyun.com/mongodb/yum/redhat/7Server/mongodb-org/4.0/x86_64/
gpgcheck=0
enabled=1
gpgcheck=0, 是省去gpg验证
安装之前先更新
yum update
安装mongodb
yum -y install mongodb-org
安装结束后,可以使用下面的命令查看安装的版本:
mongod --version
mongo --version
启动 MongoDB
创建目录,用于 MongoDB 数据和日志存储:
mkdir -p /data/mongodb
mkdir -p /data/logs/mongodb
创建后,使用下面的命令来启动 MongoDB:[?]
mongod --fork --dbpath /data/mongodb --logpath /data/logs/mongodb/weapp.log
可以使用下面的命令来检查是否启动成功 [?]
netstat -ltp | grep 27017
MongoDB 首次启动可能会花费大概 1min 时间,请耐心等待
MongoDB 默认监听 27017 端口等待连接,下面的命令查看当前 27017 端口被哪个进程占用,如果是 MongoDB 的进程,则表示启动成功。
添加 MongoDB 用户
登录本地 MongoDB 服务:
mongo
登录后,创建一个用户 weapp
[?]:
use weapp;
db.createUser({ user: 'weapp', pwd: 'weapp-dev', roles: ['dbAdmin', 'readWrite']});
创建完成后,使用 exit
退出命令行工具。
创建的用户和密码将用于下一步中连接数据库时使用,如果使用不同的用户或密码,注意要保存好
安装 Node 模块
实现小程序的会话功能,我们需要安装 [connect-mongo] 和 [wafer-node-session]
cd /data/release/weapp
npm install connect-mongo wafer-node-session --save
[connect-mongo][https://github.com/jdesboeufs/connect-mongo] 模块通过连接到 MongoDB 为会话提供存储
[wafer-node-session][https://github.com/tencentyun/wafer-node-session] 是由腾讯云提供的独立小程序会话管理中间件
因为后面代码会用到new MongoStore 这个代码, 但是最新版本connect-mongo不支持这个方法, 需要降级到3
[root@VM-4-8-centos weapp]# npm uninstall connect-mongo
[root@VM-4-8-centos weapp]# npm i connect-mongo@3
实现小程序会话
实现小程序会话
在工作目录创建配置文件 config.js,用于保存我们服务所用的配置[?],可参考下面的实现(注:请将参考配置文件中的 YORU_APP_ID 和 YOUR_APP_SECRET 替换为你申请的小程序对应的 AppID 和 AppSecret):
示例代码:/data/release/weapp/config.js
module.exports = {
serverPort: '8765',
// 小程序 appId 和 appSecret
// 请到 https://mp.weixin.qq.com 获取 AppID 和 AppSecret
appId: 'YORU_APP_ID',
appSecret: 'YOUR_APP_SECRET',
// mongodb 连接配置,生产环境请使用更复杂的用户名密码
mongoHost: '127.0.0.1',
mongoPort: '27017',
mongoUser: 'weapp',
mongoPass: 'weapp-dev',
mongoDb: 'weapp'
};
编辑 app.js,添加会话实现逻辑,可参考下面的代码:
示例代码:/data/release/weapp/app.js
// 引用 express 来支持 HTTP Server 的实现
const express = require('express');
// 引用 wafer-session 支持小程序会话
const waferSession = require('wafer-node-session');
// 使用 MongoDB 作为会话的存储
const MongoStore = require('connect-mongo')(waferSession);
// 引入配置文件
const config = require('./config');
// 创建一个 express 实例
const app = express();
// 添加会话中间件,登录地址是 /login
app.use(waferSession({
appId: config.appId,
appSecret: config.appSecret,
loginPath: '/login',
store: new MongoStore({
url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}`
})
}));
// 在路由 /me 下,输出会话里包含的用户信息
app.use('/me', (request, response, next) => {
response.json(request.session ? request.session.userInfo : { noBody: true });
if (request.session) {
console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);
}
});
// 实现一个中间件,对于未处理的请求,都输出 "Response from express"
app.use((request, response, next) => {
response.write('Response from express');
response.end();
});
// 监听端口,等待连接
app.listen(config.serverPort);
// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);
源码编写完成后,重启服务:
pm2 restart app
重启后,使用配套的小程序完成会话测试:打开配套小程序 - 点击 实验二:会话
- 获取会话
,如果您能看到您的微信头像,那就表示会话已经成功获取了。
随着服务变得复杂,我们可以把配置集中起来方便管理,比如目前我们需要保存:服务器运行端口、小程序配置、MongoDB 连接配置
安装 Node 模块
本实验使用 ws
模块来在服务器上支持 WebSocket 协议,下面使用 NPM 来安装:
cd /data/release/weapp
npm install ws --save
实现 WebSocket 服务器
创建 websocket.js,实现 WebSocket 服务,可参考下面的代码:
示例代码:/data/release/weapp/websocket.js
// 引入 ws 支持 WebSocket 的实现
const ws = require('ws');
// 导出处理方法
exports.listen = listen;
/**
* 在 HTTP Server 上处理 WebSocket 请求
* @param {http.Server} server
* @param {wafer.SessionMiddleware} sessionMiddleware
*/
function listen(server, sessionMiddleware) {
// 使用 HTTP Server 创建 WebSocket 服务,使用 path 参数指定需要升级为 WebSocket 的路径
const wss = new ws.Server({ server, path: '/ws' });
// 监听 WebSocket 连接建立
wss.on('connection', (ws,request) => {// 要升级到 WebSocket 协议的 HTTP 连接
// 被升级到 WebSocket 的请求不会被 express 处理,
// 需要使用会话中间节获取会话
sessionMiddleware(request, null, () => {
const session = request.session;
if (!session) {
// 没有获取到会话,强制断开 WebSocket 连接
ws.send(JSON.stringify(request.sessionError) || "No session avaliable");
ws.close();
return;
}
// 保留这个日志的输出可让实验室能检查到当前步骤是否完成
console.log(`WebSocket client connected with openId=${session.userInfo.openId}`);
serveMessage(ws, session.userInfo);
});
});
// 监听 WebSocket 服务的错误
wss.on('error', (err) => {
console.log(err);
});
}
/**
* 进行简单的 WebSocket 服务,对于客户端发来的所有消息都回复回去
*/
function serveMessage(ws, userInfo) {
// 监听客户端发来的消息
ws.on('message', (message) => {
console.log(`WebSocket received: ${message}`);
ws.send(`Server: Received(${message})`);
});
// 监听关闭事件
ws.on('close', (code, message) => {
console.log(`WebSocket client closed (code: ${code}, message: ${message || 'none'})`);
});
// 连接后马上发送 hello 消息给会话对应的用户
ws.send(`Server: 恭喜,${userInfo.nickName}`);
}
编辑 app.js,调用 WebSocket 服务,可参考下面代码:
示例代码:/data/release/weapp/app.js
// HTTP 模块同时支持 Express 和 WebSocket
const http = require('http');
// 引用 express 来支持 HTTP Server 的实现
const express = require('express');
// 引用 wafer-session 支持小程序会话
const waferSession = require('wafer-node-session');
// 使用 MongoDB 作为会话的存储
const MongoStore = require('connect-mongo')(waferSession);
// 引入配置文件
const config = require('./config');
// 引入 WebSocket 服务实现
const websocket = require('./websocket');
// 创建一个 express 实例
const app = express();
// 独立出会话中间件给 express 和 ws 使用
const sessionMiddleware = waferSession({
appId: config.appId,
appSecret: config.appSecret,
loginPath: '/login',
store: new MongoStore({
url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}`
})
});
app.use(sessionMiddleware);
// 在路由 /me 下,输出会话里包含的用户信息
app.use('/me', (request, response, next) => {
response.json(request.session ? request.session.userInfo : { noBody: true });
if (request.session) {
console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);
}
});
// 实现一个中间件,对于未处理的请求,都输出 "Response from express"
app.use((request, response, next) => {
response.write('Response from express');
response.end();
});
// 创建 HTTP Server 而不是直接使用 express 监听
const server = http.createServer(app);
// 让 WebSocket 服务在创建的 HTTP 服务器上监听
websocket.listen(server, sessionMiddleware);
// 启动 HTTP 服务
server.listen(config.serverPort);
// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);
修改完成后,按 Ctrl + S
保存文件,并重启服务:
pm2 restart app
更新 Nginx 代理
编辑 Nginx 配置 ssl.conf,添加 WebSocket 支持
粘贴我的代码
user nobody;
worker_processes auto;
worker_rlimit_nofile 65535;
#error_log /var/log/nginx/error.log warn;
events {
accept_mutex off;
use epoll;
worker_connections 8192;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
gzip on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 0;
client_body_timeout 10;
client_header_timeout 10;
client_header_buffer_size 1k;
large_client_header_buffers 4 4k;
output_buffers 2 32k;
client_max_body_size 64m;
client_body_buffer_size 256k;
server_tokens off;
include http.d/*.conf;
# WebSocket 配置
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 443 ssl;
server_name hook.fit; # 改为绑定证书的域名
# ssl 配置
#ssl on;
ssl_certificate hook.fit_bundle.pem; # 改为自己申请得到的 crt 文件的名称
ssl_certificate_key hook.fit.key; # 改为自己申请得到的 key 文件的名称
ssl_session_timeout 5m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;
# WebSocket 配置
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
location / {
proxy_pass http://127.0.0.1:8765;
}
}
include include/*.conf;
}
全文终