在腾讯云轻量应用服务器上配置 Node.js 服务用于微信小程序,可以按照以下步骤进行操作。整个流程包括:购买轻量服务器、连接服务器、安装 Node.js、部署项目、启动服务并配置域名和 HTTPS。
✅ 第一步:购买并初始化轻量应用服务器
- 登录 腾讯云控制台
- 进入「轻量应用服务器」页面
- 创建实例:
- 地域选择靠近用户的位置(如广州、上海)
- 镜像建议选择 Ubuntu Server 20.04 LTS 或 CentOS 7.9
- 其他配置根据需求选择(1核2G起步即可)
- 设置登录密码或密钥对
- 开放端口:
- 确保防火墙中开放了
22(SSH)、80(HTTP)、443(HTTPS)等端口 - 如果使用其他端口(如 3000),也要在防火墙中放行
- 确保防火墙中开放了
✅ 第二步:通过 SSH 连接服务器
ssh root@你的服务器公网IP
# 输入密码登录
✅ 第三步:安装 Node.js 和 npm
推荐使用 NodeSource 的 PPA 安装较新版本的 Node.js:
Ubuntu 示例:
# 更新系统
sudo apt update
# 安装 curl(如果没有)
sudo apt install -y curl
# 添加 NodeSource 仓库(以 Node.js 18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 安装 Node.js 和 npm
sudo apt install -y nodejs
# 验证安装
node -v # 应输出 v18.x.x
npm -v # 输出版本号
建议使用 LTS 版本(如 18.x)
✅ 第四步:上传或克隆你的 Node.js 小程序后端项目
你可以使用 Git 克隆,或者用 scp 上传本地代码。
方法一:使用 Git(推荐)
# 安装 git
sudo apt install -y git
# 克隆你的项目(替换为你的仓库地址)
git clone https://github.com/yourname/your-nodejs-project.git
cd your-nodejs-project
方法二:本地上传(使用 scp)
# 在本地终端执行(非服务器)
scp -r ./your-project root@你的IP:/root/
✅ 第五步:安装依赖并测试运行
cd your-nodejs-project
# 安装依赖
npm install
# 启动服务(假设入口文件是 app.js 或 server.js)
node app.js
注意:默认情况下,Node.js 可能监听
localhost:3000,要让外部访问,需监听0.0.0.0:3000
示例代码片段:
app.listen(3000, '0.0.0.0', () => {
console.log('Server is running on port 3000');
});
✅ 第六步:使用 PM2 持续运行服务(推荐)
避免关闭 SSH 后进程终止。
# 全局安装 pm2
npm install -g pm2
# 启动项目
pm2 start app.js --name "my-miniapp-api"
# 设置开机自启
pm2 startup
pm2 save
常用命令:
pm2 status
pm2 logs my-miniapp-api
pm2 restart my-miniapp-api
✅ 第七步:配置域名与 HTTPS(用于小程序要求)
小程序要求后端接口必须是 HTTPS 协议,所以你需要:
1. 绑定域名
- 购买域名并在腾讯云完成备案
- 解析域名到服务器公网 IP(A 记录)
2. 使用 Nginx 反向X_X + SSL 证书
安装 Nginx
sudo apt install -y nginx
配置 Nginx(例如 /etc/nginx/sites-available/default)
server {
listen 80;
server_name yourdomain.com;
location / {
proxy_pass http://127.0.0.1:3000; # 转发到 Node.js 服务
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 systemctl restart nginx
3. 申请免费 SSL 证书(Let’s Encrypt)
# 安装 certbot
sudo apt install -y certbot python3-certbot-nginx
# 申请证书(确保域名已解析)
sudo certbot --nginx -d yourdomain.com
完成后自动配置 HTTPS,Nginx 会重定向 80 → 443。
✅ 第八步:小程序调用 API
在微信小程序中:
wx.request({
url: 'https://yourdomain.com/api/login',
method: 'GET',
success(res) {
console.log(res.data);
}
})
确保:
- 域名已在 小程序管理后台 的「开发设置」中添加到 request 合法域名
- 接口返回数据格式正确(JSON)
- 服务器时间同步(避免证书报错)
✅ 补充建议
| 项目 | 建议 |
|---|---|
| 数据库 | 可搭配 MongoDB(MongoDB Atlas)或 MySQL(腾讯云数据库) |
| 日志监控 | 使用 PM2 日志或接入腾讯云日志服务 |
| 自动部署 | 可配合 GitHub Actions / webhook 实现自动拉取更新 |
📌 总结流程
购买轻量服务器 → SSH 登录 → 安装 Node.js → 部署项目 → PM2 托管 → Nginx + HTTPS → 小程序调用
如有具体框架(如 Express、Koa、NestJS),可进一步提供帮你定制配置。
需要我生成一个完整的 Express 示例项目结构吗?
云计算导航