From d86a86453a8ecba70c1e8d7782ed5c1ef1a62ffa Mon Sep 17 00:00:00 2001 From: "Joseph.Rawlings" Date: Mon, 1 Dec 2025 09:29:04 -0500 Subject: [PATCH] feat: enhance Proxmox help view with detailed explanations for IPv4 and IPv6 addressing, including RFC references and examples --- .../Servers/Proxmox/views/help.blade.php | 121 ++++++++++++++---- 1 file changed, 93 insertions(+), 28 deletions(-) diff --git a/extensions/Servers/Proxmox/views/help.blade.php b/extensions/Servers/Proxmox/views/help.blade.php index 9e5c4d3eb..e4103a1b1 100644 --- a/extensions/Servers/Proxmox/views/help.blade.php +++ b/extensions/Servers/Proxmox/views/help.blade.php @@ -1041,23 +1041,58 @@ preserve_hostname: false Protocol - RFC Standard - Address Format - Example + Scope + RFC Standard(s) + Address Format / Examples - IPv4 - RFC 791 - 32-bit dotted decimal - 192.168.1.1 + IPv4 + Public + + RFC 791
+ Internet Protocol (IPv4) + + + 32-bit dotted decimal addresses routable on the public Internet.
+ 203.0.113.10, 198.51.100.25 + + + + Private + + RFC 1918
+ Address Allocation for Private Internets + + + Non-routable private ranges used inside LANs and VPNs only:
+ 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 + + + + IPv6 + Global Unicast (Public) + + RFC 2460 / RFC 8200
+ Internet Protocol Version 6 (IPv6) + + + 128-bit hexadecimal addresses routable on the public Internet.
+ 2001:db8::100, 2a00:1450::1 + - IPv6 - RFC 2460 - 128-bit hexadecimal - 2001:db8::1 + Unique Local & Link-Local (Private) + + RFC 4193 – Unique Local IPv6 Addresses (ULA)
+ RFC 4291 – IPv6 Addressing Architecture + + + Private / non-routable IPv6 ranges:
+ • ULA (local-only): fd00::/8
+ • Link-local (per‑link only): fe80::/10 + @@ -1286,46 +1321,76 @@ iface vmbr0 inet static - RFC 791 + RFC 791 Internet Protocol (IPv4) Network - IPv4 addresses, network configuration + IPv4 packet format, addressing, and routing behaviour used by all IPv4 networking features. - RFC 1034 - Domain Names - Concepts and Facilities + RFC 1034 + Domain Names – Concepts and Facilities DNS - DNS architecture, domain names + High-level DNS model and resolution process referenced by DNS and subdomain configuration. - RFC 1035 - Domain Names - Implementation and Specification + RFC 1035 + Domain Names – Implementation and Specification DNS - Hostnames, DNS records, A records + Hostname syntax and record formats; hostname/subdomain validation rules in the UI are based on this RFC. - RFC 2460 + RFC 1918 + Address Allocation for Private Internets + Network + Defines private IPv4 ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) used to distinguish public vs. private addresses in UI explanations. + + + RFC 2460 / RFC 8200 Internet Protocol Version 6 (IPv6) Network - IPv6 addresses, network configuration + IPv6 header format and addressing used by IPv6 network configuration and Network Analysis. - RFC 3596 + RFC 3330 / RFC 6890 + Special-Use IPv4 Addresses + Network + Special-purpose IPv4 ranges (loopback, link-local, multicast) referenced when explaining address types. + + + RFC 3596 DNS Extensions to Support IPv6 DNS - AAAA records, IPv6 DNS + AAAA record format used for IPv6 DNS entries in network examples. - RFC 4253 + RFC 4253 SSH Transport Layer Protocol Security - SSH keys, secure authentication + SSH key formats and transport, referenced in SSH key management and Cloud-init examples. - - RFC 6143 + + RFC 5656 + Elliptic Curve Algorithm Integration in SSH + Security + ECDSA SSH keys used in recommended key types for secure access. + + + RFC 6143 The Remote Framebuffer Protocol Remote Access - VNC protocol, NoVNC + VNC/NoVNC protocol used for graphical console access. + + + RFC 7230–7235 + HTTP/1.1 Message Syntax and Routing + API + HTTP semantics for all API requests between the control panel and Proxmox/Core Router services. + + + RFC 8709 + Ed25519 for SSH + Security + Defines ED25519 SSH keys, which are recommended as a modern, secure key type.