在微信小程序中连接腾讯云轻量应用服务器(Lighthouse)并搭建 Node.js 环境,可以分为以下几个步骤:
一、购买并配置腾讯云轻量应用服务器
1. 购买轻量应用服务器
- 登录 腾讯云控制台
- 进入「轻量应用服务器」产品页,选择合适的地区和套餐(推荐 Ubuntu 20.04 或 CentOS 7+)
- 镜像选择:可选“应用镜像”中的 Node.js,或选择“系统镜像”(如 Ubuntu)后手动安装 Node.js
推荐使用系统镜像 + 手动安装,更灵活可控。
二、远程连接服务器(SSH)
1. 获取登录信息
- 在轻量服务器控制台获取公网 IP、用户名(默认
root)、密码或密钥
2. 使用 SSH 工具连接
ssh root@你的公网IP
输入密码即可登录。
三、安装 Node.js 环境(若未预装)
方法一:使用 nvm 安装(推荐)
# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 查看可用版本
nvm list-remote
# 安装稳定版 Node.js(如 v18.17.0)
nvm install 18.17.0
# 设置默认使用
nvm use 18.17.0
nvm alias default 18.17.0
方法二:直接下载安装包(Ubuntu/Debian 示例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
验证安装:
node -v
npm -v
四、部署 Node.js 后端服务
1. 创建项目目录
mkdir /root/my-node-api
cd /root/my-node-api
npm init -y
2. 安装 Express 框架
npm install express cors
3. 创建 app.js
const express = require('express');
const cors = require('cors');
const app = express();
const PORT = 3000;
// 允许跨域(微信小程序需要)
app.use(cors());
app.use(express.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 running at http://0.0.0.0:${PORT}`);
});
4. 启动服务
node app.js
注意:绑定
0.0.0.0才能通过公网访问。
五、配置防火墙与安全组
1. 腾讯云控制台设置安全组
- 进入轻量服务器控制台 → 选择实例 → 安全组
- 添加规则:允许 自定义 TCP 端口,如
3000- 协议类型:TCP
- 端口:3000
- 源 IP:0.0.0.0/0(或限制为微信服务器 IP 段,生产建议更严格)
2. 服务器内开启防火墙(如 UFW)
sudo ufw allow 3000/tcp
sudo ufw enable
六、使用 PM2 管理进程(推荐)
避免关闭终端后服务中断。
npm install -g pm2
pm2 start app.js --name "weapp-api"
pm2 startup
pm2 save
查看状态:
pm2 status
pm2 logs
七、微信小程序连接后端
1. 小程序代码示例(pages/index/index.js)
Page({
onLoad() {
wx.request({
url: 'https://your-server-ip:3000/api/hello', // 或使用域名(需 HTTPS)
method: 'GET',
success: (res) => {
console.log(res.data);
},
fail: (err) => {
console.error('请求失败:', err);
}
});
}
});
八、重要注意事项 ✅
| 项目 | 说明 |
|---|---|
| 🔒 HTTPS | 微信小程序要求必须使用 HTTPS 请求。开发阶段可在“详情-本地设置”中勾选“不校验合法域名”,但上线必须配置 HTTPS。 |
| 🌐 域名备案 | 国内服务器需域名已备案,否则无法申请 SSL 证书。 |
| 🔐 SSL 证书 | 推荐使用 Nginx 反向X_X + 免费证书(腾讯云或 Let’s Encrypt) |
| 🔄 域名解析 | 绑定域名到服务器公网 IP,并配置 DNS 解析 |
九、进阶建议:Nginx + HTTPS(生产环境)
1. 安装 Nginx
sudo apt install nginx
2. 配置反向X_X(/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;
}
}
3. 使用腾讯云免费 SSL 证书
- 在腾讯云申请 SSL 证书(支持轻量服务器)
- 配置 Nginx 使用 HTTPS
总结流程图
腾讯云轻量服务器 → SSH 登录 → 安装 Node.js → 编写 API → PM2 启动
↓
配置安全组开放端口 → 域名备案 + HTTPS → 微信小程序 request 请求
如果你希望我提供完整的脚本、Nginx 配置模板、或自动化部署方案,也可以继续问我!
CDNK博客