将小程序源码部署到腾讯云轻量应用服务器(Lighthouse)是一个常见的开发部署流程。下面是一个详细的步骤指南,帮助你完成从小程序源码到腾讯云轻量服务器的部署。
一、准备工作
-
购买腾讯云轻量应用服务器(Lighthouse)
- 登录 腾讯云官网
- 进入「轻量应用服务器」控制台,选择合适的地区、配置(建议选择 Ubuntu/CentOS 系统)
- 购买并创建实例,记录公网 IP、用户名(如
root)、密码或密钥
-
准备小程序源码
- 小程序前端代码(通常是
miniprogram目录) - 后端服务代码(Node.js、PHP、Python 等,用于提供 API 接口)
- 本教程重点讲解后端 API 服务部署到轻量服务器
- 小程序前端代码(通常是
二、连接服务器(SSH)
使用 SSH 工具连接服务器:
ssh root@你的服务器公网IP
输入密码或使用密钥登录。
三、安装运行环境
根据你的后端语言选择安装环境。以下以 Node.js + Nginx 为例:
1. 更新系统并安装必要工具
apt update && apt upgrade -y
2. 安装 Node.js(以 v18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
apt-get install -y nodejs
验证安装:
node -v
npm -v
3. 安装 PM2(进程管理工具)
npm install -g pm2
4. 安装 Nginx(可选,用于反向和静态资源)
apt install nginx -y
systemctl start nginx
systemctl enable nginx
四、上传小程序后端源码
方法一:使用 SCP 上传(推荐)
在本地终端执行:
scp -r 你的后端代码目录 root@你的IP:/root/myapp
方法二:使用 Git 克隆
如果你代码托管在 GitHub/Gitee:
git clone https://github.com/yourname/your-backend.git /root/myapp
五、配置并启动后端服务
- 进入项目目录:
cd /root/myapp
- 安装依赖:
npm install
-
修改配置文件(如
config.js或.env):- 数据库连接信息
- 端口(建议使用非 80/443,如 3000)
- 域名或 IP 白名单(用于小程序请求)
-
使用 PM2 启动服务:
pm2 start app.js --name "my-miniprogram-api"
- 设置开机自启:
pm2 startup
pm2 save
六、配置 Nginx 反向(可选但推荐)
编辑 Nginx 配置:
nano /etc/nginx/sites-available/default
添加如下配置(假设后端运行在 3000 端口):
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:
nginx -t # 测试配置
systemctl reload nginx
七、开放防火墙端口
在腾讯云控制台:
- 进入「轻量服务器」→「防火墙」
- 添加规则:开放端口
80(HTTP)、443(HTTPS)、3000(如直接访问)
八、域名与 HTTPS(可选)
-
绑定域名
- 在腾讯云购买域名,并解析到服务器 IP
- 在 Nginx 中配置
server_name yourdomain.com
-
配置 HTTPS(使用 Let’s Encrypt)
apt install certbot python3-certbot-nginx -y
certbot --nginx -d yourdomain.com
九、小程序前端配置
在小程序代码中修改请求域名:
// 示例
wx.request({
url: 'https://yourdomain.com/api/login',
// ...
})
注意:必须使用 HTTPS,且域名需在小程序管理后台「开发管理」→「开发设置」→「服务器域名」中配置。
十、常见问题排查
| 问题 | 解决方法 |
|---|---|
| 无法访问 API | 检查防火墙、Nginx、后端是否运行 |
| 请求被拒绝 | 检查小程序后台域名白名单 |
| 502 Bad Gateway | 检查后端服务是否启动,端口是否正确 |
| 静态资源无法加载 | 使用 Nginx 托管静态文件或 CDN |
总结
✅ 成功部署的关键步骤:
- 购买并登录轻量服务器
- 安装 Node.js、PM2、Nginx
- 上传后端源码并启动
- 配置 Nginx 反向
- 小程序配置合法域名
如果你提供具体的技术栈(如:Koa、Express、ThinkPHP、Django 等),我可以给出更具体的部署脚本和配置。
需要我为你生成一键部署脚本吗?
CLOUD技术博