python的轻量级upnp客户端库。
UPn的Python项目详细描述
upnpy
python的轻量级upnp客户端库。
示例
获取Internet Gateway Device：
的外部IP地址>>>importupnpy>>>upnp=upnpy.UPnP()>>>>>>devices=upnp.discover()# Discover UPnP devices on the network>>>devices[Device<BroadcomADSLRouter>]>>>>>>device=upnp.get_igd()# Select the IGD>>># Or alternatively>>>device=devices[0]>>>>>>device.get_services()# Get the services available for this device[<Service(Layer3Forwarding)id="Layer3Forwarding.1">,<Service(WANCommonInterfaceConfig)id="WANCommonInterfaceConfig.1">,<Service(WANPPPConnection)id="WANPPPConnection.1">]>>>>>># We can now access a specific service on the device by its ID>>># The IDs for the services in this case contain illegal values so we can't access it by an attribute>>># so we access it like a dictionary instead.>>>device['WANPPPConnection.1']<Service(WANPPPConnection)id="WANPPPConnection.1">>>># Get the actions available for the service>>>device['WANPPPConnection.1'].get_actions()[<Actionname="SetConnectionType">,<Actionname="GetConnectionTypeInfo">,<Actionname="RequestConnection">,<Actionname="ForceTermination">,<Actionname="GetStatusInfo">,<Actionname="GetNATRSIPStatus">,<Actionname="GetGenericPortMappingEntry">,<Actionname="GetSpecificPortMappingEntry">,<Actionname="AddPortMapping">,<Actionname="DeletePortMapping">,<Actionname="GetExternalIPAddress">]>>>device['WANPPPConnection.1'].GetExternalIPAddress()# Finally, get the external IP address{'NewExternalIPAddress':'xxx.xxx.xxx.xxx'}
将新端口映射添加到Internet Gateway Device：
>>>importupnpy>>>upnp=upnpy.UPnP()>>>>>>devices=upnp.discover()# Discover UPnP devices on the network>>>devices[Device<BroadcomADSLRouter>]>>>>>>device=upnp.get_igd()# Select the IGD>>># Or alternatively>>>device=devices[0]>>>>>>device.get_services()# Get the services available for this device[<Service(Layer3Forwarding)id="Layer3Forwarding.1">,<Service(WANCommonInterfaceConfig)id="WANCommonInterfaceConfig.1">,<Service(WANPPPConnection)id="WANPPPConnection.1">]>>>>>># We can now access a specific service on the device by its ID>>># The IDs for the services in this case contain illegal values so we can't access it by an attribute>>># so we access it like a dictionary instead.>>>device['WANPPPConnection.1']<Service(WANPPPConnection)id="WANPPPConnection.1">>>># Get the actions available for the service>>>device['WANPPPConnection.1'].get_actions()[<Actionname="SetConnectionType">,<Actionname="GetConnectionTypeInfo">,<Actionname="RequestConnection">,<Actionname="ForceTermination">,<Actionname="GetStatusInfo">,<Actionname="GetNATRSIPStatus">,<Actionname="GetGenericPortMappingEntry">,<Actionname="GetSpecificPortMappingEntry">,<Actionname="AddPortMapping">,<Actionname="DeletePortMapping">,<Actionname="GetExternalIPAddress">]>>>device['WANPPPConnection.1'].AddPortMapping<Actionname="AddPortMapping">>>>>>># Lets see what arguments the action accepts>>># (use the get_output_arguments() method for a list of output arguments)>>>device['WANPPPConnection.1'].AddPortMapping.get_input_arguments()[{'name':'NewRemoteHost','data_type':'string','allowed_value_list':[]},{'name':'NewExternalPort','data_type':'ui2','allowed_value_list':[]},{'name':'NewProtocol','data_type':'string','allowed_value_list':['TCP','UDP']},{'name':'NewInternalPort','data_type':'ui2','allowed_value_list':[]},{'name':'NewInternalClient','data_type':'string','allowed_value_list':[]},{'name':'NewEnabled','data_type':'boolean','allowed_value_list':[]},{'name':'NewPortMappingDescription','data_type':'string','allowed_value_list':[]},{'name':'NewLeaseDuration','data_type':'ui4','allowed_value_list':[]}]>>>>>># Yikes, lets pretty print that :)>>>importjson>>>print(json.dumps(device['WANPPPConnection.1'].AddPortMapping.get_input_arguments(),indent=4))[{"name":"NewRemoteHost","data_type":"string","allowed_value_list":[]},{"name":"NewExternalPort","data_type":"ui2","allowed_value_list":[]},{"name":"NewProtocol","data_type":"string","allowed_value_list":["TCP","UDP"]},{"name":"NewInternalPort","data_type":"ui2","allowed_value_list":[]},{"name":"NewInternalClient","data_type":"string","allowed_value_list":[]},{"name":"NewEnabled","data_type":"boolean","allowed_value_list":[]},{"name":"NewPortMappingDescription","data_type":"string","allowed_value_list":[]},{"name":"NewLeaseDuration","data_type":"ui4","allowed_value_list":[]}]>>># Finally, add the new port mapping to the IGD>>>device['WANPPPConnection.1'].AddPortMapping(...NewRemoteHost='',...NewExternalPort=80,...NewProtocol='TCP',...NewInternalPort=8000,...NewInternalClient='192.168.1.3',...NewEnabled=1,...NewPortMappingDescription='Test port mapping entry from UPnPy.',...NewLeaseDuration=0...){}
文档
文档可在https://upnpy.readthedocs.io/en/latest/
许可证
这个项目是根据MIT License的条款授权的。
欢迎加入QQ群-->： 979659372
