在腾讯云轻量应用服务器(Lighthouse)上搭建小程序后台是一个常见且高效的部署方式。以下是详细的步骤指南,帮助你完成从小程序后台开发到上线的全过程。
一、准备工作
-
注册腾讯云账号
- 访问 腾讯云官网
- 注册并实名认证。
-
购买轻量应用服务器(Lighthouse)
- 进入控制台:轻量应用服务器控制台
- 选择地区(建议靠近用户)
- 操作系统:推荐选择 Ubuntu 20.04 / 22.04 LTS 或 CentOS 7/8
- 镜像:可选“纯净镜像”或“应用镜像”(如 Node.js 环境镜像)
- 套餐:根据需求选择(新手建议 2核2G 起步)
- 设置登录密码或密钥对
-
备案域名(可选但推荐)
- 如果你要使用自定义域名(如
api.yourdomain.com),需进行 ICP 备案。 - 小程序请求必须使用 HTTPS 和已备案的域名。
- 如果你要使用自定义域名(如
二、配置服务器环境
1. 登录服务器
使用 SSH 登录:
ssh root@你的服务器公网IP
# 或使用密钥登录
ssh -i 私钥文件 root@公网IP
2. 安装 Node.js 和 PM2(以 Ubuntu 为例)
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Node.js(推荐 v16/v18)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 安装 PM2(进程管理工具)
npm install -g pm2
3. 安装 Nginx(反向 + HTTPS)
sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx
4. 安装数据库(如 MongoDB 或 MySQL)
- MongoDB 示例:
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add - echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list sudo apt update sudo apt install -y mongodb-org sudo systemctl start mongod sudo systemctl enable mongod
注意:生产环境请设置数据库用户名密码并限制远程访问。
三、上传并运行小程序后台代码
假设你的后端是基于 Node.js 的 Express/Koa 框架。
1. 上传代码
方式一:使用 Git(推荐)
git clone https://github.com/yourname/miniapp-backend.git
cd miniapp-backend
npm install
方式二:使用 SCP/SFTP 上传本地代码。
2. 配置环境变量
创建 .env 文件:
PORT=3000
MONGODB_URI=mongodb://localhost:27017/miniappdb
NODE_ENV=production
3. 使用 PM2 启动服务
pm2 start app.js --name "miniapp-api"
pm2 save
pm2 startup # 设置开机自启
此时后端服务运行在 http://localhost:3000。
四、配置 Nginx 反向 + HTTPS
1. 配置 Nginx 站点
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
内容示例:
server {
listen 80;
server_name api.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;
}
}
测试配置并重启:
sudo nginx -t
sudo systemctl reload nginx
2. 申请免费 SSL 证书(Let’s Encrypt)
安装 Certbot:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d api.yourdomain.com
Certbot 会自动修改 Nginx 配置启用 HTTPS,并设置自动续期。
五、小程序端配置
在微信开发者工具中:
- 打开
project.config.json或通过管理后台设置: - 在「开发管理」→「开发设置」→「服务器域名」中添加:
"request": [
"https://api.yourdomain.com"
]
注意:必须使用 HTTPS,不能使用 IP 地址或未备案域名。
六、安全与维护建议
-
防火墙设置
- 在腾讯云控制台设置安全组:
- 开放 80(HTTP)、443(HTTPS)
- 关闭 22(SSH)仅允许特定 IP 访问(可选)
- 在腾讯云控制台设置安全组:
-
定期备份
- 数据库定时备份(可用 crontab + mongodump)
- 代码版本管理(Git)
-
监控
- 使用 PM2 监控进程:
pm2 monit - 可接入腾讯云监控服务
- 使用 PM2 监控进程:
-
日志查看
pm2 logs
七、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 小程序提示“网络错误” | 检查域名是否备案、HTTPS 是否生效、Nginx 是否正常 |
| 接口返回 502 | 检查后端服务是否运行(pm2 list),端口是否正确 |
| 数据库连接失败 | 检查 MongoDB 是否启动,连接字符串是否正确 |
| SSH 登录失败 | 检查安全组是否开放 22 端口,密码是否正确 |
总结
✅ 成功搭建流程:
- 购买轻量服务器 →
- 部署 Node.js + 数据库 →
- 上传并运行后端代码 →
- 配置 Nginx + HTTPS →
- 小程序配置合法域名 →
- 正式上线!
如果你使用的是现成框架如 Koa + MongoDB 或 Express + MySQL,也可以提供具体技术栈,我可以给出更精确的部署脚本。
需要我提供一个完整的 Express 后端模板或自动化部署脚本吗?
云计算CLOUD