WebDAV / FTP 存储

适用于 MiBeeNvr v0.14.0

MiBee NVR 内置 WebDAV 和 FTP 服务器,支持只读或读写模式访问录像文件。

功能对比

特性 WebDAV FTP
协议 HTTP/HTTPS FTP
加密 ✅ 支持 TLS ✅ 支持 FTPS
浏览器访问 ✅ ❌
命令行工具 ✅ rclone / curl ✅ ftp / lftp
文件管理器 ✅ 原生支持 ✅ 需要 FTP 客户端
传输效率 中等 高(二进制模式)

WebDAV 配置

启用 WebDAV

webdav:
  enabled: true
  read_write: false               # false=只读,true=读写
  port: 9090                      # 默认与 HTTP 共享端口
  path: "/dav"                    # WebDAV 路径

只读模式(默认)

只读模式下,WebDAV 只能浏览和下载录像,无法删除:

webdav:
  enabled: true
  read_write: false

读写模式

启用读写模式后,可以通过 WebDAV 管理录像文件:

webdav:
  enabled: true
  read_write: true

警告:读写模式允许删除录像文件。请谨慎使用。

访问 WebDAV

# 浏览器访问
# 打开 https://你的NVR地址:9090/dav/

# rclone 挂载
rclone mount nvr:/ /mnt/nvr --vfs-cache-mode full

# curl 下载
curl -u admin:password \
  "http://192.168.1.50:9090/dav/recordings/front-door/2026-08-18/00-00-00.mp4" \
  -o recording.mp4

rclone 配置

# ~/.config/rclone/rclone.conf
[nvr]
type = webdav
url = http://192.168.1.50:9090/dav/
vendor = other
user = admin
pass = your-password

文件管理器挂载

操作系统 方法
Windows 映射网络驱动器 → \\192.168.1.50@9090\dav
macOS Finder → 前往 → 连接服务器 → http://192.168.1.50:9090/dav/
Linux 文件管理器 → 位置 → 其他位置 → davs://192.168.1.50:9090/dav/

FTP 配置

启用 FTP

ftp:
  enabled: true
  port: 2121
  read_write: false               # false=只读,true=读写
  max_connections: 10             # 最大并发连接

只读模式(默认)

ftp:
  enabled: true
  port: 2121
  read_write: false

读写模式

ftp:
  enabled: true
  port: 2121
  read_write: true

访问 FTP

# 命令行 FTP
ftp 192.168.1.50 2121
# 用户名:admin
# 密码:your-password

# lftp(支持递归下载)
lftp -u admin,password 192.168.1.50:2121
mirror --reverse /recordings/front-door/ ./local-folder/

# WinSCP / FileZilla
# 主机:192.168.1.50
# 端口:2121
# 用户名:admin
# 密码:your-password

目录结构

WebDAV 和 FTP 访问的目录结构:

flowchart TB
  ROOT["/"] --> REC["recordings/<br/>录像文件"]
  ROOT --> SNAP["snapshots/<br/>快照图片(如果启用)"]
  ROOT --> TL["timelapse/<br/>延时摄影视频(如果启用)"]
  REC --> C1["front-door/<br/>摄像头 ID"]
  REC --> C2["driveway/<br/>…"]
  C1 --> D1["2026-08-18/<br/>日期目录"]
  C1 --> D2["2026-08-17/<br/>…"]
  D1 --> F1["00-00-00.mp4<br/>录像片段"]
  D1 --> F2["00-01-00.mp4"]
  D1 --> E["…"]

安全配置

TLS 加密

WebDAV 支持 HTTPS:

webdav:
  enabled: true
  tls:
    enabled: true
    cert_file: "/path/to/cert.pem"
    key_file: "/path/to/key.pem"

FTPS 加密

FTP 支持 FTPS(FTP over TLS):

ftp:
  enabled: true
  tls:
    enabled: true
    cert_file: "/path/to/cert.pem"
    key_file: "/path/to/key.pem"

访问控制

限制特定 IP 访问:

webdav:
  enabled: true
  allowed_ips:
    - "192.168.1.0/24"            # 只允许局域网访问
    - "10.0.0.0/8"

ftp:
  enabled: true
  allowed_ips:
    - "192.168.1.0/24"

常见问题

WebDAV 无法连接

  1. 认证失败:确认用户名和密码正确
  2. 路径错误:WebDAV 路径通常是 /dav/(注意末尾斜杠)
  3. TLS 证书:如果使用自签名证书,客户端需要信任该证书
  4. 防火墙:确保端口 9090 已开放

FTP 无法连接

  1. 被动模式:某些防火墙需要 FTP 被动模式
  2. 端口:默认 FTP 端口是 2121(不是 21)
  3. 认证失败:确认用户名和密码正确
  4. 防火墙:确保端口 2121 已开放

传输速度慢

  • WebDAV:HTTP 开销较大,适合小文件
  • FTP:二进制模式传输效率更高
  • 建议:大文件传输使用 FTP,小文件或浏览使用 WebDAV

文件删除后录像消失

  • 如果 read_write: true,WebDAV 和 FTP 可以删除录像
  • 建议保持只读模式(read_write: false)
  • 如需删除录像,请通过 Web UI 操作

性能优化

并发连接

webdav:
  max_connections: 20

ftp:
  max_connections: 10

缓存配置

webdav:
  cache:
    enabled: true
    max_size: "1G"                 # 缓存大小
    ttl: "5m"                      # 缓存过期时间

下一步