在 AWS Lightsail 上运行 Node API

选择蓝图、规格和区域

在 AWS 控制台中打开 Lightsail（注意：它有独立的控制台地址 lightsail.aws.amazon.com，与主 AWS 控制台分开——功能相同，URL 不同）。点击 Create instance（创建实例）：

• Instance location（实例位置）：选择离你用户最近的区域。如果不确定，us-east-1 是个稳妥的默认选项。
• Platform（平台）：Linux/Unix。
• Blueprint（蓝图）：有两个合理选项。"Node.js" 预装了 Node、npm、nginx 和 PM2。"OS Only → Ubuntu 22.04" 是干净的裸系统，需要你自行安装 Node。追求速度就选 Node.js 蓝图；想要干净的起点就选 Ubuntu。
• Instance plan（实例套餐）：$5/月（512 MB 内存、1 vCPU、20 GB SSD、1 TB 流量）足以应对小型 Node API。如果觉得不放心，$10/月可以翻倍资源。
• Name（名称）：类似 mybrand-api-prod 这样的命名。

点击 Create。实例在 60–90 秒内启动完毕。Lightsail 会分配一个公网 IP 和内部名称。新账号在 AWS 免费套餐下，第一个月免费。

浏览器 SSH 或本地密钥，任选其一

两种方式：

• 浏览器 SSH：进入实例页面 → 点击 Connect using SSH。终端会在新标签页打开。无需配置，能穿透企业防火墙，但不保留滚动历史，复制粘贴也不方便。
• 本地 SSH：下载默认密钥（Account → SSH keys → Default → Download）。保存到 ~/.ssh/lightsail.pem，执行 chmod 600 ~/.ssh/lightsail.pem，然后：

  ssh -i ~/.ssh/lightsail.pem bitnami@<PUBLIC_IP>
  # Node.js 蓝图的用户名是 bitnami，Ubuntu 蓝图的用户名是 ubuntu。

登录成功后，Node.js 蓝图的主目录下会有 /opt/bitnami/，里面包含 nginx 和预置的 Node 示例应用。

git clone 或 rsync，两种方式都可以

# 方式 A：git clone（公开仓库或使用 deploy key）
cd ~
git clone https://github.com/you/your-api.git
cd your-api
npm ci --production
# 在 /etc/environment 或应用读取的 .env 文件中设置环境变量。

# 方式 B：从本地用 rsync 推送（服务器无法访问 git）
# 在本地执行：
rsync -avz --exclude node_modules \
  -e "ssh -i ~/.ssh/lightsail.pem" \
  ./ bitnami@<PUBLIC_IP>:/home/bitnami/your-api/
# 然后在服务器上执行：
cd ~/your-api
npm ci --production

先手动测试一下：执行 node server.js（或你的入口文件），确认应用能正常启动并监听端口——通常是 3000 或 8080。停止它（Ctrl+C）；下一步我们会让它持续运行。

崩溃自动重启，重启后自动恢复

Node.js 蓝图已预装 PM2。若使用纯 Ubuntu 蓝图，执行：sudo npm i -g pm2。

cd ~/your-api
pm2 start server.js --name api
pm2 save
pm2 startup
# pm2 startup 会打印一条命令——以 root 身份执行它，
# 将 PM2 注册为 systemd 服务，使其在重启后自动恢复。

现在你的 API 已在 http://<PUBLIC_IP>:3000（或你应用监听的端口）上运行。测试一下：

curl http://<PUBLIC_IP>:3000/health
# 目前会超时——防火墙还没放行。那是第 5 步的内容。

常用 PM2 命令：pm2 logs api（实时日志）、pm2 restart api、pm2 monit（交互式监控面板）。

两个端口：80 用于 HTTP，443 用于 HTTPS

Lightsail 防火墙默认只开放 SSH（22 端口），其余全部屏蔽。开放 Web 端口：

1. 进入 Lightsail 控制台 → 你的实例 → Networking 标签页。
2. 在 IPv4 Firewall 下，点击 Add rule。
3. 添加：Application = HTTP，Port = 80。再添加：Application = HTTPS，Port = 443。
4. 保存。

不要直接将 3000 端口暴露到公网——nginx 会在你的 Node 应用前面监听 80/443 端口（蓝图已预装并运行 nginx），并将请求代理转发给 Node 进程。从本地执行 curl http://<PUBLIC_IP>，应该能看到默认的 nginx 页面或蓝图示例应用。

编辑一个文件，重载 nginx

在 Node.js 蓝图上，nginx 配置位于 /opt/bitnami/nginx/conf/server_blocks/。在该目录创建一个文件：

sudo nano /opt/bitnami/nginx/conf/server_blocks/api.conf

粘贴以下内容：

server {
    listen 80;
    server_name api.mybrand.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        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;
    }
}

重载：sudo /opt/bitnami/ctlscript.sh restart nginx。现在 nginx 已将 api.mybrand.com:80 的请求代理到 127.0.0.1:3000 上的 Node 进程。

没有静态 IP，停机重启后 IP 会变

Lightsail 的默认 IP 是"动态"的——重启能保留，但关机重开后会变。绑定真实域名需要一个固定不变的静态 IP：

1. Lightsail → Networking（顶部标签页，不是实例内的那个）→ Create static IP。
2. 选择与实例相同的区域，然后附加到该实例。
3. 附加期间免费；一旦解绑但未使用，则按 $0.005/小时（约 $3.65/月）计费。这是 Lightsail 唯一容易踩坑的计费项。

现在将你的域名指向静态 IP。在 Route 53（或你的 DNS 服务商）中：创建一条 A 记录，名称填 api，值填你的静态 IP。DNS 教程涵盖了各类 DNS 记录的通用说明；这里是最直接的 A 记录场景。

Bitnami 内置了一键申请脚本

在 Node.js 蓝图上，certbot 已预装。SSH 登录后执行：

sudo /opt/bitnami/bncert-tool

该工具会询问你的域名、邮箱，以及是否启用 HTTP 转 HTTPS 重定向。选择启用重定向。它会自动修改 nginx 配置、签发证书并设置自动续期。整个过程两分钟，无需手动编辑 nginx。

若使用纯 Ubuntu 蓝图（无 Bitnami）：执行 sudo apt install certbot python3-certbot-nginx，然后 sudo certbot --nginx -d api.mybrand.com --redirect。效果相同，步骤稍多。

测试：curl -I https://api.mybrand.com/health。你应该看到 HTTP/2 200（或你的健康检查接口返回的状态码）。HTTP→HTTPS 重定向已生效；证书通过 cron 任务每 90 天自动续期。