在腾讯云服务器上搭建微信小程序后端指南
1. 准备工作
- 注册腾讯云账号并完成实名认证
- 购买合适的云服务器(CVM),建议配置:
- 最低配置:1核2GB内存
- 推荐配置:2核4GB内存及以上
- 准备已备案的域名(微信小程序要求)
2. 服务器环境配置
2.1 基础环境
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装常用工具
sudo apt install -y git curl wget vim
2.2 安装Node.js环境(以Node.js为例)
# 使用nvm安装Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install --lts
2.3 安装数据库(以MySQL为例)
# 安装MySQL
sudo apt install -y mysql-server
# 安全配置
sudo mysql_secure_installation
# 创建数据库和用户
mysql -u root -p
CREATE DATABASE weapp_db;
CREATE USER 'weapp_user'@'%' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON weapp_db.* TO 'weapp_user'@'%';
FLUSH PRIVILEGES;
exit
3. 部署后端服务
3.1 选择后端框架
常见选择:
- Express/Koa (Node.js)
- Django/Flask (Python)
- Spring Boot (Java)
以Express为例:
# 创建项目目录
mkdir weapp-backend && cd weapp-backend
# 初始化项目
npm init -y
npm install express body-parser mysql2 jsonwebtoken axios
# 创建基这里件结构
touch app.js
mkdir controllers models routes utils
3.2 配置微信小程序相关接口
在routes目录下创建weapp.js:
const express = require('express');
const router = express.Router();
const { getWXACode, decryptData } = require('../utils/wechat');
// 登录接口
router.post('/login', async (req, res) => {
const { code } = req.body;
// 调用微信接口获取openid和session_key
// 返回自定义登录态
});
// 获取用户信息
router.post('/userinfo', async (req, res) => {
const { encryptedData, iv } = req.body;
// 解密用户信息
// 存储或更新用户信息
});
module.exports = router;
3.3 配置HTTPS
微信小程序要求后端接口必须使用HTTPS:
# 使用Certbot获取Let's Encrypt免费证书
sudo apt install -y certbot
sudo certbot certonly --standalone -d yourdomain.com
# 配置Nginx
sudo apt install -y nginx
sudo vim /etc/nginx/sites-available/weapp-backend
Nginx配置示例:
server {
listen 443 ssl;
server_name yourdomain.com;
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
location / {
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
4. 微信小程序配置
- 登录微信公众平台
- 在"开发"->"开发设置"中添加服务器域名:
- request合法域名:https://yourdomain.com
- uploadFile合法域名:https://yourdomain.com
- downloadFile合法域名:https://yourdomain.com
- 在"开发"->"开发者工具"中添加IP白名单(你的服务器IP)
5. 安全配置
- 配置服务器安全组,只开放必要端口(80,443,22)
- 定期更新系统和软件
- 使用PM2管理Node.js进程
- 配置日志和监控
6. 部署上线
# 使用PM2启动服务
npm install -g pm2
pm2 start app.js --name weapp-backend
# 设置开机启动
pm2 startup
pm2 save
常见问题解决
- HTTPS证书问题:确保证书有效并定期续期
- 跨域问题:确保Nginx配置正确,或在后端设置CORS
- 微信登录失败:检查AppID和AppSecret是否正确,检查服务器时间是否准确
通过以上步骤,你就可以在腾讯云服务器上成功搭建微信小程序的后端服务了。
云服务器