Raspberry Pi 5 上Nginx配置需求：仅允许视频首帧/随机帧流式预览并开放完整下载权限

兄弟我太懂你这糟心事儿了！树莓派5虽然性能不错，但硬扛视频流确实容易把资源拉满搞崩系统，你要的「只能看单帧预览、不能播放但能完整下载」的需求，其实可以从前端页面控制和Nginx配置优化两方面配合实现，给你捋捋具体方案：

一、前端页面控制：让视频只停在指定帧，绝不播放 #

核心思路是用HTML5的video标签配合JS，阻止视频自动/手动播放，只允许用户拖动进度条加载对应帧后立刻暂停。这样浏览器只会请求当前时间点的视频片段，不会连续拉流占用资源。

给你个现成的代码示例，直接套进你的网页里就行：

<!-- 视频标签：保留进度条控件，但禁用自动播放，只预加载元数据 -->
<video controls autoplay="false" preload="metadata" width="640" height="360">
  <source src="/videos/your-video-file.mp4" type="video/mp4">
</video>

<script>
  const video = document.querySelector('video');
  // 拦截所有播放请求：用户点播放按钮直接无效
  video.addEventListener('play', (e) => {
    e.preventDefault();
    video.pause();
  });
  // 用户拖动进度条后，加载完对应帧立刻暂停
  video.addEventListener('seeked', () => {
    video.pause();
  });
</script>

这样操作下来，用户只能拖动进度条看任意时间点的帧，点播放按钮完全没反应，自然不会产生持续的流请求拖垮树莓派。

二、Nginx配置优化：稳准狠地控制资源占用 #

光有前端还不够，咱得给Nginx加层防护，确保既支持预览帧的Range请求，又能高效处理下载请求，同时防止意外的资源过载：

1. 先给全局HTTP块加基础优化，提升静态文件传输效率：

http {
  sendfile on;        # 启用零拷贝，减少CPU占用
  tcp_nopush on;      # 合并数据包发送，降低网络开销
  tcp_nodelay on;     # 低延迟传输，适合小请求
}

2. 针对视频文件的location块做专项配置：

location /videos {
  root /path/to/your/video-storage-folder;  # 替换成你的视频实际存储路径
  add_header Accept-Ranges bytes;           # 允许Range请求（加载单帧必须要这个）
  # 设置缓存策略，让浏览器缓存视频元数据，减少重复请求
  expires 1d;
  add_header Cache-Control "public, max-age=86400";
  # 可选：限制请求频率，防止短时间内大量请求压垮Pi
  limit_req zone=video burst=5 nodelay;
}

3. 如果加了请求频率限制，记得在HTTP块里提前定义对应的限制zone：

http {
  # 定义一个名为video的限制区：每个IP每秒最多1次请求，缓冲区10M
  limit_req_zone $binary_remote_addr zone=video:10m rate=1r/s;
}

三、额外小技巧：提前生成缩略图，进一步减负 #

要是想让预览更丝滑，还可以用ffmpeg给所有视频批量生成缩略图，放在视频列表页。用户先看缩略图筛选，再点进详情页看具体帧，能大幅减少树莓派的临时请求压力。

批量生成缩略图的命令（SSH连进Pi里执行）：

cd /path/to/your/video-storage-folder
for file in *.mp4; do
  # 提取视频第5秒的帧作为缩略图
  ffmpeg -i "$file" -ss 00:00:05 -vframes 1 "${file%.mp4}.jpg"
done

之后把这些jpg缩略图放到视频列表里，用户体验会更好。

这样一套组合拳下来，既能满足大家看帧选视频的需求，又能开放完整下载权限，还不会让树莓派过载搞崩系统，完美适配你的场景～

备注：内容来源于stack exchange，提问作者Edw590