Node.js 倒计时图片服务部署与 Nginx 反向代理实战总结

Node.js 倒计时图片服务部署与 Nginx 反向代理实战总结

场景描述

我们希望实现一个倒计时图片接口，供邮件等外部平台引用，如：

https://your-domain.com/countdown/countdown.png?end=2025-09-30T00:00:00

通过访问该链接生成实时倒计时 PNG 图，用于促销活动倒计时展示。

技术栈与组件

• Node.js + Express
• canvas 模块绘制 PNG
• Nginx 反向代理（启用 HTTPS）
• Let’s Encrypt 免费 SSL 证书
• curl 用于调试

Node.js 服务核心逻辑

监听路径：

app.get('/countdown/countdown.png', (req, res) => { ... })

监听端口：

app.listen(7897, '0.0.0.0', () => {
  console.log(`Countdown image server running`);
});

遇到的问题

1. curl 本地访问正常，但通过 nginx 转发返回 404

• http://127.0.0.1:7897/countdown/countdown.png?... → 正常返回图片
• https://182.92.100.57/countdown/countdown.png?... → 404 Not Found（nginx）

问题排查过程

检查点 1：Node 是否监听公网（0.0.0.0）

app.listen(7897, '0.0.0.0')

否则 nginx 无法连接 127.0.0.1:7897（仅限本地）

检查点 2：Nginx location 匹配是否命中

原配置示例（错误）：

location /countdown/ {
    proxy_pass http://127.0.0.1:7897/countdown/;
}

此配置导致路径变成：

http://127.0.0.1:7897/countdown/countdown.png → 实际访问 /countdown/countdown/countdown.png ❌

最终解决方案

正确 Nginx 配置示例

location ^~ /countdown/ {
    proxy_pass http://127.0.0.1:7897;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    # 可选：禁止缓存，确保每次图片实时更新
    add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0";
}

关键点总结：

成功效果

访问：

https://your-domain.com/countdown/countdown.png?end=2025-09-30T00:00:00

返回状态码：

200 OK
Content-Type: image/png

可嵌入邮箱、网页、推广活动页面等使用。

优化

测试命令

curl -v "https://your-domain.com/countdown/countdown.png?end=2025-09-30T00:00:00" --insecure

Node 服务快速启动脚本（如 pm2）

pm2 start countdown-server.js --name countdown-server