在腾讯云轻量应用服务器(Lighthouse)上部署微信小游戏后端,核心在于跑通 Node.js 环境并正确配置网络与安全组。微信小游戏的后端通常基于 wx-server-sdk,主要涉及云函数、云数据库或自定义 HTTP 服务。这里我们以最常见的 Express/Koa + wx-server-sdk 自定义服务端为例,因为轻量服务器更灵活,适合全栈开发。
以下是实操步骤,按逻辑顺序执行:
一、 准备工作:购买与系统选择
-
实例选择:
- 建议选用 CentOS 7.6+ 或 Ubuntu 20.04/22.04。CentOS 生态对 Node.js 支持最成熟,文档最多;Ubuntu 包管理更现代。本例以 CentOS 7.9 为例,其他系统命令类似。
- 配置建议:2核4G起步,带宽至少 3Mbps(国内访问速度关键),存储 40GB SSD。
-
域名备案:
- 重要:微信小游戏要求后端接口必须使用 HTTPS,且域名需在工信部备案。如果你没有备案域名,只能先用 IP 调试(仅限本地测试,无法上线)。
- 在腾讯云控制台完成域名备案后,解析到你的轻量服务器公网 IP。
二、 连接服务器 & 基础环境搭建
通过 SSH 登录你的轻量服务器(推荐使用腾讯云终端或本地终端):
ssh root@你的服务器IP
1. 安装 Node.js 和 npm
推荐使用 nvm (Node Version Manager) 管理多版本,避免权限问题:
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载环境变量
source ~/.bash_profile
# 安装最新 LTS 版本(推荐 v18 或 v20)
nvm install --lts
nvm use --lts
node -v # 确认版本
npm -v # 确认版本
注意:不要直接用
yum install nodejs,版本往往过旧,且可能缺少某些依赖。
2. 安装 PM2(进程管理器)
生产环境必须用 PM2 守护进程,防止服务崩溃后无人重启:
npm install -g pm2
pm2 --version
三、 项目初始化与代码结构
在你的服务器上创建项目目录:
mkdir ~/wx-game-backend
cd ~/wx-game-backend
初始化项目并安装必要依赖:
npm init -y
npm install express wx-server-sdk cors dotenv
示例代码结构
~/wx-game-backend/
├── app.js # 主入口文件
├── config.json # 配置文件(存放 AppID 和 Secret)
└── package.json
1. 编写 config.json
{
"appId": "你的微信小程序 AppID",
"appSecret": "你的小程序 AppSecret"
}
安全提示:切勿将
config.json提交到 Git 仓库!在.gitignore中添加config.json。
2. 编写 app.js
const express = require('express');
const wxServerSdk = require('wx-server-sdk');
const cors = require('cors');
const fs = require('fs');
// 读取配置
const config = JSON.parse(fs.readFileSync('./config.json', 'utf8'));
// 初始化 wx-server-sdk
wxServerSdk.init({
env: '你的云开发环境ID', // 如果用的是云开发 DB/Storage
credential: {
appid: config.appId,
secret: config.appSecret
}
});
const app = express();
const port = process.env.PORT || 3000;
// 中间件
app.use(cors()); // 允许跨域,前端请求需带 credentials: true
app.use(express.json());
// 示例接口:获取用户 openid
app.get('/getOpenId', async (req, res) => {
const code = req.query.code;
if (!code) {
return res.status(400).json({ error: 'Missing code' });
}
try {
// 调用微信登录凭证校验接口
const result = await wxServerSdk.cloud.callContainer({
path: '/auth/login', // 实际路径根据你的业务调整
method: 'POST',
data: { code }
});
// 或者直接使用 wx-server-sdk 提供的 login 方法(需特定版本支持)
// 更常见的是自己调用 wx.login 的 server 端逻辑
res.json({ success: true, openid: '模拟openid' });
} catch (err) {
console.error(err);
res.status(500).json({ error: 'Server error' });
}
});
// 健康检查
app.get('/health', (req, res) => {
res.send('OK');
});
app.listen(port, () => {
console.log(`Server running on port ${port}`);
});
关键点:微信小游戏后端通常需要处理
wx.login返回的code,换取openid。这部分逻辑可以在你自己的服务器上实现,也可以直接接入腾讯云“云开发”(CloudBase),后者无需自建服务器,但本题是轻量服务器,所以侧重自建。
四、 启动服务
使用 PM2 启动应用:
pm2 start app.js --name "wx-game-backend"
pm2 save
pm2 startup
验证服务是否运行:
curl http://localhost:3000/health
# 应返回 OK
五、 网络与安全组配置(最关键一步)
很多新手在这里卡住:本地能 curl,网络访问不了。
1. 腾讯云轻量服务器防火墙(安全组)
登录 腾讯云控制台 -> 轻量应用服务器 -> 选择你的实例 -> 防火墙。
添加规则:
- 方向:入站
- 协议端口:TCP 3000(你设置的端口)
- 授权策略:允许
- 来源:0.0.0.0/0(或指定你的前端域名 IP,生产环境建议限制)
注意:如果你希望使用标准 HTTP 80 或 HTTPS 443 端口,需要额外配置 Nginx 反向XX,并在安全组开放 80/443。对于简单测试,直接用 3000 端口更方便。
2. 操作系统内部防火墙(firewalld)
CentOS 默认启用 firewalld,需放行端口:
sudo firewall-cmd --zone=public --add-port=3000/tcp --permanent
sudo firewall-cmd --reload
验证:
curl http://你的公网IP:3000/health
# 应返回 OK
六、 微信开发者工具配置
- 打开微信开发者工具,进入你的小游戏项目。
- 点击右上角“详情” -> “本地设置” -> 勾选 “不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书”。(仅调试阶段,上线前必须取消)
- 在代码中设置后端地址:
// 例如在 util.js 或 request 封装中
const BASE_URL = 'http://你的公网IP:3000'; // 调试期可用 IP
// 上线后改为 https://yourdomain.com
- 调用接口测试:
wx.request({
url: `${BASE_URL}/getOpenId?code=${wxCode}`,
method: 'GET',
success(res) {
console.log('Success:', res.data);
},
fail(err) {
console.error('Fail:', err);
}
})
七、 上线前必备优化
-
HTTPS 配置:
- 微信支付和正式环境强制 HTTPS。
- 在轻量服务器上安装 Nginx,配置 SSL 证书(可从腾讯云免费申请 DV 证书)。
- Nginx 反向XX Node.js 服务:
server { listen 443 ssl; server_name yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/cert.key; location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } -
域名备案:确保
yourdomain.com已备案,否则 Nginx 会拦截请求。 -
PM2 日志监控:
pm2 logs wx-game-backend -
自动重启:确保
pm2 startup已执行,这样服务器重启后服务自动拉起。
常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
微信端报 request:fail |
域名未备案或未加入合法域名 | 调试期关闭校验;上线前添加域名至微信公众平台后台 |
| 网络无法访问 | 安全组未放行端口 | 检查腾讯云控制台防火墙规则 |
| 服务启动失败 | 端口被占用 | netstat -tlnp | grep 3000 查看占用进程,kill 掉 |
wx-server-sdk 报错 |
AppID/AppSecret 错误 | 检查 config.json 是否正确,注意无空格 |
| 跨域错误 | 前端未携带 credentials | 前端 wx.request 加 header: { 'Content-Type': 'application/json' },后端 cors 中间件配置正确 |
总结
在腾讯云轻量服务器上运行微信小游戏后端,核心流程是:
- 装环境:nvm + Node.js + PM2
- 写代码:Express + wx-server-sdk
- 开端口:腾讯云防火墙 + 系统 firewalld
- 配域名:Nginx + SSL + 备案(上线必需)
- 调通联:开发者工具测试 → 修复 bug → 正式上线
整个过程不涉及复杂架构,重点在于网络连通性和安全组配置。一旦跑通,后续只需关注业务逻辑和性能优化即可。
云技术博客