1. 从零开始理解EasyNVR的Docker部署
第一次接触EasyNVR的Docker部署时，我完全被各种参数和挂载选项搞晕了。经过多次实践和踩坑，终于摸清了其中的门道。Docker部署最大的优势在于环境隔离和快速部署，但对于监控视频流这种需要持久化数据的场景，挂载配置就显得尤为重要。
旧版部署方式虽然简单，但存在明显的数据丢失风险。我记得有一次客户升级服务时，因为只挂载了部分目录，导致授权文件丢失，整个系统无法使用。这种教训让我深刻理解了数据持久化的重要性。
2. Docker部署方式详解
2.1 旧版Docker部署解析
让我们先拆解旧版的Docker命令：
bash复制docker run -d \
--name easynvr \
--restart always \
--network host \
--log-opt max-size=50M \
-v "$PWD/configs:/app/configs" \
-v "$PWD/logs:/app/logs" \
-v "$PWD/temporary:/app/temporary" \
-v "$PWD/r:/app/r" \
-v "$PWD/stream:/app/stream" \
registry.cn-shanghai.aliyuncs.com/rustc/easynvr_amd64:latest
这个命令有几个关键点需要注意：
-
网络模式：使用
--network host让容器直接使用宿主机网络栈，省去了端口映射的麻烦。这对于需要大量端口的视频监控服务特别重要。 -
数据持久化：通过
-v参数挂载了五个目录：- configs：配置文件
- logs：日志文件
- temporary：临时文件
- r：运行时数据
- stream：视频流数据
重要提示：这种部分挂载的方式存在严重缺陷。任何未挂载目录中的数据（如extensions插件目录）都会在容器重建时丢失。
2.2 新版Docker部署改进
新版部署命令做了重要改进：
bash复制docker run -d \
--name easynvr \
--restart always \
--network host \
--log-opt max-size=50M \
-v "$(pwd)":/app \
-v "$(pwd)/r:/app/r" \
-v /vol1/1000/CloudDrive2/Video/redis:/app/video \
registry.cn-shanghai.aliyuncs.com/rustc/easynvr_amd64:latest
主要变化是：
- 挂载整个当前目录到容器内的/app目录，确保所有文件都能持久化
- 单独挂载r目录，保持兼容性
- 显式指定视频存储路径
这种改进解决了旧版的几个痛点：
- 插件目录(extensions)现在会被自动持久化
- 授权文件(private.pem)不会丢失
- 所有配置文件都能得到保留
2.3 实际升级操作指南
升级到新版部署非常简单：
- 停止并删除旧容器：
bash复制docker stop easynvr && docker rm easynvr
-
确保所有重要数据都已备份
-
执行新版docker run命令
-
验证服务是否正常运行
经验分享：升级前建议先修改某个配置项（如端口号），升级后检查该配置是否生效，这样可以确认配置继承是否成功。
3. 二进制部署转Docker部署
3.1 为什么要转换
传统二进制部署方式有几个明显缺点：
- 需要手动管理服务启停
- 依赖特定系统环境
- 升级过程复杂
- 在NAS设备上管理不便
而Docker部署可以：
- 通过图形界面管理服务
- 环境隔离，避免依赖冲突
- 一键升级
- 更好的可移植性
3.2 转换方法一：直接执行Docker命令
这是最简单的转换方式：
- 停止原有的二进制服务
- 修改配置文件中的某个参数（如端口号）用于验证
- 在部署目录下执行新版docker run命令
关键点：
- 使用
-v "$(pwd)":/app挂载整个目录 - 保持
--network host模式 - 确保视频存储路径正确
3.3 转换方法二：使用Docker Compose
对于更复杂的部署场景，推荐使用docker-compose.yml文件：
yaml复制services:
app:
image: registry.cn-shanghai.aliyuncs.com/rustc/easynvr_amd64:latest
restart: always
network_mode: host
logging:
options:
max-size: "50M"
volumes:
- ./:/app
- ./r:/app/r
- /vol1/1000/CloudDrive2/Video/redis:/app/video
使用步骤：
- 创建docker-compose.yml文件
- 执行
docker compose pull && docker compose up -d - 验证服务是否正常
专业建议：对于生产环境，建议使用指定版本标签而非latest，避免意外升级导致兼容性问题。
4. 常见问题与解决方案
4.1 授权文件处理
问题：从二进制部署转换到Docker后，文件授权方式可能会失效。
解决方案：
- 重新下载授权文件
- 确保文件放在挂载目录中
- 检查文件权限是否正确
4.2 视频存储路径
问题：视频文件存储位置不正确或权限不足。
解决方案：
- 确保挂载的视频目录存在
- 检查目录权限：
bash复制chmod -R 777 /path/to/video
- 确认存储路径在配置文件中正确设置
4.3 端口冲突
问题：服务启动后无法访问。
排查步骤：
- 检查端口是否被占用：
bash复制netstat -tulnp | grep <端口号>
- 确认防火墙设置
- 验证网络模式是否为host
4.4 性能优化建议
-
对于高负载环境，建议：
- 使用SSD存储视频文件
- 增加日志轮转频率
- 考虑使用单独的磁盘挂载视频目录
-
监控容器资源使用情况：
bash复制docker stats easynvr
5. 高级部署技巧
5.1 多实例部署
有时需要部署多个EasyNVR实例，可以通过以下方式实现：
- 为每个实例创建独立目录
- 修改docker-compose.yml中的：
- 容器名称(--name)
- 外部端口(如果不用host模式)
- 挂载路径
示例：
yaml复制services:
easynvr1:
image: registry.cn-shanghai.aliyuncs.com/rustc/easynvr_amd64:4.2.1
container_name: easynvr1
ports:
- 10001:10000
volumes:
- ./instance1:/app
easynvr2:
image: registry.cn-shanghai.aliyuncs.com/rustc/easynvr_amd64:4.2.1
container_name: easynvr2
ports:
- 10002:10000
volumes:
- ./instance2:/app
5.2 备份与恢复
完善的备份策略应该包括：
- 配置文件备份：
bash复制cp -r /path/to/deploy /backup/location
-
数据库备份（如果使用外部数据库）
-
视频文件备份（建议使用rsync）
恢复时只需将备份文件放回原位置，重新启动容器即可。
5.3 版本升级流程
安全的升级步骤：
- 备份当前部署目录
- 停止并删除旧容器
- 拉取新版本镜像
- 启动新容器
- 验证服务是否正常
重要提示：大版本升级前，务必检查官方升级说明，了解可能的破坏性变更。
6. 监控与维护
6.1 日志管理
有效的日志管理策略：
- 使用
--log-opt max-size=50M限制日志大小 - 定期清理旧日志：
bash复制find /path/to/logs -type f -name "*.log" -mtime +7 -delete
- 对重要日志设置监控告警
6.2 资源监控
推荐监控指标：
- CPU使用率
- 内存占用
- 磁盘空间
- 网络带宽
可以使用cAdvisor或Prometheus等工具实现容器监控。
6.3 定期维护任务
- 每月检查一次存储空间
- 每季度验证备份可用性
- 关注安全公告，及时更新补丁
在实际部署中，我发现很多问题都是由于挂载配置不当引起的。特别是在从二进制部署迁移到Docker时，一定要确保所有必要的目录都正确挂载。曾经有个客户因为漏挂了plugins目录，导致智能分析功能完全失效，花了我们两天时间才排查出来。