一、前期准备
- 购买域名 + (云)服务器
- 购买https证书
二、解决方案
在一台(云)服务器上,安装好运行环境(nodejs+mysql+pm2+nginx),然后通过pm2运行小程序后端项目,并在nginx中配置https访问。
三、(云)服务器环境部署(基于Ubuntu)
- nginx安装
- nodejs安装
请参考:手动搭建Nodejs环境 (Linux & Window)
- pm2安装
- mysql安装
- 配置HTTPS
可参考:
- Nginx 服务器SSL证书安装
- Nginx 配置http和https访问
四、部署后端项目
进行到这一步,(云)服务器的环境都已经搭好了。接下来我们就来将小程序的后端项目部署到(云)服务器上。
获取AppID(小程序ID),AppSecret(小程序密钥),设置服务器域名(PS:域名需要备案后才能填写。)
下载后端项目官方模板,模板中的server目录即是后端项目
Github仓库地址:Wafer2-startup配置server/config.js
const CONF = {
port: '5757',
rootPathname: ' /data/release/weapp' , //服务器上server文件夹地址与此处一致
// 填写微信小程序 App ID
appId: 'wx33333',
// 填写微信小程序 App Secret
appSecret: 'wx22222',
// 是否使用腾讯云代理登录小程序
useQcloudLogin: false, // 可直接使用微信登陆小程序 因为使用阿里云改为false
/**
* MySQL 配置,用来存储 session 和用户信息
* 若使用了腾讯云微信小程序解决方案
* 开发环境下,MySQL 的初始密码为您的微信小程序 appid
*/
mysql: {
host: '服务器IP',//很多文档都写的云数据库内网IP,关于这一点我写的服务器公网IP一样可以用,不太了解
port: 3306,
user: 'root',
db: 'cAuth',
pass: '服务器数据库密码',//之前操作修改过
char: 'utf8mb4'
},
cos: {//这个地区没什么影响,可以不改
/**
* 区域
* 华北:cn-north
* 华东:cn-east
* 华南:cn-south
* 西南:cn-southwest
* 新加坡:sg
* @see https://cloud.tencent.com/document/product/436/6224
*/
region: 'cn-south',
// Bucket 名称
fileBucket: 'qcloudtest',
// 文件夹
uploadFolder: ''
},
// 微信登录态有效期
wxLoginExpires: 7200,
// 其他配置 ...
serverHost: '你的域名',
//以下配置可以留空不填 但是参数一定要有 否则会报错
tunnelServerUrl: '',//腾讯云信道服务地址 很多文档里写的地址打开直接404
tunnelSignatureKey: '',
// 可以注册一个腾讯云账号,获取一下配置。腾讯云相关配置可以查看云 API 秘钥控制台:
// https://console.cloud.tencent.com/capi
qcloudAppId: '你的腾讯云 AppID',
qcloudSecretId: '你的腾讯云 SecretId',
qcloudSecretKey: '你的腾讯云 SecretKey',
wxMessageToken: 'weixinmsgtoken',
networkTimeout: 30000
}
module.exports = CONF
-
将client/config.js复制到小程序前端项目src目录下,并修改配置。
此config.js的作用:主要配置host(后端项目的域名/ip地址端口),便于请求后端接口,访问后端资源。
将后端项目上传至(云)服务器
!!!再次注意:后端项目在(云)服务器上的路径需与server/config.js中的配置项rootPathname保持一致安装项目依赖
# 进入项目根目录下
npm install
- 初始化数据库
可使用后端项目tools/initdb.js工具来初始化数据库
node tools/initdb.js
若数据库初始化成功后,可以查看数据表,如下图:
初始化数据库可能遇到的问题:
1.提示远程数据库连接失败:
Error: ER_HOST_NOT_PRIVILEGED: Host 'iZwz93gye2rcpm8b1ra8zwZ' is not allowed to connect to this MySQL server问题原因:可能是数据库的安全预防措施。
解决方法:登录数据库,尝试添加新的拥有所有操作权限的数据库管理员帐号。mysql> CREATE USER 'username'@'%' IDENTIFIED BY 'some_pass'; mysql> GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' WITH GRANT >OPTION;
成功添加新的数据库账号后,别忘了修改server/config.js里的数据库登录账号和密码。
- nginx配置后端项目
server {
listen 443;
# ...省略https配置
location / {
proxy_pass http://127.0.0.1:5757/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
- 启动后端项目(推荐:使用pm2启动并监控)
node app.js
- 检查是否可以正常访问
直接访问 https://你的域名/weapp/login,会提示:{"code":-1,"error":"ERR_HEADER_MISSED"},则表示配置成功。
PS:注意这一步访问的地址一定是域名后接/weapp/login而不是官方文档里写的http://你的域名/login,访问后面这个地址会得到:{"code":0,"data":{}}。
原因:因为weapp是后端项目中配置的路由前缀。