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
2
3
4
5
6
7
# docip.py
import ipaddress, sys

print("Python", sys.version.split()[0])
for s in ("192.0.2.1", "198.51.100.7", "203.0.113.9", "2001:db8::1", "3fff::1", "3fff:fff:ffff::1", "8.8.8.8"):
a = ipaddress.ip_address(s)
print(f"{s:<18} private={a.is_private!s:<5} global={a.is_global!s:<5} reserved={a.is_reserved!s:<5}")

3つのバージョンで実行した結果である(Windows の py ランチャーでバージョンを指定した)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$ py -3.11 docip.py
Python 3.11.9
192.0.2.1 private=True global=False reserved=False
198.51.100.7 private=True global=False reserved=False
203.0.113.9 private=True global=False reserved=False
2001:db8::1 private=True global=False reserved=False
3fff::1 private=False global=True reserved=False
3fff:fff:ffff::1 private=False global=True reserved=False
8.8.8.8 private=False global=True reserved=False

$ py -3.12 docip.py
Python 3.12.10
192.0.2.1 private=True global=False reserved=False
198.51.100.7 private=True global=False reserved=False
203.0.113.9 private=True global=False reserved=False
2001:db8::1 private=True global=False reserved=False
3fff::1 private=True global=False reserved=False
3fff:fff:ffff::1 private=True global=False reserved=False
8.8.8.8 private=False global=True reserved=False

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
2
3
4
5
6
7
8
9
10
11
12
13
14
import ipaddress

DOC_NETS = [ipaddress.ip_network(n) for n in (
"192.0.2.0/24", "198.51.100.0/24", "203.0.113.0/24", # RFC 5737
"2001:db8::/32", # RFC 3849
"3fff::/20", # RFC 9637
)]

def is_documentation(s):
a = ipaddress.ip_address(s)
return any(a.version == n.version and a in n for n in DOC_NETS)

for s in ("3fff::1", "3fff:1000::1", "10.0.0.1", "2001:db8:abcd::1"):
print(s, is_documentation(s))
1
2
3
4
5
$ py -3.11 docdoc.py
3fff::1 True
3fff:1000::1 False
10.0.0.1 False
2001:db8:abcd::1 True

この関数は Python 3.11.9 でも 3.12.10 でも同じ結果を返した。

Node.js の BlockList で判定する

Node.js には is_global に当たる組み込みは無いが、net.BlockList に範囲を登録すれば同じ判定ができる。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// docip.js
// 使い方: node docip.js 2001:db8::1 3fff::1 4000::1
const net = require('node:net');

const doc = new net.BlockList();
doc.addSubnet('192.0.2.0', 24, 'ipv4'); // RFC 5737 TEST-NET-1
doc.addSubnet('198.51.100.0', 24, 'ipv4'); // RFC 5737 TEST-NET-2
doc.addSubnet('203.0.113.0', 24, 'ipv4'); // RFC 5737 TEST-NET-3
doc.addSubnet('2001:db8::', 32, 'ipv6'); // RFC 3849
doc.addSubnet('3fff::', 20, 'ipv6'); // RFC 9637

for (const s of process.argv.slice(2)) {
const family = net.isIPv6(s) ? 'ipv6' : net.isIPv4(s) ? 'ipv4' : null;
if (!family) { console.log(`${s} -> not an IP address`); continue; }
console.log(`${s.padEnd(18)} documentation=${doc.check(s, family)}`);
}
1
2
3
4
5
6
7
8
$ node docip.js 192.0.2.1 2001:db8::1 3fff::1 3fff:fff:ffff::1 3fff:1000::1 4000::1 8.8.8.8
192.0.2.1 documentation=true
2001:db8::1 documentation=true
3fff::1 documentation=true
3fff:fff:ffff::1 documentation=true
3fff:1000::1 documentation=false
4000::1 documentation=false
8.8.8.8 documentation=false

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 確認)

IPv6の文書用3fff::/20 Python 3.11はis_globalがTrue
https://blog.hashito.biz/2026/11/22/ipv6-documentation-prefix-3fff-20-rfc9637-python-ipaddress-is-global/
著者
hashito
作成日
2026年11月22日
著作権