将小程序的 Node.js 服务部署到腾讯云轻量应用服务器(LightHouse)是一个常见且实用的方案。以下是详细的部署步骤,帮助你顺利完成:
✅ 一、准备工作
-
购买腾讯云轻量应用服务器
- 登录 腾讯云控制台
- 选择「轻量应用服务器」(LightHouse)
- 创建实例,选择:
- 地域(建议靠近用户)
- 镜像:推荐
Ubuntu 20.04或CentOS 7 - 套餐(1核2G起步足够测试)
- 设置登录密码或密钥对
-
获取服务器公网 IP
- 实例创建成功后,在控制台查看公网 IP 地址(如:
123.56.78.90)
- 实例创建成功后,在控制台查看公网 IP 地址(如:
-
本地代码准备
- 确保你的 Node.js 项目可以正常运行
- 推荐使用
npm start启动服务,监听端口(如3000) - 准备
package.json和必要依赖
✅ 二、连接服务器并配置环境
1. 使用 SSH 连接服务器(以 Ubuntu 为例)
ssh root@你的公网IP
# 输入密码登录
2. 更新系统 & 安装 Node.js 和 npm
# 更新包管理器
sudo apt update
# 安装 Node.js(推荐使用 nvm 方式安装)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18 # 推荐 LTS 版本
node -v # 检查版本
npm -v
也可以直接安装:
sudo apt install nodejs npm
3. 安装 PM2(进程守护工具)
npm install -g pm2
PM2 可以让 Node.js 服务后台运行,并自动重启。
✅ 三、上传项目代码
有几种方式上传代码:
方法一:使用 SCP(推荐简单项目)
在本地终端执行:
scp -r ./your-node-project root@你的公网IP:/root/
方法二:使用 Git(推荐团队/持续更新)
在服务器上克隆项目:
git clone https://github.com/yourname/your-node-project.git
cd your-node-project
npm install
✅ 四、启动 Node.js 服务
进入项目目录:
cd /root/your-node-project
npm install # 安装依赖
使用 PM2 启动服务:
pm2 start app.js --name "my-miniapp-api"
# 或者如果是 server.js 或 npm start
pm2 start npm --name "my-api" -- start
常用 PM2 命令:
pm2 list # 查看运行的服务
pm2 logs # 查看日志
pm2 restart app # 重启
pm2 delete app # 删除
pm2 startup # 设置开机自启(执行后按提示操作)
✅ 五、配置防火墙和安全组
1. 腾讯云控制台设置安全组
- 进入轻量服务器控制台
- 找到你的实例 → 安全组
- 添加规则:放行你的服务端口(如
3000)- 协议类型:TCP
- 端口:
3000 - 源 IP:
0.0.0.0/0(或限制为小程序域名出口 IP)
2. 服务器本地防火墙(可选)
sudo ufw allow 3000
✅ 六、测试访问
在浏览器中访问:
http://你的公网IP:3000
如果返回数据,说明服务已启动成功。
小程序请求时,域名需备案或使用 HTTPS(开发阶段可用局域网调试,正式上线建议配 Nginx + HTTPS)
✅ 七、(可选)配置 Nginx 反向X_X + 域名 + HTTPS
1. 安装 Nginx
sudo apt install nginx
2. 配置反向X_X
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
添加如下内容:
server {
listen 80;
server_name 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;
}
}
测试并重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
3. 申请免费 HTTPS 证书(Let’s Encrypt)
使用 Certbot:
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com
之后自动配置 HTTPS。
✅ 八、小程序端调用注意事项
- 请求域名必须备案并支持 HTTPS(否则无法上线)
- 开发阶段可在微信开发者工具中「不校验合法域名」
- 正式上线前务必配置好 HTTPS
✅ 总结流程
| 步骤 | 内容 |
|---|---|
| 1 | 购买轻量服务器,获取 IP |
| 2 | SSH 登录,安装 Node.js、PM2 |
| 3 | 上传代码(SCP/Git) |
| 4 | npm install 并用 PM2 启动 |
| 5 | 安全组放行端口 |
| 6 | 测试访问 |
| 7 | (可选)Nginx + 域名 + HTTPS |
如果你提供具体项目结构或框架(如 Express、Koa),我可以给出更具体的 app.js 示例或部署脚本。
需要我帮你写一个自动化部署脚本吗?
云小栈