使用腾讯云服务器搭建 Node.js 后端支持微信小程序的完整流程如下。该流程涵盖了从购买服务器、环境配置、部署应用到与微信小程序对接的全过程。
一、前期准备
-
注册腾讯云账号
- 访问 腾讯云官网 并注册账号。
- 完成实名认证。
-
开通所需服务
- CVM(云服务器)
- 域名(可选,但推荐用于 HTTPS)
- SSL证书(若使用 HTTPS)
- 安全组配置
- CDN(可选)
二、购买和配置云服务器(CVM)
-
创建云服务器实例
- 登录腾讯云控制台 → 进入「云服务器 CVM」→ 创建实例。
- 推荐配置:
- 地域:靠近目标用户(如广州、上海)
- 操作系统:Ubuntu Server 20.04 / 22.04 LTS(推荐)
- 实例规格:1核2G 或以上(开发初期可用轻量级)
- 网络带宽:1Mbps 起(根据需求调整)
- 设置登录方式:密钥对或密码(建议使用密钥更安全)
-
配置安全组
- 放行以下端口:
22:SSH 登录80:HTTP 流量443:HTTPS 流量3000或自定义端口(Node.js 服务端口)
- 入站规则示例:
协议类型 端口范围 来源 SSH 22 0.0.0.0/0 HTTP 80 0.0.0.0/0 HTTPS 443 0.0.0.0/0 自定义TCP 3000 0.0.0.0/0(上线后可限制为仅限微信服务器IP)
- 放行以下端口:
-
获取公网 IP
- 创建成功后记录公网 IP 地址(如:
123.45.67.89)
- 创建成功后记录公网 IP 地址(如:
三、远程连接服务器并配置环境
-
使用 SSH 登录服务器
ssh root@123.45.67.89 # 或使用密钥 ssh -i your-key.pem root@123.45.67.89 -
更新系统软件包
sudo apt update && sudo apt upgrade -y -
安装 Node.js 和 npm
- 推荐使用 nvm 安装指定版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 18 # 推荐长期支持版本 node -v # 验证安装 npm -v
- 推荐使用 nvm 安装指定版本
-
安装 PM2(进程管理器)
npm install -g pm2 -
安装 Nginx(反向X_X & HTTPS)
sudo apt install nginx -y sudo systemctl start nginx sudo systemctl enable nginx
四、部署 Node.js 后端项目
-
上传代码到服务器
- 方法一:使用 Git 克隆项目
git clone https://github.com/yourname/your-node-project.git cd your-node-project npm install - 方法二:使用 SCP 上传本地文件
scp -r ./backend root@123.45.67.89:/root/
- 方法一:使用 Git 克隆项目
-
配置环境变量(如数据库连接、密钥等)
- 创建
.env文件PORT=3000 WECHAT_APPID=your_appid WECHAT_SECRET=your_secret DATABASE_URL=mongodb://localhost:27017/myapp
- 创建
-
使用 PM2 启动 Node.js 应用
pm2 start app.js --name "wechat-backend" pm2 save pm2 startup # 设置开机自启 -
测试服务是否运行
curl http://localhost:3000/api/test
五、配置域名与 HTTPS(推荐)
-
购买并解析域名
- 在腾讯云「域名注册」购买域名(如
api.yourapp.com) - 添加 A 记录指向你的服务器公网 IP
- 在腾讯云「域名注册」购买域名(如
-
申请免费 SSL 证书(腾讯云提供)
- 进入「SSL 证书管理」→ 申请免费证书(TrustAsia)
- 验证域名所有权(DNS 验证)
- 下载证书(Nginx 版本)
-
配置 Nginx 反向X_X + HTTPS
- 编辑配置文件:
sudo nano /etc/nginx/sites-available/default -
配置示例:
server { listen 80; server_name api.yourapp.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name api.yourapp.com; ssl_certificate /path/to/your/cert.crt; ssl_certificate_key /path/to/your/private.key; location / { proxy_pass http://localhost: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 restart nginx
- 编辑配置文件:
六、微信小程序端对接
-
在小程序中调用后端接口
- 使用
request请求你的 HTTPS 接口wx.request({ url: 'https://api.yourapp.com/api/login', method: 'POST', data: { code: '...' }, success(res) { console.log(res.data) } })
- 使用
-
确保合法域名已配置
- 登录 微信公众平台
- 进入「开发」→「开发管理」→「服务器域名」
- 将
https://api.yourapp.com添加到 request 合法域名列表
-
处理微信登录流程(code2Session)
- 小程序获取
code→ 发送到你的 Node.js 后端 - 后端调用微信接口换取
openid和session_key - 示例请求:
const url = `https://api.weixin.qq.com/sns/jscode2session?appid=${APPID}&secret=${SECRET}&js_code=${code}&grant_type=authorization_code`;
- 小程序获取
七、后续维护与优化
-
日志监控
pm2 logs wechat-backend -
自动重启与更新
- 使用 GitHub Actions / Jenkins 实现 CI/CD
- 或使用
pm2 reload手动更新
-
数据库部署
- 可使用腾讯云 MongoDB / MySQL / Redis
- 或本地 Docker 部署数据库
-
性能监控
- 使用腾讯云「云监控」查看 CPU、内存、流量
总结:关键步骤清单
| 步骤 | 内容 |
|---|---|
| 1 | 购买腾讯云 CVM 实例 |
| 2 | 配置安全组放行端口 |
| 3 | SSH 登录并安装 Node.js、PM2、Nginx |
| 4 | 上传并运行 Node.js 项目 |
| 5 | 绑定域名并配置 HTTPS |
| 6 | 微信小程序配置合法域名并调用接口 |
| 7 | 上线后持续监控与维护 |
✅ 完成以上流程后,你的微信小程序即可通过腾讯云服务器上的 Node.js 后端稳定运行。
如需进一步帮助(如具体代码结构、Koa/Express 框架搭建、MySQL 连接等),欢迎继续提问!
秒懂云