如何用python-onvif-zeep轻松管理你的ONVIF摄像头：完整实战指南

费琦栩

1134人浏览 · 2026-05-29 17:21:36

费琦栩 · 2026-05-29 17:21:36 发布

如何用python-onvif-zeep轻松管理你的ONVIF摄像头：完整实战指南

【免费下载链接】python-onvif-zeep ONVIF Client Implementation in Python 2+3 (using https://github.com/mvantellingen/python-zeep instead of suds as SOAP client) 项目地址: https://gitcode.com/gh_mirrors/py/python-onvif-zeep

想要快速上手ONVIF协议，轻松管理你的IP摄像头吗？python-onvif-zeep正是你需要的终极解决方案！这个强大的Python库让普通用户也能像专业人士一样操作各种兼容ONVIF的监控设备，无论你是安防系统管理员、智能家居爱好者，还是想要自动化管理摄像头的开发者，这个工具都能让你的工作变得异常简单。通过几行Python代码，你可以轻松连接到任何兼容ONVIF的设备，获取设备信息、配置参数，甚至远程控制摄像头操作。

🎯 项目速览：ONVIF协议的最佳Python实现

python-onvif-zeep是一个专门为ONVIF（开放网络视频接口论坛）设备设计的Python客户端实现。它基于现代化的zeep库（版本≥3.0.0），提供了一个简单易用的接口来与IP摄像头和其他视频监控设备进行交互。无论你是想要简化家庭监控，还是构建企业级安防系统，python-onvif-zeep都能为你提供强大的技术支撑。

📊 核心优势矩阵：为什么选择python-onvif-zeep

优势特性	具体说明	用户价值
现代化架构	基于zeep 3.0.0+构建，支持Python 2.7和Python 3.5+	兼容性强，维护性好
双参数传递	支持字典方式和类型实例化方式，自动参数验证	减少配置错误，提高开发效率
全面服务支持	覆盖ONVIF定义的所有核心服务，包括设备管理、媒体流、PTZ控制等	一站式解决摄像头管理需求
命令行工具	内置onvif-cli工具，支持交互模式和批处理模式	无需编程也能操作摄像头
时间同步容错	内置时间差调整功能，摄像头时间不同步也能正常认证	提高系统稳定性
自定义服务扩展	可以创建非官方服务，实现高度自定义需求	灵活应对特殊业务场景

🛠️ 实战应用指南：三大场景轻松上手

智能家居自动化控制

想象一下，用几行Python代码就能让家里的摄像头自动转动角度、调整焦距，甚至根据时间自动切换监控模式。python-onvif-zeep让这一切变得触手可及！

from onvif import ONVIFCamera
# 连接到摄像头
mycam = ONVIFCamera('192.168.0.112', 80, 'admin', '12345')

# 创建媒体服务
media_service = mycam.create_media_service()
profiles = media_service.GetProfiles()

# 获取第一个配置
token = profiles[0]._token
configurations_list = media_service.GetVideoSourceConfigurations()
video_source_configuration = configurations_list[0]

# 启用旋转功能
video_source_configuration.Extension[0].Rotate[0].Mode[0] = 'OFF'

企业安防系统批量管理

对于需要管理数十甚至上百个摄像头的企业来说，批量配置、统一管理和自动化运维变得异常简单。无需手动登录每个设备，一键完成所有配置。

# 批量设置摄像头主机名
cameras = [
    {'ip': '192.168.1.10', 'user': 'admin', 'pass': 'password1'},
    {'ip': '192.168.1.11', 'user': 'admin', 'pass': 'password2'},
    # ... 更多摄像头
]

for cam_info in cameras:
    cam = ONVIFCamera(cam_info['ip'], 80, cam_info['user'], cam_info['pass'])
    params = cam.devicemgmt.create_type('SetHostname')
    params.Hostname = f'Camera-{cam_info["ip"].split(".")[-1]}'
    cam.devicemgmt.SetHostname(params)

设备兼容性自动化测试

设备制造商可以用它来快速验证产品的ONVIF兼容性，确保设备符合行业标准，减少人工测试成本。

🚀 快速入门路线图：四步开启ONVIF之旅

第一步：环境准备与安装

首先确保你的系统已经安装了Python环境，然后通过以下方式安装python-onvif-zeep：

# 克隆仓库安装
git clone https://gitcode.com/gh_mirrors/py/python-onvif-zeep
cd python-onvif-zeep && python setup.py install

# 或者直接使用pip安装
pip install --upgrade onvif_zeep

第二步：基础连接与验证

连接到你的摄像头并进行基本操作验证：

from onvif import ONVIFCamera

# 初始化摄像头连接
mycam = ONVIFCamera('192.168.0.2', 80, 'user', 'passwd', '/etc/onvif/wsdl/')

# 获取设备信息
resp = mycam.devicemgmt.GetHostname()
print(f'摄像头主机名: {resp.Name}')

# 获取系统时间
dt = mycam.devicemgmt.GetSystemDateAndTime()
print(f'系统时间: {dt.UTCDateTime.Time.Hour}:{dt.UTCDateTime.Time.Minute}')

第三步：服务创建与使用

创建和使用不同的ONVIF服务：

# 创建PTZ服务（云台控制）
ptz_service = mycam.create_ptz_service()

# 创建媒体服务
media_service = mycam.create_media_service()

# 创建事件服务
events_service = mycam.create_events_service()

第四步：命令行工具体验

对于不熟悉编程的用户，可以使用内置的命令行工具：

# 单命令模式
onvif-cli devicemgmt GetHostname --user 'admin' --password '12345' --host '192.168.0.112'

# 交互模式
onvif-cli -u 'admin' -a '12345' --host '192.168.0.112' --port 80
ONVIF >>> cmd devicemgmt GetHostname

🔧 进阶功能探索：释放摄像头全部潜力

PTZ云台精确控制

实现摄像头的精确移动和变焦控制，支持八个方向的移动和连续跟踪：

def setup_ptz_control():
    mycam = ONVIFCamera('192.168.1.64', 80, 'admin', 'password')
    
    # 创建PTZ服务
    ptz = mycam.create_ptz_service()
    media = mycam.create_media_service()
    
    # 获取配置选项
    media_profile = media.GetProfiles()[0]
    request = ptz.create_type('GetConfigurationOptions')
    request.ConfigurationToken = media_profile.PTZConfiguration.token
    ptz_configuration_options = ptz.GetConfigurationOptions(request)
    
    # 创建移动请求
    positionrequest = ptz.create_type('AbsoluteMove')
    positionrequest.ProfileToken = media_profile.token
    
    return ptz, positionrequest, ptz_configuration_options

事件订阅与智能响应

设置事件订阅，实现智能化的监控响应：

# 创建事件服务
events_service = mycam.create_events_service()

# 获取事件属性
event_properties = events_service.GetEventProperties()

# 创建订阅
subscription_request = events_service.create_type('CreatePullPointSubscription')
subscription_response = events_service.CreatePullPointSubscription(subscription_request)

流媒体配置与管理

配置和管理摄像头的视频流：

# 获取媒体配置文件
profiles = media_service.GetProfiles()

# 获取流URI
stream_uri_request = media_service.create_type('GetStreamUri')
stream_uri_request.ProfileToken = profiles[0].token
stream_uri_request.StreamSetup.Stream = 'RTP-Unicast'
stream_uri_request.StreamSetup.Transport.Protocol = 'RTSP'
stream_uri = media_service.GetStreamUri(stream_uri_request)