在腾讯云轻量应用服务器(Lighthouse)上部署微信小程序,通常指的是部署小程序的后端服务(如 Node.js、Java、Python 等),因为小程序本身是运行在微信客户端上的,不需要直接“部署”到服务器上。
以下是完整的部署流程指南:
1. 前期准备
- 购买轻量应用服务器:选择操作系统(推荐 Ubuntu 20.04/22.04 或 CentOS 7/8)、配置和带宽。
- 域名与备案:
- 你需要一个已备案的域名(中国大陆地区必须)。
- 将域名解析到服务器的公网 IP。
- 在微信开发者工具中配置合法的
request合法域名(需在微信公众平台后台添加)。
- SSL 证书:小程序后端接口必须使用 HTTPS。你可以使用 Let’s Encrypt 免费申请,或使用腾讯云 SSL 证书服务。
2. 安装基础环境(以 Node.js + Nginx 为例)
登录服务器后执行以下命令:
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Node.js (以 v18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
# 安装 Git
sudo apt install -y git
# 安装 Nginx
sudo apt install -y nginx
# 安装 Certbot 用于申请 SSL 证书
sudo apt install -y certbot python3-certbot-nginx
3. 部署后端代码
假设你的后端代码已上传至 GitHub,通过 Git 克隆并启动:
# 创建项目目录
mkdir -p ~/my-miniprogram-backend
cd ~/my-miniprogram-backend
# 克隆代码(替换为你的仓库地址)
git clone https://github.com/your-user/your-repo.git .
# 安装依赖
npm install
# 启动服务(建议使用 PM2 管理进程)
sudo npm install -g pm2
pm2 start app.js --name "miniprogram-api"
pm2 save
pm2 startup
💡 注意:确保你的后端代码监听的是
0.0.0.0而非localhost,例如app.listen(3000, '0.0.0.0')。
4. 配置 Nginx 反向X_X与 HTTPS
编辑 Nginx 配置文件(路径通常为 /etc/nginx/sites-available/default):
server {
listen 80;
server_name your-domain.com;
# 强制跳转 HTTPS
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name your-domain.com;
ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
location / {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
申请并配置 SSL 证书
# 首次申请证书(需开放 80 端口)
sudo certbot --nginx -d your-domain.com
# 自动续期测试
sudo certbot renew --dry-run
重启 Nginx:
sudo systemctl restart nginx
5. 防火墙与安全组配置
- 云服务器安全组:登录腾讯云控制台 → 轻量应用服务器 → 安全组规则,放行以下端口:
80(HTTP)443(HTTPS)22(SSH,建议限制 IP)
- UFW 防火墙(可选):
sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 22/tcp sudo ufw enable
6. 微信公众平台配置
- 登录 微信公众平台
- 进入「开发」→「开发设置」
- 在「服务器域名」中添加:
- 请求域名:
https://your-domain.com - 上传域名(如需上传图片):同上
- 请求域名:
- 保存并验证(需确保该域名下能访问且返回正确响应)
7. 验证部署
- 在浏览器访问
https://your-domain.com,确认 HTTPS 正常且能连通后端。 - 在微信开发者工具中调用接口,检查是否出现“不在以下 request 合法域名列表中”的错误。
- 查看日志排查问题:
tail -f /var/log/nginx/error.log pm2 logs
常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 无法访问网站 | 安全组未放行端口 | 检查腾讯云控制台安全组规则 |
| HTTPS 报错 | 证书未生效或过期 | 运行 certbot renew 并重启 Nginx |
| 接口跨域错误 | 后端未设置 CORS | 在 Node.js 中使用 cors 中间件 |
| 小程序提示域名不合法 | 未在公众号后台配置 | 确保域名前缀为 https:// 且完全匹配 |
通过以上步骤,你就可以在腾讯云轻量应用服务器上成功部署微信小程序的后端服务。如果需要部署其他语言(如 Java/Spring Boot、Python/Django),原理类似,只需调整运行时环境和启动命令即可。
CLOUD云枢