在腾讯云服务器上部署微信小程序的后端服务,是一个常见且实用的开发流程。下面是一个详细的教程,帮助你从零开始在腾讯云服务器上部署微信小程序的后端服务。
🧩 一、准备工作
1. 注册账号
- 注册 腾讯云 账号
- 注册 微信公众平台 账号(用于小程序)
2. 购买云服务器(CVM)
- 登录腾讯云控制台 → 云服务器 CVM → 创建实例
- 推荐配置(新手):
- 地域:选择离用户近的(如广州、上海)
- 镜像:Ubuntu Server 20.04 或 CentOS 7
- 实例规格:1核2G(轻量应用够用)
- 带宽:1Mbps 起步
- 安全组:放行 HTTP(80)、HTTPS(443)、SSH(22)
✅ 建议使用「轻量应用服务器」更便宜,适合小程序后端。
🛠 二、配置云服务器环境
1. 登录服务器(使用 SSH)
ssh root@你的服务器公网IP
# 输入密码
2. 更新系统 & 安装基础软件
# Ubuntu
sudo apt update && sudo apt upgrade -y
sudo apt install nginx nodejs npm git -y
# CentOS
sudo yum update -y
sudo yum install nginx nodejs npm git -y
3. 安装 PM2(Node.js 进程管理)
npm install -g pm2
4. 安装数据库(可选:MySQL / MongoDB)
示例:安装 MySQL
sudo apt install mysql-server -y # Ubuntu
sudo mysql_secure_installation
🌐 三、部署后端服务(以 Node.js + Express 为例)
1. 上传或克隆你的后端代码
git clone https://github.com/yourname/your-weapp-backend.git
cd your-weapp-backend
npm install
2. 修改配置文件(如数据库连接、端口等)
// config/db.js
module.exports = {
host: 'localhost',
user: 'root',
password: '你的密码',
database: 'weapp'
};
3. 启动服务(使用 PM2)
pm2 start app.js --name weapp-api
pm2 save
pm2 startup # 设置开机自启
默认监听 3000 端口(或其他你设置的端口)
🔄 四、配置 Nginx 反向X_X
1. 创建 Nginx 配置文件
sudo nano /etc/nginx/sites-available/weapp
内容示例:
server {
listen 80;
server_name your-domain.com; # 或服务器IP
location / {
proxy_pass http://127.0.0.1:3000; # 转发到Node.js服务
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
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;
proxy_cache_bypass $http_upgrade;
}
}
2. 启用站点
sudo ln -s /etc/nginx/sites-available/weapp /etc/nginx/sites-enabled/
sudo nginx -t # 测试配置
sudo systemctl reload nginx
🔐 五、申请 SSL 证书(启用 HTTPS)
微信小程序要求后端接口必须使用 HTTPS。
1. 使用腾讯云免费证书
- 进入 腾讯云 SSL 证书管理
- 申请免费 DV 证书(支持单域名)
- 下载 Nginx 版证书
2. 上传证书到服务器
# 上传证书文件到 /etc/nginx/ssl/weapp/
sudo mkdir /etc/nginx/ssl/weapp
# 上传 .crt 和 .key 文件
3. 修改 Nginx 配置支持 HTTPS
server {
listen 443 ssl;
server_name your-domain.com;
ssl_certificate /etc/nginx/ssl/weapp/your_cert.crt;
ssl_certificate_key /etc/nginx/ssl/weapp/your_key.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
location / {
proxy_pass http://127.0.0.1:3000;
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;
}
}
# HTTP 跳转 HTTPS
server {
listen 80;
server_name your-domain.com;
return 301 https://$server_name$request_uri;
}
重载 Nginx:
sudo nginx -t
sudo systemctl reload nginx
📱 六、小程序前端配置
1. 在 app.js 中设置请求域名
wx.request({
url: 'https://your-domain.com/api/login',
// ...
})
2. 在微信公众平台配置服务器域名
- 登录 微信公众平台
- 进入「开发」→「开发管理」→「服务器域名」
- 添加你的 HTTPS 域名到 request 合法域名
- 如:
https://your-domain.com
- 如:
✅ 注意:不能使用 IP 地址,必须是备案域名 + HTTPS
📌 七、域名备案(我国大陆服务器必需)
- 如果服务器在我国大陆,必须对域名进行 ICP备案
- 腾讯云提供备案系统:https://beian.cloud.tencent.com/
- 备案通过后才能X_X访问
❗ 未备案域名无法访问(即使配置了 HTTPS)
✅ 八、测试与上线
- 浏览器访问
https://your-domain.com测试接口 - 小程序开发者工具中调试网络请求
- 确保无报错,提交小程序审核
🧰 常见问题
| 问题 | 解决方案 |
|---|---|
请求失败 ERR_CERT_AUTHORITY_INVALID |
检查 SSL 证书是否正确安装 |
| 域名未备案 | 无法访问,必须备案 |
| 接口返回 502 | 检查 Node.js 是否运行、端口是否正确 |
| 微信提示域名不合法 | 检查公众平台是否添加了 request 域名 |
📚 推荐资源
- 腾讯云轻量应用服务器:https://cloud.tencent.com/product/lighthouse
- 微信小程序官方文档:https://developers.weixin.qq.com/miniprogram/dev/framework/
- Express 框架:https://expressjs.com/
如果你使用的是 云开发(CloudBase),腾讯云也提供「云开发环境」,无需自己搭服务器,更适合新手。
👉 云开发教程:https://cloud.tencent.com/product/tcb
需要我根据你的具体技术栈(如 Python、Java、PHP、云开发等)提供更详细的部署方案吗?欢迎告诉我你的后端语言!
秒懂云