在腾讯云轻量应用服务器(Lighthouse)上搭建小程序后端服务,是一个非常适合初学者和中小型项目的方案。以下是一个详细的图文+步骤教程,帮助你从零开始完成小程序后端服务的搭建。
🌐 一、准备工作
1. 购买腾讯云轻量应用服务器
- 登录 腾讯云官网
- 搜索“轻量应用服务器”或进入 Lighthouse 控制台
- 选择配置(建议:2核2G,5M带宽,1年套餐)
- 选择操作系统:Ubuntu 20.04 / CentOS 7 / 或者“应用镜像”中的 Node.js 镜像
- 设置登录方式(密钥或密码)
- 完成购买
✅ 推荐选择“应用镜像”中的 Node.js + Nginx 镜像,可省去环境安装步骤。
🛠️ 二、配置服务器环境
1. 登录服务器(使用 SSH)
ssh root@你的服务器公网IP
# 输入密码或使用密钥登录
2. 更新系统(Ubuntu 示例)
sudo apt update && sudo apt upgrade -y
3. 安装 Node.js(如果未预装)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
验证安装:
node -v
npm -v
🚀 三、部署后端服务(Node.js + Express)
1. 创建项目目录
mkdir /var/www/myapp
cd /var/www/myapp
2. 初始化 Node.js 项目
npm init -y
npm install express body-parser cors
3. 创建 server.js
const express = require('express');
const bodyParser = require('body-parser');
const cors = require('cors');
const app = express();
const PORT = 3000;
app.use(cors());
app.use(bodyParser.json());
// 小程序测试接口
app.get('/api/hello', (req, res) => {
res.json({ message: 'Hello from Tencent Cloud Lighthouse!' });
});
// 其他接口可以继续添加...
app.listen(PORT, '0.0.0.0', () => {
console.log(`Server is running on http://0.0.0.0:${PORT}`);
});
4. 启动服务(测试)
node server.js
此时服务运行在 3000 端口,监听所有 IP(0.0.0.0)
🔌 四、配置防火墙和安全组
1. 腾讯云控制台配置安全组
- 进入 轻量应用服务器控制台
- 找到你的实例 → 点击“防火墙”
- 添加规则:
- 协议类型:自定义 TCP
- 端口:
3000 - 源 IP:
0.0.0.0/0(或限制为小程序域名 IP)
✅ 也可以使用 Nginx 反向X_X到 80 端口,更安全。
🔄 五、使用 PM2 守护进程(防止服务中断)
1. 安装 PM2
npm install -g pm2
2. 启动服务
pm2 start server.js --name "my-miniprogram-api"
3. 设置开机自启
pm2 startup
pm2 save
🌍 六、配置域名和 HTTPS(可选但推荐)
1. 绑定域名
- 在腾讯云购买域名或使用已有域名
- 在 DNS 控制台添加 A 记录指向服务器公网 IP
2. 使用 Nginx 反向X_X(推荐)
安装 Nginx:
sudo apt install nginx -y
配置 Nginx(/etc/nginx/sites-available/default):
server {
listen 80;
server_name yourdomain.com; # 替换为你的域名
location / {
proxy_pass http://127.0.0.1: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;
}
}
重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
3. 申请免费 SSL 证书(HTTPS)
使用腾讯云或 Let’s Encrypt:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com
📱 七、小程序前端调用后端 API
在小程序的 app.js 或页面中调用:
wx.request({
url: 'https://yourdomain.com/api/hello',
method: 'GET',
success(res) {
console.log(res.data);
},
fail(err) {
console.error(err);
}
})
⚠️ 注意:小程序要求后端必须是 HTTPS 协议(正式上线时)
✅ 八、常见问题解决
| 问题 | 解决方案 |
|---|---|
| 无法访问 3000 端口 | 检查安全组是否放行 |
| 域名无法访问 | 检查 DNS 解析和 Nginx 配置 |
| 接口返回 404 | 检查 Express 路由路径 |
| 小程序提示“不支持的域名” | 登录小程序管理后台 → 开发管理 → 开发设置 → 修改 request 合法域名 |
🎉 总结
你已经成功在腾讯云轻量应用服务器上搭建了小程序后端服务!整个流程如下:
- 购买服务器
- 配置环境(Node.js)
- 编写后端接口
- 使用 PM2 守护进程
- 配置 Nginx + HTTPS
- 小程序调用 API
📚 推荐学习资源
- 腾讯云轻量应用服务器文档
- Express 官方文档
- 微信小程序开发文档
如果你需要,我可以提供 完整项目代码模板 或 自动化部署脚本。欢迎继续提问!
CLOUD云