微信小程序连接腾讯云轻量服务器Node.js环境如何搭建？

在微信小程序中连接腾讯云轻量应用服务器（Lighthouse）并搭建 Node.js 环境，可以按照以下步骤进行。整个过程包括：购买与配置轻量服务器、部署 Node.js 环境、启动后端服务、配置域名与 HTTPS、最后从小程序调用接口。

一、准备工作

1. 注册腾讯云账号
   访问 腾讯云官网 注册账号并完成实名认证。

2. 购买轻量应用服务器（Lighthouse）

   • 进入控制台 → 轻量应用服务器 → 创建实例
   • 选择地区（建议选离用户近的，如广州、上海）
   • 镜像选择：自定义镜像 → Ubuntu / CentOS（推荐 Ubuntu 20.04/22.04 LTS）
   • 配置套餐：1核2G起步即可用于测试
   • 设置登录方式：密钥或密码（建议使用 SSH 密钥更安全）

3. 获取公网 IP 地址
   实例创建完成后，在控制台查看分配的公网 IP（例如 123.123.123.123）

二、远程连接服务器（SSH）

使用终端（Mac/Linux）或工具如 PuTTY / Xshell / FinalShell（Windows）连接服务器：

ssh root@你的公网IP
# 输入密码或使用私钥登录

三、安装 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

# 检查版本
node -v  # 应输出 v18.xx.x
npm -v

✅ 推荐使用 Node.js 16 或 18 LTS 版本，兼容性好。

四、上传并运行你的 Node.js 后端项目

1. 上传代码到服务器

方式①：使用 Git 克隆项目

git clone https://github.com/yourname/your-node-project.git
cd your-node-project
npm install

方式②：本地打包上传（使用 SCP）

# 在本地执行
scp -r ./your-project root@你的IP:/root/

然后在服务器上进入目录：

cd /root/your-project
npm install

2. 编写简单测试 API（可选）

创建 app.js 示例：

const express = require('express');
const app = express();

app.use(express.json());

app.get('/api/hello', (req, res) => {
  res.json({ message: 'Hello from Tencent Cloud Lighthouse!' });
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running on port ${PORT}`);
});

安装 Express：

npm install express

启动服务：

node app.js

五、开放防火墙端口（关键！）

1. 腾讯云控制台设置安全组

• 进入【轻量应用服务器】→ 【防火墙】
• 添加规则：
  • 协议类型：TCP
  • 端口：3000（或你使用的端口）
  • 源 IP：0.0.0.0/0（允许所有访问，生产环境建议限制）

✅ 确保你的 Node.js 服务监听 0.0.0.0，而不是 localhost。

六、配置域名与 HTTPS（微信小程序强制要求 HTTPS）

1. 购买并解析域名

• 在腾讯云购买域名（如 example.com）
• 添加 A 记录指向你的轻量服务器公网 IP

2. 使用 Nginx + SSL 反向X_X（推荐）

安装 Nginx

apt update
apt install nginx -y
systemctl start nginx
systemctl enable nginx

配置反向X_X

编辑配置文件：

nano /etc/nginx/sites-available/default

修改内容如下：

server {
    listen 80;
    server_name api.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：

nginx -t           # 测试配置是否正确
systemctl reload nginx

3. 申请免费 SSL 证书（HTTPS）

使用 Let’s Encrypt（通过 Certbot）：

apt install certbot python3-certbot-nginx -y
certbot --nginx -d api.yourdomain.com

Certbot 会自动配置 HTTPS 并更新 Nginx。

✅ 完成后，你的接口地址变为：
https://api.yourdomain.com/api/hello

七、微信小程序中调用接口

1. 配置 request 合法域名

进入【微信公众平台】→ 开发管理 → 开发设置 → 服务器域名

将你的域名加入：

request 合法域名：https://api.yourdomain.com

⚠️ 必须是 HTTPS，且已备案域名（国内服务器需 ICP 备案）

2. 小程序代码示例

// pages/index/index.js
Page({
  onLoad() {
    wx.request({
      url: 'https://api.yourdomain.com/api/hello',
      method: 'GET',
      success(res) {
        console.log(res.data); // 输出 { message: "Hello from Tencent Cloud Lighthouse!" }
      },
      fail(err) {
        console.error('请求失败', err);
      }
    });
  }
});

八、进程守护（防止 Node.js 崩溃退出）

使用 PM2 守护进程：

npm install -g pm2
pm2 start app.js --name "my-api"
pm2 startup
pm2 save

常用命令：

pm2 logs         # 查看日志
pm2 restart my-api
pm2 stop my-api

总结：完整流程图

微信小程序
     ↓ (HTTPS 请求)
域名 api.yourdomain.com
     ↓ (Nginx 反向X_X + SSL)
腾讯云轻量服务器（公网IP）
     ↓ (内部转发)
Node.js 服务运行在 3000 端口

注意事项

如果你需要，我也可以提供一个完整的 Express + MySQL + 小程序登录的模板项目结构。

祝你部署顺利！🚀