腾讯云轻量服务器如何配置Node.js服务用于小程序?

服务器

在腾讯云轻量应用服务器(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 而不是 localhost127.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 证书(推荐)

  1. 安装 Nginx:
sudo apt install nginx -y
  1. 配置反向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;
    }
}
  1. 申请免费 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博客 » 腾讯云轻量服务器如何配置Node.js服务用于小程序?