将小程序的 Node.js 服务部署到腾讯云轻量应用服务器(Tencent Cloud Lighthouse)是一个常见且高效的方案。以下是详细的部署步骤,帮助你顺利将 Node.js 后端服务部署上线。
✅ 一、准备工作
-
购买腾讯云轻量应用服务器
- 登录 腾讯云控制台
- 进入「轻量应用服务器」,选择合适的套餐(推荐 Ubuntu 20.04 或 CentOS)
- 设置登录方式:建议使用密钥对或密码登录
-
获取服务器信息
- 记下公网 IP 地址
- 开放端口(如 3000、8080、80 等)在防火墙中
✅ 二、连接服务器(SSH)
使用终端或工具(如 Xshell、PuTTY、VS Code Remote SSH)连接:
ssh root@你的服务器IP
首次登录可能需要修改密码。
✅ 三、安装 Node.js 和 npm
方法一:使用 nvm 安装(推荐)
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置
source ~/.bashrc
# 安装 Node.js(例如 v18.x)
nvm install 18
# 验证安装
node -v
npm -v
方法二:直接下载编译包(适合无网络问题)
参考官方文档或使用 apt(Ubuntu):
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
✅ 四、上传你的 Node.js 项目代码
有多种方式上传代码:
方式1:使用 Git(推荐)
# 克隆你的项目(确保已推送到 GitHub/Gitee/自建 Git 仓库)
git clone https://github.com/yourname/your-node-project.git
cd your-node-project
# 安装依赖
npm install
方式2:本地打包上传(SCP)
# 在本地终端执行(非服务器)
scp -r ./your-node-project root@你的IP:/root/
然后在服务器上进入目录并 npm install
✅ 五、配置启动脚本和进程守护
Node.js 服务不能直接前台运行,需用进程管理工具防止崩溃退出。
使用 PM2(推荐)
# 全局安装 pm2
npm install -g pm2
# 启动你的服务(假设入口是 app.js 或 server.js)
pm2 start app.js --name "my-miniprogram-api"
# 设置开机自启
pm2 startup
pm2 save
常用命令:
pm2 status # 查看状态
pm2 logs # 查看日志
pm2 restart app # 重启
pm2 stop app # 停止
✅ 六、配置反向(Nginx,可选但推荐)
如果你希望使用域名 + 80/443 端口访问,建议使用 Nginx 反向。
1. 安装 Nginx
sudo apt update
sudo apt install nginx -y
2. 配置站点
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
写入以下内容(假设你的 Node 服务监听 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;
}
}
3. 测试并重启 Nginx
sudo nginx -t # 检查配置是否正确
sudo systemctl reload nginx
✅ 七、开放防火墙端口
在腾讯云控制台中:
- 进入「轻量服务器」→「防火墙」
- 添加规则:
- 端口:
80(HTTP)、443(HTTPS)、3000(若直接访问) - 协议:TCP
- 源 IP:0.0.0.0/0
- 端口:
✅ 八、绑定域名(可选)
- 购买域名(腾讯云域名注册)
- 进行 DNS 解析,将域名指向服务器公网 IP
- 可使用 Nginx + Let’s Encrypt 配置 HTTPS(推荐)
# 安装 Certbot
sudo apt install certbot python3-certbot-nginx -y
# 申请 SSL 证书
sudo certbot --nginx -d your-domain.com
✅ 九、测试访问
在浏览器或小程序中请求你的接口:
http://your-domain.com/api/user
或
http://你的IP:3000/api/user
确保后端返回正常数据。
✅ 十、后续维护建议
- 日志监控:
pm2 logs - 自动化部署:结合 GitHub Actions 或 Jenkins
- 数据库:如 MongoDB/MySQL,可部署在同一服务器或使用腾讯云数据库服务
- 备份:定期备份代码和数据
🎯 总结
| 步骤 | 内容 |
|---|---|
| 1 | 购买并登录轻量服务器 |
| 2 | 安装 Node.js 和 npm |
| 3 | 上传项目代码 |
| 4 | 安装 PM2 并启动服务 |
| 5 | 配置 Nginx 反向(可选) |
| 6 | 开放端口,绑定域名,启用 HTTPS |
如果你提供具体的项目结构(如 Express/Koa)、端口号、是否使用数据库等,我可以给出更精确的配置示例。
祝你部署顺利!🚀
CLOUD技术笔记