使用腾讯云服务器搭建 Node.js 后端以支持微信小程序,是一个常见且实用的开发流程。以下是详细的步骤和流程说明:
一、前期准备
-
注册腾讯云账号
- 访问 腾讯云官网
- 注册并完成实名认证。
-
购买云服务器(CVM)
- 进入「云服务器 CVM」控制台。
- 选择配置:
- 地域:建议选离用户近的(如广州、上海)
- 操作系统:推荐
Ubuntu Server 20.04/22.04或CentOS 7+ - 带宽:起步可选 1Mbps 公网带宽
- 安全组:确保开放必要的端口(如 22、80、443)
-
获取服务器信息
- 记下公网 IP、登录用户名(如 ubuntu / root)、密码或密钥。
二、连接服务器并初始化环境
-
使用 SSH 连接服务器
ssh ubuntu@你的公网IP # 或使用密钥登录 ssh -i your-key.pem ubuntu@你的公网IP -
更新系统包
sudo apt update && sudo apt upgrade -y # 如果是 CentOS,则用 yum 或 dnf -
安装 Node.js 和 npm
- 推荐使用 nvm 安装指定版本:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 16 # 推荐 LTS 版本,如 16.x 或 18.x node -v # 验证安装 npm -v
- 推荐使用 nvm 安装指定版本:
-
安装 PM2(进程管理工具)
npm install -g pm2
三、部署 Node.js 后端项目
-
上传项目代码到服务器
- 方法一:使用 Git 克隆
git clone https://github.com/yourname/your-nodejs-backend.git cd your-nodejs-backend - 方法二:本地打包后通过 SCP 上传
scp -r ./backend.zip ubuntu@your-ip:/home/ubuntu/ unzip backend.zip
- 方法一:使用 Git 克隆
-
安装依赖
npm install -
配置环境变量(可选)
- 创建
.env文件,存放数据库连接、AppID、密钥等敏感信息。 - 示例内容:
PORT=3000 WX_APPID=your-wechat-appid WX_SECRET=your-wechat-secret DB_HOST=localhost DB_USER=root DB_PASS=123456
- 创建
-
启动服务测试
node app.js # 或 npm start- 确保服务监听在
0.0.0.0:3000而非localhost,否则外部无法访问。
- 确保服务监听在
四、配置反向X_X与域名(推荐)
-
安装 Nginx
sudo apt install nginx -y sudo systemctl start nginx sudo systemctl enable nginx -
配置 Nginx 反向X_X
- 编辑配置文件:
sudo nano /etc/nginx/sites-available/default -
修改 location 块:
server { listen 80; server_name your-domain.com; # 替换为你的域名 location / { proxy_pass http://127.0.0.1:3000; 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; } } - 测试并重载 Nginx:
sudo nginx -t sudo systemctl reload nginx
- 编辑配置文件:
-
绑定域名与备案(重要!)
- 在腾讯云「域名注册」购买域名。
- 使用「DNS 解析」将域名指向服务器公网 IP。
- 中国大陆服务器必须进行 ICP 备案,否则 HTTP 80/443 端口会被拦截。
五、申请 HTTPS 证书(提升安全性)
-
使用 Let's Encrypt 免费证书
- 安装 Certbot:
sudo apt install certbot python3-certbot-nginx -y - 申请证书:
sudo certbot --nginx -d your-domain.com - 自动配置 HTTPS 并启用自动续期。
- 安装 Certbot:
-
修改小程序请求地址为 HTTPS
- 微信小程序要求所有网络请求必须使用 HTTPS 协议。
- 小程序中调用接口应为:
https://your-domain.com/api/login
六、使用 PM2 管理 Node.js 应用
-
使用 PM2 启动应用
pm2 start app.js --name "wx-backend" pm2 save pm2 startup # 设置开机自启 -
查看日志与状态
pm2 logs pm2 status
七、微信小程序端对接
-
在小程序中发起请求
wx.request({ url: 'https://your-domain.com/api/login', method: 'POST', data: { code: res.code }, success(res) { console.log(res.data); } }); -
配置 request 合法域名
- 登录 微信公众平台
- 进入「开发管理」→「开发设置」
- 在「服务器域名」中添加:
- request 合法域名:
https://your-domain.com
- request 合法域名:
八、安全与维护建议
-
防火墙设置
- 开放必要端口:22(SSH)、80(HTTP)、443(HTTPS)
- 关闭其他端口,使用腾讯云安全组策略限制 IP。
-
定期备份
- 备份数据库、代码、SSL 证书。
-
监控与日志
- 使用
pm2 monit查看资源占用。 - 结合腾讯云监控服务。
- 使用
总结流程图
注册腾讯云 → 购买CVM → SSH连接 → 安装Node.js/PM2/Nginx
↓
上传代码 → 安装依赖 → 配置环境 → 启动服务
↓
绑定域名 → ICP备案 → 配置Nginx反向X_X → 申请HTTPS证书
↓
小程序配置合法域名 → 发起HTTPS请求 → 完成对接
✅ 注意事项:
- 必须使用 HTTPS 才能被微信小程序访问。
- 域名需备案(国内服务器)。
- 不要将 AppSecret 等敏感信息硬编码在代码中。
按照以上流程,你就可以成功搭建一个稳定、安全的 Node.js 后端来支持微信小程序了。
CLOUD云计算