IPv6の文書用3fff::/20 Python 3.11はis_globalがTrue
手順書やテストデータに書く IPv6 アドレスといえば、長く 2001:db8::/32 だった。2024年8月に RFC 9637 が出て、文書用のプレフィックスとして 3fff::/20 が加わっている。
困るのは、ライブラリ側の判定がまだ追いついていない環境があることだ。手元の Python 3.11.9 の ipaddress は 3fff::1 を is_global=True(インターネットで到達できるアドレス)と判定した。3.12.10 と 3.14.10 では False になる。「文書用アドレスだけを許す」「グローバルなアドレスを弾く」といった検査を is_global に任せていると、同じコードでも Python のバージョンで結果が変わる。
この記事では、ハシトシステムの 例示用IPアドレス・ドメイン生成 が使っている予約範囲を手がかりに、文書用アドレスの規格と、Python と Node.js での判定を確かめる。
検証環境は Windows 11、Python 3.11.9 / 3.12.10 / 3.14.10、Node.js v24.11.1 である。
文書用に予約されたアドレス
文書やサンプルに書くための値は、規格で予約された範囲がある。経路として広告されず、誰にも割り当てられないので、手順書からコピーして実行しても他人のホストには届かない。
| 種類 | 範囲 | 規格 |
|---|---|---|
| IPv4 | 192.0.2.0/24(TEST-NET-1)、198.51.100.0/24(TEST-NET-2)、203.0.113.0/24(TEST-NET-3) | RFC 5737 |
| IPv6 | 2001:db8::/32 | RFC 3849 |
| IPv6 | 3fff::/20 | RFC 9637(RFC 3849 を更新) |
| ドメイン | example.com / example.net / example.org、.test / .example / .invalid / .localhost | RFC 2606 |
| AS 番号 | 64496〜64511、65536〜65551 | RFC 5398 |
| MAC(EUI-48) | 00-00-5E-00-53-00〜00-00-5E-00-53-FF | RFC 9542(RFC 7042 を廃止して置き換え) |
RFC 9637 で何が変わったか
RFC 9637「Expanding the IPv6 Documentation Space」(2024年8月)は、2001:db8::/32 に加えて 3fff::/20 を文書用に予約した。RFC の序文によると、理由は大きさである。ネットワークが大きく多様になり、2001:db8::/32 だけでは現実的な構成を例示しきれない。そのため文書の例が、実際に組織や ISP に割り当て済みのアドレスや未割り当ての空間を借りてしまい、将来の割り当てと衝突するおそれがあった。/20 は /32 の 4096 倍の広さがある。
IANA の IPv6 Special-Purpose Address Registry には、次の内容で登録するよう依頼している。
- Address Block: 3fff::/20、Name: Documentation、RFC: RFC 9637、Allocation Date: 2024-07
- Source / Destination / Forwardable / Globally Reachable / Reserved-by-Protocol: すべて False
3fff::/20 の範囲は 3fff:: から 3fff:fff:ffff:ffff:ffff:ffff:ffff:ffff までである。4桁目の区切りは 3fff:0fff で終わるので、3fff:1000:: は範囲の外になる。見た目が似ているので、手で書くときに間違えやすい。
実際に試す
Python の ipaddress で判定する
ipaddress の is_private と is_global は、IANA のレジストリをもとにした表で判定している。文書用アドレスも「グローバルではない」側に入る。
1 | |
3つのバージョンで実行した結果である(Windows の py ランチャーでバージョンを指定した)。
1 | |
Python 3.14.10 の結果は 3.12.10 と同じだった。違うのは 3fff::/20 の2行だけで、3.11.9 では 8.8.8.8 と同じく「グローバル」扱いになっている。
この差は CPython の issue gh-124217「RFC 9637 not implemented by ipaddress module」(2024年9月18日起票)で直された。main への修正と、3.12・3.13 のブランチへのバックポートが入っている。3.11 向けのバックポートは issue に紐づいていない。3.14.10 の ipaddress.py を見ると、IPv6Network('3fff::/20') が 2001:db8::/32 の次に並んでいる。
バージョンに頼らず範囲で判定する
「文書用アドレスかどうか」を知りたいなら、is_private / is_global の意味に寄りかからず、予約範囲を自分で列挙して比べるほうが確実である。is_private は文書用以外のプライベートアドレス(10.0.0.0/8 や fc00::/7 など)でも True になるので、もともと「文書用か」の判定には使えない。
1 | |
1 | |
この関数は Python 3.11.9 でも 3.12.10 でも同じ結果を返した。
Node.js の BlockList で判定する
Node.js には is_global に当たる組み込みは無いが、net.BlockList に範囲を登録すれば同じ判定ができる。
1 | |
1 | |
3fff:fff:ffff::1 は範囲の内側、3fff:1000::1 は外側と、上で書いた境界どおりに分かれた。
例示用IPアドレス・ドメイン生成での扱い
ハシトシステムの 例示用IPアドレス・ドメイン生成 は、上の表の予約範囲からだけ値を作る。ページのスクリプトは、範囲の表(IPv4 は RFC 5737 の3ブロック、IPv6 は RFC 3849 の 2001:db8::/32)と、番号から1件を組み立てる関数を分けている。乱数は番号を選ぶところにだけ使うので、ランダム生成でも予約範囲の外の値は出ない。
- IPv4 は3ブロックのホスト部 1〜254 を使い、ネットワークアドレスやブロードキャストに見える 0 と 255 を避ける
- IPv6 は
2001:db8:<16ビット>::1の形で、/64単位に振る - 乱数は
crypto.getRandomValuesを使い、範囲外を捨てて剰余の偏りを避ける。安全な乱数が取れない環境では、推測できる乱数に切り替えずにエラーを表示する
IPv6 の生成は 2026-11-22 時点で 2001:db8::/32 だけを使っている。3fff::/20 の値を例示に使いたい場合は、受け取る側の検査が RFC 9637 に対応しているかを先に確かめたほうがよい。上で見たとおり、Python 3.11 の is_global で「グローバルなアドレスは載せない」と検査している仕組みに 3fff::1 を流すと、文書用なのに弾かれる。
まとめ
- IPv6 の文書用アドレスは、RFC 3849 の
2001:db8::/32に加えて、RFC 9637(2024年8月)で3fff::/20が加わった。範囲の終わりは3fff:0fff:...である。 - Python 3.11.9 の
ipaddressは3fff::1をis_global=True、is_private=Falseと判定する。3.12.10 と 3.14.10 では逆になる(gh-124217 の修正)。 is_privateは文書用以外のプライベートアドレスでも True になる。「文書用か」を判定したいなら、予約範囲を列挙して自分で比べる。Python はip_networkとin、Node.js はnet.BlockListで書ける。
結果は 2026-11-22 時点の上記の環境で得たものである。
参考
- RFC 9637「Expanding the IPv6 Documentation Space」(2024年8月、RFC 3849 を更新)Section 6 IANA Considerations
- RFC 3849「IPv6 Address Prefix Reserved for Documentation」、RFC 5737「IPv4 Address Blocks Reserved for Documentation」
- RFC 2606「Reserved Top Level DNS Names」、RFC 5398「Autonomous System (AS) Number Reservation for Documentation Use」、RFC 9542「IANA Considerations and IETF Protocol and Documentation Usage for IEEE 802 Parameters」(2024年4月、RFC 7042 を廃止)Section 2.1.3
- CPython issue gh-124217「RFC 9637 not implemented by ipaddress module」と PR #124240(main)・#124282(3.13)・#124283(3.12)
- Python 3.11.9 / 3.12.10 / 3.14.10 と Node.js v24.11.1 での上記スクリプトによる実測
- ハシトシステム 例示用IPアドレス・ドメイン生成のページのスクリプト(2026-11-22 確認)