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

服务器

在微信小程序中连接腾讯云轻量应用服务器(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博客 » 微信小程序连接腾讯云轻量服务器Node.js环境如何搭建?