IPv4-over-IPv6 WAN Capability
Draft v0.7 · 产品范围评审
产品范围与交付顺序
本次评审将首期范围收敛为 HB46PP 自动 Provisioning + IPIP Fixed IPv4。首期优先补齐 IPsec、Port Forwarding，并将 Multi-WAN 纳入开发计划；VRRP 和更多 VPN 类型后续推进。Beta 阶段以 Standalone 为主，Controller / App 随正式版本回归主线。日本团队需补充 7 个 VNE 的 Service / Plan、支持情况、测试线路及重点项目窗口，作为 Provider / Service 优先级和 Local Test 计划输入。
1. Executive Summary
Omada Gateway 本期要建立一套可跨区域复用的 IPv4 over IPv6 WAN 产品框架，日本 B2B 作为首个落地市场。P0 目标是先把统一入口、统一配置方式和统一业务承接模型做成可商用能力，再在此基础上扩展更多区域和服务。
| 项目项 | 当前信息 |
|---|---|
| Device-side project | TPS-FPP-2511016 |
| Controller project | TPS-SPP-2608095 |
| Omada App project | TPS-SPP-2608096 |
| PRD status | Draft v0.7 · 产品范围评审 |
| 业务目标 | 在 2027 Q1 前形成日本 SMB 基础商用能力：统一 IPv4 over IPv6 框架、日本首期 Automatic / Select Service / Manual 路径，以及对现有 IPv4 与 Multi-WAN 的承接。 |
| 计划边界 | 正式版本、排期与发布批次以项目评审结论为准；本文件定义产品范围、可观察行为和评审焦点。 |
本期产品结论如下：
- 建立统一的
IPv4 over IPv6WAN 框架，日本是首个落地市场。 - 日本首期
Automatic由 HB46PP 落地，Select Service先产品化 OCN Virtual Connect Fixed IP 与 Asahi v6 Connect (IPIP)。 - 当前产品基线为 DS-Lite 与 MAP-E；它们需要在统一框架下继续承接。
Manual在 P0 支持 DS-Lite 与 Generic IPv4-in-IPv6 Tunnel (IPIP) 的标准参数。- 所有在维 Omada Gateway 型号纳入同一产品范围，验证与发布可按平台条件分批推进。
2. Background and Product Goal
日本宽带持续向 IPv6 IPoE 演进，共享 IPv4 可以满足基础上网，但 SMB 门店、分支、公寓网络和远程接入场景仍需要稳定的公网 IPv4 服务，用于远程访问、站点互联、端口开放和多 WAN 业务连续性。
本期目标有两层：
- 对用户，提供一个统一、可理解的
IPv4 over IPv6配置入口。 - 对产品，形成一个可复用的能力模型，让后续市场扩展沿同一结构增加服务与方案。
DS-Lite over PPPoE 在本期定位为该框架可扩展承接的组合场景，即 PPPoE IPv6 Underlay + DS-Lite Engine，用于后续扩展讨论，不作为当前基线能力或 P0 交付结论。
3. Product Configuration Model
保留 Omada 现有 WAN 页面、WAN 列表及 IPv4 / IPv6 双栈表单，仅在 IPv4 Configuration 内扩展配置路径：
WAN Config → Edit WAN Connection
├─ IPv4 Configuration
│ ├─ Connection Type = IPv4 over IPv6
│ └─ Setup Method
│ ├─ Automatic → Authentication
│ │ ├─ None
│ │ └─ Username / Password → 用户名、密码
│ ├─ Select Service → VNE
│ │ └─ Service Type（多种类型时显示）→ 对应必填参数
│ └─ Manual → Tunnel Type
│ ├─ DS-Lite → AFTR Assignment
│ │ ├─ Auto (DHCPv6)
│ │ └─ Manual → AFTR Name / IPv6 Address
│ └─ IPv4-in-IPv6 Tunnel
│ └─ Fixed IPv4 Address / Remote IPv6 Address / Interface ID
├─ IPv6 Configuration（独立保留）
│ └─ Connection / Prefix Delegation / DNS Server
└─ Apply / Cancel
| Setup Method | 何时出现 | 用户完成什么 | 日本首期路径 |
|---|---|---|---|
| Automatic | 设备和当前构建具备完整自动解析能力时 | 选择 Authentication；需要认证时填写用户名、密码，其余参数自动取得 | HB46PP |
| Select Service | 当前版本提供对应 VNE 连接类型时 | 选择 VNE、连接类型，填写该类型需要的合同参数 | OCN Virtual Connect Fixed IP、Asahi v6 Connect (IPIP) |
| Manual | 设备支持相关引擎标准参数时 | 选择 Tunnel Type，填写必要参数 | DS-Lite、Generic IPv4-in-IPv6 Tunnel (IPIP) |
产品规则如下：
- 根据能力可同时展示多个 Setup Method，但同一 WAN 保存时只能选择一种。
Automatic用于完整自动解析路径；Standard Provisioning 根据合同选择免认证或用户名 / 密码认证，无需预选 VNE。Select Service先选 VNE；有多种连接类型时显示 Service Type，只有一种时自动采用并隐藏该行。随后仅显示该路径的必填参数；零额外参数的服务无需再填写。公司名称作为后台映射，固定 IP 地址数量在同一连接类型内处理。Manual提供 DS-Lite 和 IPv4-in-IPv6 Tunnel 两种 Tunnel Type。DS-Lite 选择 AFTR 自动获取或手动填写；IPIP 填写固定 IPv4、远端 IPv6 和 Interface ID。- IPv6 Configuration 独立保留 Connection、Prefix Delegation 和 DNS Server；地址、认证及 DNS 输入按所选方式显示。切换 IPv4 配置路径或 VNE 时保留已填 IPv6 设置。
- Apply 仅校验并提交当前路径参数；Cancel 恢复最近一次已保存配置。页面保留常规 WAN 列表与表单，后台对象、迁移和诊断设计见技术附录。
日本服务目录包含 OCN Virtual Connect、v6 Plus、transix、BIGLOBE、Xpass、v6 Connect、OCX，共 7 个 VNE 服务体系。按对应连接类型生成字段；实际发布及实线验证进度见支持与验证矩阵。
4. P0 Scope
| 范围项 | P0 内容 |
|---|---|
| 统一入口 | 在现有 WAN 配置路径内提供统一 IPv4 over IPv6 入口，并输出统一 IPv4 WAN |
| 当前基线承接 | DS-Lite 与 MAP-E 在统一框架下继续可配置，并可迁移到统一入口模型 |
| Automatic | HB46PP 作为日本首期 Automatic，实现 shared IPv4 / DS-Lite 与 fixed IPv4 / IPIP 两类返回结果 |
| Select Service | 首期产品化 OCN Virtual Connect Fixed IP 与 Asahi v6 Connect (IPIP)，服务建立后输出统一 IPv4 WAN |
| Manual | 支持 DS-Lite 与 Generic IPv4-in-IPv6 Tunnel (IPIP) 的标准参数；在无 Profile 时可建链并输出统一 IPv4 WAN |
| 地址形态 | Dynamic / Shared IPv4、Single Fixed IPv4、Fixed IPv4 Prefix |
| Fixed IPv4 Prefix | 接收并保存运营商分配的 Prefix，并从中确定一个 Router Service IPv4 供网关现有 IPv4 功能使用 |
| 既有功能承接 | Internet、NAT、Routing、Firewall / ACL、Port Forwarding、现有 IPsec、Load Balancing、Link Backup / Failover |
| 机型范围 | 所有在维 Omada Gateway 型号采用同一产品模型，按平台条件分批验证与发布 |
Fixed IPv4 Prefix 剩余地址在 LAN / VLAN 侧的 Public Subnet Handoff，以及基于这些地址的后续消费能力，保留到后续能力规划与技术设计中讨论。
5. Main Product Flow
主流程如下：
在 WAN 列表中选择 Edit
-> IPv4 Connection Type 选择 IPv4 over IPv6
-> 选择 Setup Method，完成当前路径所需输入
-> 确认同一 WAN 的 IPv6 Configuration
-> Apply 保存；Cancel 恢复最近一次已保存配置保存后，设备建立服务并提供统一 IPv4 WAN，供现有 IPv4 与 Multi-WAN 功能使用。配置与状态规则如下：
- 当前构建未开放某个 Setup Method 时，该方法不展示。
- 当前设备或版本未支持某个 VNE 连接类型时，该条目不进入可选列表。
- 任何配置路径缺少必填参数或参数格式不符时，标明具体字段并阻止保存；切换 VNE / 连接类型后仅提交当前可见参数。
- 服务建立成功但业务未可用时，状态提示需要区分“服务已建立”和“业务未可用”。
6. Acceptance Criteria
- 用户可从统一的
IPv4 over IPv6入口进入配置；根据能力可以看到多个 Setup Method，但同一 WAN 保存时只能选择一种。 - 现有 DS-Lite 与 MAP-E 配置可迁移到统一框架，并保持原有服务可用。
- 当 HB46PP 返回 shared IPv4 / DS-Lite 结果时，系统可建立服务并输出统一 IPv4 WAN。
- 当 HB46PP 返回 fixed IPv4 / IPIP 结果时，系统可建立服务并输出统一 IPv4 WAN。
- 用户通过
Select Service选择 OCN Virtual Connect Fixed IP 后，系统可建立服务并输出统一 IPv4 WAN。 - 用户通过
Select Service选择 Asahi v6 Connect (IPIP) 后，系统可建立服务并输出统一 IPv4 WAN。 - 用户通过
Manual配置 DS-Lite 或 Generic IPv4-in-IPv6 Tunnel (IPIP) 标准参数后，系统可建立服务并输出统一 IPv4 WAN。 - Fixed IPv4 Prefix 配置建立后，系统可保存运营商分配的 Prefix，并确定一个 Router Service IPv4；该地址可供现有 IPv4 Internet、NAT、Routing、Port Forwarding 和现有 IPsec 功能使用。
- 建立后的统一 IPv4 WAN 可加入 Load Balancing 与 Link Backup / Failover。
- 所有在维 Omada Gateway 型号采用同一产品模型；已支持型号可按批次验证与发布，未支持构建不暴露对应入口或服务项。
7. Review Focus and References
本轮预评审请研发重点确认：
- 正式版本阶段，Controller / App 是否可统一承载
Automatic、Select Service、Manual三种 Setup Method，现有 DS-Lite / MAP-E 是否可平滑迁移到统一入口，以及 Service Catalog 是否可持续维护。 - HB46PP Automatic 同时承接 shared IPv4 / DS-Lite 与 fixed IPv4 / IPIP 的实现路径是否可控。
- OCN Virtual Connect Fixed IP、Asahi v6 Connect (IPIP) 与 Manual IPIP 路径是否可在同一 P0 中收敛为统一 IPv4 WAN。
- Fixed IPv4 Prefix 在 P0 仅承接 Router Service IPv4 的范围定义，以及现有 IPsec 与 Multi-WAN 对统一 IPv4 WAN 的消费路径是否完整。
- 在 2027 Q1 业务目标下，全系列机型的资源投入、测试线路/条件和迭代节奏是否可行；日本团队需先提供 7 个 VNE 的 Service / Plan、支持情况、现有测试线路和重点项目窗口。
Prototype:
Open the Omada IPv4-over-IPv6 WAN Design Prototype
该原型用于配置交互评审，不代表已发布界面。Apply 仅保存当前页面内存，刷新后清空；原型不连接设备，也不模拟在线成功。
Appendices: