在腾讯云轻量应用服务器(Lighthouse)上部署 Node.js 接口是一个常见且实用的场景。下面是一步一步的详细教程,帮助你完成部署。
✅ 一、准备工作
1. 购买腾讯云轻量应用服务器
- 登录 腾讯云控制台
- 进入 轻量应用服务器 Lighthouse
- 创建实例:
- 地域:选择离用户近的(如广州、上海)
- 镜像:推荐选择 Ubuntu 20.04 / 22.04 或 CentOS 7/8
- 套餐:根据需求选择(1核2G起步足够测试)
- 设置登录方式:建议使用密钥对或密码登录
记下公网 IP 地址,后续要用。
✅ 二、连接到服务器
使用 SSH 连接(Windows 可用 PuTTY 或 WSL,Mac/Linux 直接终端):
ssh root@你的公网IP
# 或者如果用户名不是 root
ssh ubuntu@你的公网IP # Ubuntu 系统默认用户是 ubuntu
输入密码或使用私钥登录。
✅ 三、安装 Node.js 和 npm
方法一:使用 nvm 安装(推荐)
# 安装 nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置
source ~/.bashrc
# 安装最新 LTS 版本的 Node.js
nvm install 18 # 或 20
nvm use 18
验证安装:
node -v # 应输出 v18.x.x
npm -v # 输出版本号
✅ 四、上传你的 Node.js 项目
方式 1:使用 Git(推荐)
如果你的项目在 GitHub/Gitee 上:
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/
然后在服务器进入目录:
cd /root/your-node-project
npm install
✅ 五、启动 Node.js 服务
假设你的入口文件是 app.js
或 server.js
:
node app.js
但这样关闭终端后服务会停止,所以需要使用进程管理工具。
✅ 六、使用 PM2 守护进程(推荐)
安装 PM2:
npm install -g pm2
启动项目:
pm2 start app.js --name "my-api"
常用命令:
pm2 list # 查看运行中的进程
pm2 logs my-api # 查看日志
pm2 restart my-api
pm2 stop my-api
pm2 startup # 开机自启(按提示执行生成的命令)
✅ 七、配置防火墙和端口
1. 在腾讯云控制台开放端口
- 进入轻量服务器管理页面
- 找到「防火墙」设置
- 添加规则:允许 自定义 TCP 端口,比如
3000
(你的 Node 服务端口)
注意:不要暴露 22、3306 等敏感端口给 0.0.0.0/0
2. 确保 Node 服务监听 0.0.0.0
在代码中:
app.listen(3000, '0.0.0.0', () => {
console.log('Server running on port 3000');
});
✅ 八、(可选)使用 Nginx 反向X_X
1. 安装 Nginx
sudo apt update
sudo apt install nginx -y
2. 配置反向X_X
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
修改 location /
部分:
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 restart nginx
现在你可以通过 http://你的IP
访问接口,无需加端口号。
✅ 九、域名绑定(可选)
- 在腾讯云购买域名
- 解析域名到服务器公网 IP
- 修改 Nginx 配置
server_name yourdomain.com;
- 可配合 SSL(使用 Let’s Encrypt + Certbot)
✅ 十、总结流程
步骤 | 操作 |
---|---|
1 | 购买轻量服务器,选择 Linux 镜像 |
2 | SSH 登录服务器 |
3 | 安装 Node.js(推荐 nvm) |
4 | 上传项目代码(Git 或 SCP) |
5 | npm install 安装依赖 |
6 | 使用 PM2 启动并守护进程 |
7 | 腾讯云防火墙放行端口(如 3000) |
8 | (推荐)用 Nginx 反向X_X,提升安全性和访问体验 |
✅ 完成!你现在可以通过 http://你的IP:3000
或 http://你的域名
访问你的 Node.js 接口了。
如有具体问题(如报错、无法访问等),欢迎提供细节,我可以进一步帮你排查。