在腾讯云轻量应用服务器(Tencent Cloud Lighthouse)上配置 Node.js 服务用于小程序后端,可以按照以下步骤进行。本教程适用于 Linux 系统(如 Ubuntu 或 CentOS),假设你已经购买并初始化了轻量服务器。
✅ 第一步:登录服务器
使用 SSH 登录你的轻量服务器:
ssh root@你的服务器公网IP
密码或密钥在腾讯云控制台获取。
✅ 第二步:安装 Node.js 和 npm
推荐使用 nvm(Node Version Manager)来安装和管理 Node.js 版本。
1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
然后重新加载 shell 配置:
source ~/.bashrc
2. 安装 Node.js(推荐 LTS 版本)
nvm install --lts
验证安装:
node -v
npm -v
✅ 第三步:上传或创建你的 Node.js 小程序后端项目
你可以通过以下方式之一上传代码:
方式一:直接在服务器上克隆 GitHub 项目
git clone https://github.com/yourname/your-nodejs-project.git
cd your-nodejs-project
提示:如果没安装 git,先运行
sudo apt update && sudo apt install git -y
方式二:本地打包上传(使用 scp)
scp -r ./your-project root@你的IP:/root/
然后进入目录:
cd /root/your-project
安装依赖
npm install
✅ 第四步:编写或修改启动脚本(app.js 或 server.js)
确保你的 Node.js 服务监听 0.0.0.0 而不是 localhost 或 127.0.0.1,否则外部无法访问。
const express = require('express');
const app = express();
app.get('/api/hello', (req, res) => {
res.json({ message: 'Hello from Tencent Cloud!' });
});
const PORT = process.env.PORT || 3000;
app.listen(PORT, '0.0.0.0', () => {
console.log(`Server running on http://0.0.0.0:${PORT}`);
});
✅ 第五步:使用 PM2 守护进程管理 Node.js 应用
PM2 可以让 Node.js 后台运行,并自动重启。
1. 安装 PM2
npm install -g pm2
2. 启动项目
pm2 start app.js --name "mini-program-api"
3. 设置开机自启
pm2 startup
pm2 save
常用 PM2 命令
pm2 list # 查看运行进程
pm2 logs # 查看日志
pm2 restart app # 重启
pm2 stop app # 停止
✅ 第六步:配置防火墙和安全组(关键!)
1. 腾讯云控制台设置安全组
进入【腾讯云轻量应用服务器控制台】 → 找到你的实例 → 【防火墙】→ 添加规则:
- 协议类型:自定义 TCP
- 端口:
3000(或你 Node.js 使用的端口) - 源 IP:
0.0.0.0/0(或限制为微信服务器 IP,更安全)
微信小程序请求来源 IP 可参考官方文档:https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/Message_Encryption/IP_ranges.html
2. 服务器本地防火墙(可选)
Ubuntu 示例(UFW):
sudo ufw allow 3000
✅ 第七步:域名与 HTTPS(生产环境建议)
小程序要求后端接口必须是 HTTPS 协议。
方案一:使用 Nginx + SSL 证书(推荐)
- 安装 Nginx:
sudo apt install nginx -y
- 配置反向X_X(编辑
/etc/nginx/sites-available/default):
server {
listen 80;
server_name yourdomain.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;
}
}
- 申请免费 SSL 证书(使用 Certbot)
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com
之后 Nginx 会自动配置 HTTPS,小程序即可通过 https://yourdomain.com/api/xxx 访问。
✅ 第八步:小程序前端调用测试
在小程序中发起请求:
wx.request({
url: 'https://yourdomain.com/api/hello',
success(res) {
console.log(res.data);
}
})
确保域名已添加到小程序管理后台的「request 合法域名」中。
📌 总结
| 步骤 | 内容 |
|---|---|
| 1 | 登录轻量服务器 |
| 2 | 安装 Node.js(nvm) |
| 3 | 上传项目并安装依赖 |
| 4 | 修改监听地址为 0.0.0.0 |
| 5 | 使用 PM2 启动并守护进程 |
| 6 | 配置安全组开放端口 |
| 7 | (推荐)配置 Nginx + HTTPS |
| 8 | 小程序配置 request 域名 |
如有需要,我可以提供一个完整的 Express + MySQL + HTTPS 的小程序后端模板项目结构。欢迎继续提问!
CDNK博客