将微信小程序的后端部署在腾讯云轻量应用服务器(Lighthouse)上是一个常见且高效的方案。以下是详细的部署步骤,帮助你完成从准备到上线的全过程。
一、准备工作
1. 购买并配置腾讯云轻量应用服务器
- 登录 腾讯云官网。
- 进入「轻量应用服务器」控制台,购买一台 Lighthouse 实例。
- 推荐配置:
- 地域:靠近用户(如华南广州)
- 镜像:选择 Ubuntu 20.04 / 22.04 LTS(推荐)
- 套餐:1核2G起步,带宽3Mbps以上
- 开放端口:确保开放
80(HTTP)、443(HTTPS)、22(SSH)
2. 获取服务器信息
- 记下公网 IP 地址
- 设置登录密码或使用 SSH 密钥
二、连接服务器
使用 SSH 工具连接服务器:
ssh root@你的服务器公网IP
首次登录可能需要修改密码。
三、安装运行环境
根据你的后端技术栈安装相应环境。以下以 Node.js + Express + Nginx + MySQL/MongoDB 为例。
1. 更新系统并安装基础工具
sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git nginx -y
2. 安装 Node.js(以 v18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
验证安装:
node -v
npm -v
3. 安装数据库(可选)
-
MySQL:
sudo apt install mysql-server -y sudo mysql_secure_installation -
MongoDB(参考官方文档安装)
四、上传并部署后端代码
1. 克隆或上传项目代码
cd /var/www
git clone https://github.com/yourname/your-backend-repo.git myapp
cd myapp
npm install
若没有使用 Git,可用
scp或sftp上传本地代码。
2. 配置环境变量(.env 文件)
创建 .env 文件,填写数据库连接、微信 AppID/Secret 等:
NODE_ENV=production
PORT=3000
DB_HOST=localhost
DB_USER=root
DB_PASS=yourpassword
WX_APPID=wx123456789
WX_SECRET=abcdefg
3. 使用 PM2 管理 Node.js 进程
安装 PM2:
npm install -g pm2
启动后端服务:
pm2 start app.js --name "wx-api"
pm2 startup
pm2 save
替换
app.js为你的入口文件(如server.js,index.js)
五、配置 Nginx 反向X_X
编辑 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/default
修改内容如下:
server {
listen 80;
server_name your-domain.com; # 或者直接用公网IP
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;
}
}
测试并重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
六、域名与 HTTPS(推荐)
1. 绑定域名
- 在腾讯云购买域名,并解析 A 记录指向服务器公网 IP。
2. 配置 HTTPS(使用免费 SSL 证书)
使用 Certbot + Let’s Encrypt:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com
之后会自动配置 HTTPS 并定期续期。
七、微信小程序配置
在微信小程序管理后台设置:
- 服务器域名白名单
- 登录 微信公众平台
- 进入「开发管理」→「开发设置」
- 在「服务器域名」中添加:
request 合法域名:https://your-domain.comsocket 合法域名:若使用 WebSocket,也需添加
注意:必须使用 HTTPS,不能使用 IP 地址。
八、安全与维护建议
- 防火墙:启用轻量服务器自带防火墙,只开放必要端口。
- 自动备份:定期备份数据库和代码。
- 日志监控:使用
pm2 logs查看运行日志。 - 更新系统:定期
apt update && apt upgrade
九、测试部署
在小程序前端调用接口:
wx.request({
url: 'https://your-domain.com/api/user',
success(res) {
console.log(res.data);
}
})
确保能正常通信。
总结
✅ 成功部署的关键步骤:
| 步骤 | 内容 |
|---|---|
| 1 | 购买并配置轻量服务器 |
| 2 | 安装 Node.js、Nginx、数据库 |
| 3 | 上传并运行后端代码(PM2) |
| 4 | Nginx 反向X_X到 3000 端口 |
| 5 | 配置域名 + HTTPS |
| 6 | 微信小程序配置合法域名 |
如有使用其他框架(如 Koa、ThinkJS、Python Flask/Django),流程类似,只需调整运行命令即可。
如需更自动化,可结合 CI/CD(如 GitHub Actions)实现自动部署。
需要我提供具体项目的部署脚本或 Docker 部署方案吗?
云小栈