在腾讯云轻量应用服务器上配置 Node.js 服务以支持微信小程序后端,是一个常见且实用的部署方案。以下是完整、清晰、可操作的配置步骤指南,涵盖从服务器初始化到服务上线的全过程。
✅ 一、前期准备
-
注册并登录腾讯云控制台
- 访问 https://console.cloud.tencent.com/
- 完成实名认证(小程序备案必需)
-
购买轻量应用服务器
- 推荐配置:2核4G 或 4核8G(根据预期并发量选择)
- 操作系统:Ubuntu 20.04/22.04 LTS 或 CentOS 7.9+
- 地域建议:选择离用户较近的区域(如上海、广州、北京)
- 带宽:按流量计费或固定带宽 ≥5Mbps
-
绑定域名并备案
- 在腾讯云“域名管理”中注册域名
- 提交 ICP 备案申请(通常需 7–20 个工作日)
- 备案通过后,在 DNS 解析中将域名指向服务器公网 IP
-
开通小程序后台关联
- 登录 微信公众平台
- 获取 AppID 和 AppSecret
- 在“开发设置”中配置服务器域名白名单(添加你的域名)
✅ 二、连接服务器 & 基础环境搭建
1. SSH 登录服务器
ssh root@<your_server_ip>
2. 更新系统 & 安装必要工具
# Ubuntu
sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget -y
# CentOS
sudo yum update -y
sudo yum install curl git wget -y
3. 安装 Node.js(推荐使用 nvm 管理多版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts # 安装最新 LTS 版本(如 v18.x)
node -v # 验证版本
npm -v # 验证 npm 版本
💡 也可使用官方二进制包或 Docker 方式安装,但 nvm 更灵活。
4. 安装 PM2(进程管理器,确保服务常驻运行)
npm install -g pm2
pm2 --version
✅ 三、部署 Node.js 服务代码
1. 创建项目目录
mkdir -p /opt/node-app
cd /opt/node-app
2. 上传代码(多种方式任选其一)
方式 A:Git 拉取(推荐)
git clone <your_github_or_gitlab_repo_url> .
方式 B:SCP 本地上传
scp -r ./my-node-app/* root@<server_ip>:/opt/node-app/
方式 C:直接在服务器编写(简单示例)
cat > app.js << 'EOF'
const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;
app.use(express.json());
// 示例接口:小程序登录
app.post('/api/login', (req, res) => {
const { code } = req.body;
// 此处应调用微信服务端 API 换取 openid
res.json({ success: true, openid: 'mock_openid_123' });
});
// 健康检查
app.get('/health', (req, res) => {
res.send('OK');
});
app.listen(PORT, () => {
console.log(`Server running on port ${PORT}`);
});
EOF
3. 安装依赖
npm install
# 若使用 Express + 微信 SDK:
npm install express axios weixin-sdk
✅ 四、配置反向X_X与 HTTPS(关键!)
微信小程序要求所有网络请求必须通过 HTTPS,且域名需在后台备案并加入白名单。
1. 安装 Nginx
# Ubuntu
sudo apt install nginx -y
# CentOS
sudo yum install nginx -y
2. 获取 SSL 证书(免费 Let’s Encrypt)
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com
首次运行会引导输入邮箱、同意条款等。完成后自动配置 Nginx 并重启。
3. 配置 Nginx 反向X_X
编辑 /etc/nginx/sites-available/default 或新建配置文件:
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name yourdomain.com www.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://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;
}
}
测试并重载 Nginx:
sudo nginx -t
sudo systemctl reload nginx
✅ 五、启动服务并守护进程
1. 使用 PM2 启动 Node 服务
cd /opt/node-app
pm2 start app.js --name "wechat-backend"
pm2 save
pm2 startup # 设置开机自启
2. 验证服务是否正常
curl http://localhost:3000/health
# 应返回 "OK"
3. 测试 HTTPS 访问
浏览器访问 https://yourdomain.com/health,确认显示 “OK” 且无安全警告。
✅ 六、小程序端对接配置
-
在微信公众平台 → 开发管理 → 开发设置 → 服务器域名中,添加:
request合法域名: https://yourdomain.com uploadFile合法域名: https://yourdomain.com downloadFile合法域名: https://yourdomain.com -
小程序代码中调用示例:
wx.request({ url: 'https://yourdomain.com/api/login', method: 'POST', data: { code: wxCode }, success(res) { console.log(res.data.openid); } })
✅ 七、安全与优化建议
| 项目 | 建议 |
|---|---|
| 防火墙 | 仅开放 80/443 端口,关闭其他非必要端口 |
| 日志监控 | 启用 PM2 日志轮转,定期清理 |
| 数据库 | 如需持久化,安装 MySQL/MongoDB,或使用云数据库 RDS/Cosmos |
| 备份 | 定期备份代码、数据库、SSL 证书 |
| 监控 | 使用腾讯云 CLS 日志服务或 Prometheus + Grafana |
| 限流防刷 | 在 Nginx 或 Node 层加入速率限制(如 express-rate-limit) |
✅ 八、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 小程序请求失败,提示“不在以下 request 合法域名列表中” | 检查公众号后台是否已添加域名,并确保使用 HTTPS |
| Nginx 报 502 Bad Gateway | 检查 Node 服务是否运行:pm2 list;查看错误日志 pm2 logs |
| SSL 证书过期 | 执行 sudo certbot renew 手动续期,或设置定时任务 |
| 内存不足导致崩溃 | 增加 Swap 分区,或升级服务器配置,优化 Node 代码 |
📌 总结流程图
[购买服务器] → [SSH登录] → [装Node+npm+PM2+Nginx]
→ [部署代码] → [配Nginx反代+HTTPS] → [PM2守护启动]
→ [小程序配置域名白名单] → [联调测试上线]
如你希望我提供 Docker 部署方案、带数据库的完整架构、或 自动化 CI/CD 脚本,也可以告诉我,我可以进一步扩展。祝你顺利上线小程序后端!🚀
云服务器