pynetgear：简单易用的Netgear路由器管理工具

pynetgear：简单易用的Netgear路由器管理工具

pynetgearPython library to control Netgear wireless routers through the SOAP-api.项目地址:https://gitcode.com/gh_mirrors/py/pynetgear

项目介绍

pynetgear 是一个用 Python 编写的轻量级库，旨在简化与 Netgear 路由器交互的过程。它提供了一个直观的 API，允许用户执行常见的网络管理任务，如查看连接设备、设置家长控制、管理访问时间等，无需深入了解复杂的路由器配置界面或直接操作低级别的 Telnet/HTTP 请求。

该项目通过封装认证过程和API请求，大大降低了普通用户和技术人员在日常网络管理中的门槛，使得非专业用户也能轻松实现对自家网络环境的有效管控。

项目快速启动

首先，确保你的环境中安装了Python。然后，可以通过pip安装pynetgear库：

pip install pynetgear

初始化并连接到你的Netgear路由器，需要路由器的登录凭据：

from pynetgear import Netgear

password = "your_router_password"
router_ip = "your_router_ip"

# 初始化路由器对象
router = Netgear(password=password, router_ip=router_ip)
# 连接到路由器
router.login()

获取当前连接的设备列表示例：

devices = router.getAttachedDevices()
for device in devices:
    print(device['mac'], device['name'])

别忘了，在完成操作后安全退出：

router.logout()

应用案例和最佳实践

设备监控

定期检查网络上连接的设备，可以用于家庭网络安全监控，及时发现未知设备接入：

import time

while True:
    devices = router.getAttachedDevices()
    for device in devices:
        print(f"{time.strftime('%Y-%m-%d %H:%M:%S')}: {device['mac']} - {device['name']}")
    time.sleep(60)  # 每分钟检查一次

家长控制自动化

根据预设的时间表自动开启或关闭特定设备的互联网访问：

import datetime

def set_device_access(mac_address, enable=True):
    router.setAccessControl(mac_address, enable)

# 示例：晚上8点禁用儿童平板的网络
if datetime.datetime.now().hour == 20:
    set_device_access("child_tablet_mac", False)

典型生态项目

虽然pynetgear本身作为一个独立项目运作，其在家庭自动化场景中与其他智能家居系统（如Home Assistant）集成，可视为一种典型的生态扩展。通过脚本或者集成服务，可以将网络管理功能编织进更广泛的家庭自动化逻辑之中，例如结合定时任务或基于事件触发的网络策略调整，增强家庭网络的智能化和安全性。

由于是示例性说明，具体生态项目的实例化需依据实际应用场景，利用pynetgear作为底层工具，开发者可以在家庭自动化平台中定制相应的自动化规则，以满足个性化的网络管理需求。

请注意，使用过程中应遵循个人数据保护原则，妥善保管路由器密码，并合理使用权限，避免隐私泄露或误操作导致的网络故障。

pynetgearPython library to control Netgear wireless routers through the SOAP-api.项目地址:https://gitcode.com/gh_mirrors/py/pynetgear