日本 IPoE · 通用 WAN 框架评审草稿

# IPv4-over-IPv6 WAN 能力


Draft v0.7 · 产品范围评审


[体验交互原型 ↗](prototype.html)[竞品调研与截图](https://prd.xavier-chen.com/japan-ipoe/research.html?lang=zh)[下载正文](source.zh.md)
**产品范围与交付顺序**


本次评审将首期范围收敛为 **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. 产品结论摘要


Omada Gateway 本期要建立一套可跨区域复用的 `IPv4 over IPv6` WAN 产品框架，日本 B2B 作为首个落地市场。P0 目标是先把统一入口、统一配置方式和统一业务承接模型做成可商用能力，再在此基础上扩展更多区域和服务。



| 项目项 | 当前信息 |
| --- | --- |
| 设备端项目 | TPS-FPP-2511016 |
| Controller 项目 | TPS-SPP-2608095 |
| Omada App 项目 | TPS-SPP-2608096 |
| PRD 状态 | Draft v0.7 · 产品范围评审 |
| 业务目标 | 在 2027 Q1 前形成日本 SMB 基础商用能力：统一 IPv4 over IPv6 框架、日本首期 Automatic / Select Service / Manual 路径，以及对现有 IPv4 与 Multi-WAN 的承接。 |
| 计划边界 | 正式版本、排期与发布批次以项目评审结论为准；本文件定义产品范围、可观察行为和评审焦点。 |



本期产品结论如下：


- 建立统一的 `IPv4 over IPv6` WAN 框架，日本是首个落地市场。

- 日本首期 `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 型号纳入同一产品范围，验证与发布可按平台条件分批推进。


[![产品架构：WAN 配置、服务解析、引擎与地址模型、统一 IPv4 WAN](assets/japan-ipoe-product-architecture.zh.svg)

](assets/japan-ipoe-product-architecture.zh.svg)整体产品架构 · [查看配置面、Controller、设备端与后台对象详图](https://prd.xavier-chen.com/japan-ipoe/technical.html?lang=zh)




## 2. 背景与产品目标


日本宽带持续向 IPv6 IPoE 演进，共享 IPv4 可以满足基础上网，但 SMB 门店、分支、公寓网络和远程接入场景仍需要稳定的公网 IPv4 服务，用于远程访问、站点互联、端口开放和多 WAN 业务连续性。


本期目标有两层：


- 对用户，提供一个统一、可理解的 `IPv4 over IPv6` 配置入口。

- 对产品，形成一个可复用的能力模型，让后续市场扩展沿同一结构增加服务与方案。


`DS-Lite over PPPoE` 在本期定位为该框架可扩展承接的组合场景，即 `PPPoE IPv6 Underlay + DS-Lite Engine`，用于后续扩展讨论，不作为当前基线能力或 P0 交付结论。




## 3. 产品配置模型


保留 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
```


[![WAN 配置图：Automatic、Select Service、Manual 必要字段及独立 IPv6 配置](assets/japan-ipoe-configuration-surface.zh.svg)

](assets/japan-ipoe-configuration-surface.zh.svg)WAN 配置面 · 与[当前交互原型](prototype.html)一致



| 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 服务体系。按对应连接类型生成字段；实际发布及实线验证进度见[支持与验证矩阵](https://prd.xavier-chen.com/japan-ipoe/technical.html?lang=zh#vne-support-matrix)。




## 4. P0 范围



| 范围项 | 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. 产品主流程


主流程如下：



```
在 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. 验收标准


- 用户可从统一的 `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. 评审重点与参考资料


本轮预评审请研发重点确认：


- 正式版本阶段，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、支持情况、现有测试线路和重点项目窗口。


原型：


[打开 Omada IPv4-over-IPv6 WAN 设计原型](prototype.html)


该原型用于配置交互评审，不代表已发布界面。Apply 仅保存当前页面内存，刷新后清空；原型不连接设备，也不模拟在线成功。


附录：


[附录 A｜日本 IPoE 竞品设计调研](https://prd.xavier-chen.com/japan-ipoe/research.html?lang=zh)


[附录 B｜IPv4-over-IPv6 技术设计输入](https://prd.xavier-chen.com/japan-ipoe/technical.html?lang=zh)