`ipaddress.md`

278 строк · 17.7 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.15/howto/ipaddress.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Введение в модуль ipaddress89Обзор1011Этот документ представляет собой мягкое введение в модуль [`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress). Он предназначен в первую очередь для пользователей, которые ещё не знакомы с терминологией IP-сетей, но может также быть полезен сетевым инженерам, желающим получить обзор того, как `ipaddress` представляет концепции IP-адресации.1213## Создание объектов адресов/сетей/интерфейсов1415Поскольку [`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress) – это модуль для проверки и управления IP-адресами, первое, что нужно сделать – создать несколько объектов. Можно использовать `ipaddress` для создания объектов из строк и целых чисел.1617### Замечание о версиях IP1819Для читателей, не особенно знакомых с IP-адресацией, важно знать, что в настоящее время происходит переход с версии 4 протокола Internet Protocol (IP) на версию 6. Этот переход происходит в значительной степени потому, что версия 4 протокола не предоставляет достаточного количества адресов для удовлетворения потребностей всего мира, особенно с учётом растущего числа устройств, имеющих прямое подключение к интернету.2021Объяснение деталей различий между двумя версиями протокола выходит за рамки данного введения, но читатели должны, по крайней мере, знать, что эти две версии существуют, и иногда может потребоваться принудительно использовать одну или другую версию.2223### IP-адреса хостов2425Адреса, часто называемые «адресами хостов», являются самой базовой единицей при работе с IP-адресацией. Самый простой способ создать адреса – использовать фабричную функцию [`ipaddress.ip_address()`](https://python-all.ru/3.15/library/ipaddress.html#ipaddress.ip_address), которая автоматически определяет, создавать ли IPv4 или IPv6 адрес на основе переданного значения:2627```python28>>> ipaddress.ip_address('192.0.2.1')29IPv4Address('192.0.2.1')30>>> ipaddress.ip_address('2001:DB8::1')31IPv6Address('2001:db8::1')32```3334Адреса также можно создавать непосредственно из целых чисел. Значения, помещающиеся в 32 бита, считаются IPv4-адресами:3536```python37>>> ipaddress.ip_address(3221225985)38IPv4Address('192.0.2.1')39>>> ipaddress.ip_address(42540766411282592856903984951653826561)40IPv6Address('2001:db8::1')41```4243Чтобы принудительно использовать IPv4 или IPv6 адреса, соответствующие классы можно вызвать напрямую. Это особенно полезно для принудительного создания IPv6 адресов из небольших целых чисел:4445```python46>>> ipaddress.ip_address(1)47IPv4Address('0.0.0.1')48>>> ipaddress.IPv4Address(1)49IPv4Address('0.0.0.1')50>>> ipaddress.IPv6Address(1)51IPv6Address('::1')52```5354### Определение сетей5556Адреса хостов обычно группируются в IP-сети, поэтому [`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress) предоставляет способ создания, проверки и управления определениями сетей. Объекты IP-сетей создаются из строк, определяющих диапазон адресов хостов, входящих в эту сеть. Простейшая форма такой информации – пара «адрес сети/префикс сети», где префикс определяет количество старших битов, которые сравниваются для определения, является ли адрес частью сети, а адрес сети задаёт ожидаемое значение этих битов.5758Как и для адресов, предусмотрена фабричная функция, которая автоматически определяет правильную версию IP:5960```python61>>> ipaddress.ip_network('192.0.2.0/24')62IPv4Network('192.0.2.0/24')63>>> ipaddress.ip_network('2001:db8::0/96')64IPv6Network('2001:db8::/96')65```6667Объекты сетей не могут иметь установленных битов хоста. Практический эффект этого заключается в том, что `192.0.2.1/24` не описывает сеть. Такие определения называются объектами интерфейсов, поскольку нотация «ip-на-сети» обычно используется для описания сетевых интерфейсов компьютера в заданной сети; они описываются далее в следующем разделе.6869По умолчанию попытка создать объект сети с установленными битами хоста приведёт к возникновению исключения [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError). Чтобы запросить принудительное обнуление дополнительных битов, в конструктор можно передать флаг `strict=False`:7071```python72>>> ipaddress.ip_network('192.0.2.1/24')73Traceback (most recent call last):74   ...75ValueError: 192.0.2.1/24 has host bits set76>>> ipaddress.ip_network('192.0.2.1/24', strict=False)77IPv4Network('192.0.2.0/24')78```7980Хотя строковая форма предоставляет значительно большую гибкость, сети также можно определять с помощью целых чисел, как и адреса хостов. В этом случае сеть считается содержащей только единственный адрес, заданный целым числом, поэтому префикс сети включает весь сетевой адрес:8182```python83>>> ipaddress.ip_network(3221225984)84IPv4Network('192.0.2.0/32')85>>> ipaddress.ip_network(42540766411282592856903984951653826560)86IPv6Network('2001:db8::/128')87```8889Как и в случае с адресами, создание сети определённого типа можно принудительно выполнить, вызвав конструктор класса напрямую, а не используя фабричную функцию.9091### Интерфейсы хостов9293Как уже упоминалось, если нужно описать адрес в конкретной сети, ни классы адресов, ни классы сетей не подходят. Обозначение вроде `192.0.2.1/24` обычно используется сетевыми инженерами и разработчиками инструментов для межсетевых экранов и маршрутизаторов как сокращение для «хост `192.0.2.1` в сети `192.0.2.0/24`». Соответственно, [`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress) предоставляет набор гибридных классов, которые связывают адрес с конкретной сетью. Интерфейс для создания таких объектов совпадает с интерфейсом для определения сетевых объектов, за исключением того, что часть адреса не обязана быть сетевым адресом.9495```python96>>> ipaddress.ip_interface('192.0.2.1/24')97IPv4Interface('192.0.2.1/24')98>>> ipaddress.ip_interface('2001:db8::1/96')99IPv6Interface('2001:db8::1/96')100```101102Целочисленные входные данные принимаются (как и для сетей), а использование определённой версии IP можно принудительно задать, напрямую вызвав соответствующий конструктор.103104## Просмотр объектов Address/Network/Interface105106Раз уж вы создали объект IPv(4|6)(Address|Network|Interface), скорее всего, вы захотите получить о нём информацию. [`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress) старается сделать это простым и интуитивно понятным.107108Извлечение версии IP:109110```python111>>> addr4 = ipaddress.ip_address('192.0.2.1')112>>> addr6 = ipaddress.ip_address('2001:db8::1')113>>> addr6.version1146115>>> addr4.version1164117```118119Получение сети из интерфейса:120121```python122>>> host4 = ipaddress.ip_interface('192.0.2.1/24')123>>> host4.network124IPv4Network('192.0.2.0/24')125>>> host6 = ipaddress.ip_interface('2001:db8::1/96')126>>> host6.network127IPv6Network('2001:db8::/96')128```129130Определение количества отдельных адресов в сети:131132```python133>>> net4 = ipaddress.ip_network('192.0.2.0/24')134>>> net4.num_addresses135256136>>> net6 = ipaddress.ip_network('2001:db8::0/96')137>>> net6.num_addresses1384294967296139```140141Перебор «используемых» адресов в сети:142143```python144>>> net4 = ipaddress.ip_network('192.0.2.0/24')145>>> for x in net4.hosts():146...     print(x)147192.0.2.1148192.0.2.2149192.0.2.3150192.0.2.4151...152192.0.2.252153192.0.2.253154192.0.2.254155```156157Получение маски сети (т.е. битов, установленных в соответствии с префиксом сети) или маски хоста (все биты, не входящие в маску сети):158159```python160>>> net4 = ipaddress.ip_network('192.0.2.0/24')161>>> net4.netmask162IPv4Address('255.255.255.0')163>>> net4.hostmask164IPv4Address('0.0.0.255')165>>> net6 = ipaddress.ip_network('2001:db8::0/96')166>>> net6.netmask167IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff::')168>>> net6.hostmask169IPv6Address('::ffff:ffff')170```171172Развёртывание или сжатие адреса:173174```python175>>> addr6.exploded176'2001:0db8:0000:0000:0000:0000:0000:0001'177>>> addr6.compressed178'2001:db8::1'179>>> net6.exploded180'2001:0db8:0000:0000:0000:0000:0000:0000/96'181>>> net6.compressed182'2001:db8::/96'183```184185Хотя IPv4 не поддерживает развёртывание или сжатие, соответствующие объекты всё равно предоставляют соответствующие свойства, чтобы код, не зависящий от версии, мог легко обеспечить использование самой краткой или самой полной формы для IPv6-адресов, при этом корректно обрабатывая IPv4-адреса.186187## Сети как списки адресов188189Иногда бывает полезно рассматривать сети как списки. Это означает, что их можно индексировать, например, так:190191```python192>>> net4[1]193IPv4Address('192.0.2.1')194>>> net4[-1]195IPv4Address('192.0.2.255')196>>> net6[1]197IPv6Address('2001:db8::1')198>>> net6[-1]199IPv6Address('2001:db8::ffff:ffff')200```201202Это также означает, что сетевые объекты можно использовать с синтаксисом проверки принадлежности к списку, например, так:203204```python205if address in network:206    # выполнить действие207```208209Проверка принадлежности выполняется эффективно на основе префикса сети:210211```python212>>> addr4 = ipaddress.ip_address('192.0.2.1')213>>> addr4 in ipaddress.ip_network('192.0.2.0/24')214True215>>> addr4 in ipaddress.ip_network('192.0.3.0/24')216False217```218219## Сравнения220221[`ipaddress`](https://python-all.ru/3.15/library/ipaddress.html#module-ipaddress) предоставляет несколько простых и, как надеется, интуитивно понятных способов сравнения объектов, где это имеет смысл:222223```python224>>> ipaddress.ip_address('192.0.2.1') < ipaddress.ip_address('192.0.2.2')225True226```227228Исключение [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError) возникает при попытке сравнить объекты разных версий или разных типов.229230## Использование IP-адресов с другими модулями231232Другие модули, работающие с IP-адресами (например, [`socket`](https://python-all.ru/3.15/library/socket.html#module-socket)), обычно не принимают объекты этого модуля напрямую. Вместо этого их необходимо преобразовать в целое число или строку, которые приемлемы для другого модуля:233234```python235>>> addr4 = ipaddress.ip_address('192.0.2.1')236>>> str(addr4)237'192.0.2.1'238>>> int(addr4)2393221225985240```241242## Получение более подробной информации при сбое создания экземпляра243244При создании объектов адреса/сети/интерфейса с помощью версионно-независимых фабричных функций любые ошибки будут сообщаться как [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError) с общим сообщением об ошибке, в котором просто говорится, что переданное значение не распознано как объект этого типа. Отсутствие конкретной ошибки связано с тем, что для предоставления более подробной информации о причине отклонения необходимо знать, должно ли значение *считаться* IPv4 или IPv6.245246Для поддержки сценариев, в которых полезно иметь доступ к этим дополнительным сведениям, отдельные конструкторы классов фактически вызывают подклассы [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError): [`ipaddress.AddressValueError`](https://python-all.ru/3.15/library/ipaddress.html#ipaddress.AddressValueError) и [`ipaddress.NetmaskValueError`](https://python-all.ru/3.15/library/ipaddress.html#ipaddress.NetmaskValueError), чтобы указать, какая именно часть определения не была разобрана корректно.247248Сообщения об ошибках становятся значительно более подробными при прямом использовании конструкторов классов. Например:249250```python251>>> ipaddress.ip_address("192.168.0.256")252Traceback (most recent call last):253  ...254ValueError: '192.168.0.256' does not appear to be an IPv4 or IPv6 address255>>> ipaddress.IPv4Address("192.168.0.256")256Traceback (most recent call last):257  ...258ipaddress.AddressValueError: Octet 256 (> 255) not permitted in '192.168.0.256'259260>>> ipaddress.ip_network("192.168.0.1/64")261Traceback (most recent call last):262  ...263ValueError: '192.168.0.1/64' does not appear to be an IPv4 or IPv6 network264>>> ipaddress.IPv4Network("192.168.0.1/64")265Traceback (most recent call last):266  ...267ipaddress.NetmaskValueError: '64' is not a valid netmask268```269270Однако оба специфичных для модуля исключения имеют [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError) в качестве родительского класса, поэтому если вас не интересует конкретный тип ошибки, вы по-прежнему можете писать код, подобный следующему:271272```python273try:274    network = ipaddress.IPv4Network(address)275except ValueError:276    print('address/netmask is invalid for IPv4:', address)277```278