在腾讯云轻量应用服务器上部署微信小程序的后端服务,是一个常见且高效的方案。以下是详细的步骤指南,帮助你从零开始完成部署:
一、准备工作
-
购买并配置轻量应用服务器
- 登录 腾讯云控制台
- 进入「轻量应用服务器」产品页
- 创建实例(推荐选择 Ubuntu 20.04 或 CentOS 7+)
- 开放以下端口(在防火墙/安全组中设置):
80(HTTP)443(HTTPS)22(SSH)- 如使用自定义端口(如 3000),也需开放
-
获取服务器信息
- 记下公网 IP 地址
- 使用 SSH 登录服务器(如:
ssh root@你的公网IP)
二、部署后端服务(以 Node.js + Express 为例)
1. 安装基础环境
# 更新系统包
sudo apt update && sudo apt upgrade -y
# 安装 Node.js(推荐使用 nvm 管理版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 16 # 或最新 LTS 版本
node -v # 验证安装
2. 上传或克隆你的后端代码
# 方法一:使用 Git 克隆(推荐)
git clone https://github.com/yourname/your-backend-repo.git /opt/wx-server
# 方法二:本地打包上传(使用 scp)
# scp -r ./backend root@your-ip:/opt/wx-server
3. 安装依赖并启动服务
cd /opt/wx-server
npm install
npm run build # 如果是 TypeScript 或需要编译
# 启动服务(建议使用 PM2 管理进程)
npm install -g pm2
pm2 start app.js --name "wx-api" # 替换为你的入口文件
pm2 startup # 设置开机自启
pm2 save
注意:确保后端监听
0.0.0.0而非localhost,例如:app.listen(3000, '0.0.0.0', () => { console.log('Server running on port 3000'); });
三、配置 Nginx 反向X_X(推荐)
- 安装 Nginx
sudo apt install nginx -y
sudo systemctl enable nginx
sudo systemctl start nginx
- 配置反向X_X
编辑配置文件:
sudo nano /etc/nginx/sites-available/wx-api
内容示例:
server {
listen 80;
server_name your-domain.com; # 或直接用公网IP
location / {
proxy_pass http://127.0.0.1:3000; # 转发到本地 Node 服务
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;
}
}
启用站点:
sudo ln -s /etc/nginx/sites-available/wx-api /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
四、申请 SSL 证书(启用 HTTPS)
微信小程序要求所有请求必须使用 HTTPS。
- 使用 Let’s Encrypt 免费证书
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com
- 自动续期
Certbot 会自动添加 cron 任务续期。
五、小程序端配置
在微信小程序代码中,修改请求域名:
// 示例
wx.request({
url: 'https://your-domain.com/api/login',
// ...
})
注意:
- 在 微信公众平台 的「开发管理」→「开发设置」中,将
your-domain.com添加到 request 合法域名。 - 不能使用 IP 地址调用 HTTPS 接口。
六、其他注意事项
| 项目 | 建议 |
|---|---|
| 数据库 | 可使用腾讯云 MongoDB / MySQL,或本地 SQLite(小项目) |
| 文件存储 | 推荐搭配 COS 对象存储上传图片等资源 |
| 日志监控 | 使用 pm2 logs 或集成日志服务 |
| 备份 | 定期备份服务器和数据库 |
七、常见问题排查
- 无法访问接口? 检查安全组、Nginx 配置、Node 是否运行。
- HTTPS 报错? 确保证书正确安装,域名解析正常。
- 跨域问题? 在后端添加 CORS 中间件或由 Nginx 处理。
✅ 完成以上步骤后,你的微信小程序就可以通过 HTTPS 正常调用部署在腾讯云轻量服务器上的后端服务了!
如有具体技术栈(如 Python/Django、Java/Spring Boot),可提供更详细配置方案。
CDNK博客