在腾讯云CVM(Cloud Virtual Machine)上配置支持微信小程序的 Node.js 环境,主要涉及以下几个步骤:创建 CVM 实例、安装 Node.js、部署后端服务、配置域名和 HTTPS、与微信小程序对接。以下是详细的操作流程:
一、准备工作
-
注册腾讯云账号
访问 腾讯云官网 并注册账号。 -
购买并创建 CVM 实例
- 登录腾讯云控制台。
- 进入「云服务器 CVM」页面,点击「新建」。
- 选择:
- 地域(建议靠近用户)
- 操作系统:推荐 Ubuntu Server 20.04/22.04 LTS 或 CentOS 7+
- 实例规格:根据项目需求选择(如轻量级应用可选 1核2G)
- 安全组:确保开放
22(SSH)、80(HTTP)、443(HTTPS)端口
- 创建完成后,获取公网 IP 和登录凭证(密钥或密码)
二、连接到 CVM 并安装 Node.js
使用 SSH 工具(如 PuTTY 或终端)连接服务器:
ssh root@你的公网IP
1. 更新系统包
sudo apt update && sudo apt upgrade -y # Ubuntu/Debian
# 或
sudo yum update -y # CentOS
2. 安装 Node.js(推荐使用 nvm)
# 安装 nvm(Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc
# 安装最新长期支持版 Node.js(如 v18.x)
nvm install 18
nvm use 18
nvm alias default 18
验证安装:
node -v
npm -v
三、部署 Node.js 后端服务(示例)
假设你有一个用于微信小程序的 Node.js 服务(如 Express 应用)。
1. 创建项目目录
mkdir /var/www/wechat-api
cd /var/www/wechat-api
2. 初始化项目
npm init -y
npm install express cors body-parser
3. 编写简单服务 app.js
const express = require('express');
const cors = require('cors');
const app = express();
app.use(cors());
app.use(express.json());
// 示例接口:获取欢迎信息
app.get('/api/hello', (req, res) => {
res.json({ message: 'Hello from Tencent Cloud CVM!', timestamp: new Date() });
});
// 微信登录等接口可在此添加...
const PORT = process.env.PORT || 3000;
app.listen(PORT, '0.0.0.0', () => {
console.log(`Server is running on http://0.0.0.0:${PORT}`);
});
4. 使用 PM2 管理进程(推荐)
npm install -g pm2
pm2 start app.js --name "wechat-api"
pm2 startup
pm2 save
四、配置反向(Nginx)和 HTTPS
1. 安装 Nginx
sudo apt install nginx -y
2. 配置 Nginx 反向
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
内容示例:
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;
proxy_cache_bypass $http_upgrade;
}
}
测试并重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
3. 申请免费 SSL 证书(Let’s Encrypt)
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com
注意:需提前将域名解析到 CVM 的公网 IP。
证书会自动配置 HTTPS,并设置定时续期。
五、配置微信小程序
-
登录微信小程序后台
https://mp.weixin.qq.com -
设置服务器域名
- 进入「开发」→「开发管理」→「开发设置」
- 在「request 合法域名」中添加你的 HTTPS 域名:
https://your-domain.com - 小程序只允许通过 HTTPS 调用接口
-
前端调用示例(小程序端)
wx.request({ url: 'https://your-domain.com/api/hello', method: 'GET', success(res) { console.log(res.data); }, fail(err) { console.error(err); } });
六、安全建议
- 开启腾讯云 安全组,仅开放必要端口(22、80、443)
- 使用 密钥对登录,禁用密码登录 SSH
- 定期更新系统和软件包
- 使用 PM2 或 systemd 确保服务常驻运行
- 对敏感接口增加鉴权机制(如 JWT、session)
总结
通过以上步骤,你已在腾讯云 CVM 上成功搭建了支持微信小程序的 Node.js 后端环境:
✅ 创建 CVM
✅ 安装 Node.js
✅ 部署 Express 服务
✅ 配置 Nginx + HTTPS
✅ 绑定域名并接入小程序
如需更高级功能(如数据库 MongoDB/MySQL、WebSocket、云函数集成),可进一步扩展架构。
如有具体项目代码或错误信息,欢迎提供,我可以进一步协助调试。
CLOUD技术笔记