Node微服务中配置Nginx实现媒体文件访问方案咨询

当前单服务器阶段（各微服务不同端口） #

核心思路是让Nginx直接静态托管媒体文件，绕过无图片服务能力的媒体微服务，既高效又简化架构：

1. 约定前端访问路径
   让前端统一以/media/files/作为图片请求的前缀（比如https://your-domain.com/media/files/2024/05/avatar.jpg）。

2. Nginx配置示例

   server {
       listen 80;
       server_name your-domain.com;
   
       # 代理主后端API请求
       location /api/ {
           proxy_pass http://localhost:主后端端口;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   
       # 静态托管媒体文件
       location /media/files/ {
           # 替换为媒体微服务实际的文件存储根目录（绝对路径）
           root /var/media-service/storage/;
           # 缓存配置：设置30天过期，减少重复请求
           expires 30d;
           add_header Cache-Control "public, immutable";
       }
   }
   

3. 关键权限配置
   确保Nginx进程对媒体存储目录有读取权限：

   • 设置目录权限为chmod 755 /var/media-service/storage/
   • 文件权限设置为chmod 644 /var/media-service/storage/**/*
   • 若媒体微服务用特定用户运行，可将Nginx用户（通常是www-data）加入该用户组：usermod -aG media-service-user www-data

后续Docker化+独立VPS部署阶段 #

当媒体微服务迁移到独立VPS时，有两种可行方案：

方案1：媒体VPS单独部署Nginx做静态服务 #

• 媒体VPS的Nginx配置：

  server {
      listen 80;
      server_name media.your-domain.com;
  
      location /files/ {
          root /var/media-service/storage/;
          expires 30d;
          add_header Cache-Control "public, immutable";
          # 可选：防盗链，仅允许主域名访问
          valid_referers your-domain.com;
          if ($invalid_referer) {
              return 403;
          }
      }
  }
  

• 主VPS的Nginx配置：
  将前端的媒体请求反向代理到媒体VPS的Nginx：

  server {
      listen 80;
      server_name your-domain.com;
  
      location /api/ {
          proxy_pass http://localhost:主后端容器端口;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
      }
  
      location /media/files/ {
          proxy_pass http://media.your-domain.com/files/;
          proxy_set_header Host media.your-domain.com;
          expires 30d;
          add_header Cache-Control "public, immutable";
      }
  }
  

方案2：使用共享存储（NFS） #

如果文件量不大，可在媒体VPS搭建NFS服务，将存储目录挂载到主VPS的Nginx容器/主机中，继续沿用单服务器阶段的静态托管配置，好处是前端访问路径无需变更。

核心注意事项 #

• 数据库存储路径要和Nginx配置匹配：比如数据库中存的是2024/05/avatar.jpg（相对存储根目录的路径），确保Nginx能通过root配置找到对应文件。
• 生产环境必须配置HTTPS：用Let's Encrypt免费证书，添加listen 443 ssl块，指定证书和密钥路径。
• 可按需添加图片处理：若后续需要缩放、格式转换，可集成Nginx的ngx_http_image_filter_module，直接在Nginx层完成图片处理，无需额外服务。

内容的提问来源于stack exchange，提问作者Frisbetarian-Support Palestine