在腾讯云服务器上部署微信小程序后端服务,是一个常见的开发与上线流程。以下是一份详细的教程,帮助你从零开始在腾讯云服务器上部署微信小程序的后端服务。
🌐 一、准备工作
1. 注册账号
- 注册 腾讯云 账号
- 注册 微信公众平台 账号(用于小程序)
2. 购买腾讯云服务器(CVM)
推荐配置:
- 操作系统:Ubuntu 20.04 / CentOS 7(建议 Ubuntu)
- 配置:1核2G起步(适合测试)
- 带宽:1Mbps 起步
- 地域:选择离用户近的区域(如广州、上海)
可使用“轻量应用服务器”简化操作(更便宜,集成更好)
💻 二、登录服务器并配置环境
1. 使用 SSH 登录服务器
ssh root@你的公网IP
# 输入密码
2. 更新系统 & 安装必要软件
# Ubuntu 示例
sudo apt update && sudo apt upgrade -y
# 安装 Node.js(以 v18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node -v
npm -v
3. 安装 PM2(进程管理工具)
npm install -g pm2
4. 安装 Nginx(反向X_X & HTTPS)
sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx
🛠️ 三、上传并运行后端代码
假设你的小程序后端是基于 Node.js 的 Express/Koa 服务。
1. 上传代码到服务器
方式有多种:
- 使用
scp命令上传:scp -r ./your-backend root@your-server-ip:/root/wechat-app - 使用 Git 克隆:
git clone https://github.com/yourname/weapp-backend.git cd weapp-backend npm install
2. 启动后端服务
# 启动服务(例如监听 3000 端口)
npm start
# 或使用 PM2 守护进程
pm2 start app.js --name "weapp-api"
pm2 startup
pm2 save
🔐 四、配置域名与 HTTPS(重要!)
微信小程序要求后端接口必须使用 HTTPS 协议。
1. 购买或申请免费域名
- 在腾讯云注册一个域名(如:
myapp.com)
2. 备案(国内服务器必须备案)
- 登录腾讯云控制台 → 域名与网站 → 备案
⚠️ 未备案的域名无法绑定国内服务器的 80/443 端口。
3. 申请免费 SSL 证书
- 腾讯云搜索“SSL证书” → 申请免费证书(TrustAsia)
- 下载 Nginx 版本证书,上传到服务器
/etc/nginx/ssl/
4. 配置 Nginx 反向X_X
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
示例配置(HTTPS + 反向X_X):
server {
listen 80;
server_name api.myapp.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl;
server_name api.myapp.com;
ssl_certificate /etc/nginx/ssl/1_api.myapp.com_bundle.crt;
ssl_certificate_key /etc/nginx/ssl/2_api.myapp.com.key;
location / {
proxy_pass http://127.0.0.1:3000; # 你的 Node.js 服务
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
重启 Nginx:
sudo nginx -t # 测试配置
sudo systemctl reload nginx
5. 域名解析
- 进入腾讯云“云解析 DNS”
- 添加 A 记录:
api.myapp.com→ 指向你的服务器公网 IP
📱 五、小程序前端配置
1. 修改小程序 request 请求域名
在微信开发者工具中:
app.js或请求代码中,使用你的 HTTPS 域名:wx.request({ url: 'https://api.myapp.com/login', // ... })
2. 配置小程序后台合法域名
进入 微信公众平台 → 开发管理 → 开发设置
- 将
https://api.myapp.com添加到 request 合法域名
注意:不能使用 IP 地址或 HTTP 协议!
✅ 六、测试与上线
- 启动后端服务(PM2 管理)
- 打开小程序开发者工具,测试网络请求是否成功
- 提交审核,发布上线
🧰 常见问题
| 问题 | 解决方案 |
|---|---|
请求失败 ERR_SSL_PROTOCOL_ERROR |
检查 Nginx SSL 配置和证书路径 |
| 域名未备案 | 必须完成 ICP 备案才能用 443 端口 |
| 接口返回 404 | 检查 Nginx proxy_pass 是否正确指向服务端口 |
| 微信提示域名不合法 | 检查公众平台配置的 request 域名 |
🎁 进阶建议
- 使用 Serverless:腾讯云云函数 SCF + API 网关,免运维
- 数据库:搭配腾讯云 MongoDB / MySQL(云数据库)
- 自动化部署:配合 GitHub Actions 或 CODING CI/CD
📚 参考链接
- 腾讯云官网:https://cloud.tencent.com/
- 微信小程序文档:https://developers.weixin.qq.com/miniprogram/dev/framework/
- 腾讯云轻量服务器部署教程:https://cloud.tencent.com/document/product/1266
如果你提供具体的后端技术栈(如 Node.js + Express、Python Flask、Java SpringBoot),我可以给出更详细的部署脚本和配置。
需要我生成一个完整的 Express 示例项目部署流程吗?
轻量云Cloud