diff --git a/docs/standards/port_standard_v1.0.0.md b/docs/standards/port_standard_v1.0.0.md new file mode 100644 index 0000000..70da315 --- /dev/null +++ b/docs/standards/port_standard_v1.0.0.md @@ -0,0 +1,73 @@ +# NAC (New Asset Chain) 专属端口标准 + +**版本**: 1.0.0 +**日期**: 2026-02-22 +**状态**: 正式实施 +**关联工单**: #045 + +## 一、设计原则 + +### 去以太坊化原则 +- ❌ 禁止使用以太坊端口:8545, 8546, 30303 等 +- ✅ 使用 NAC 专属端口段:9500-9599(核心服务)、39000-39999(网络协议) + +## 二、NAC 标准端口列表 + +### L0 层 - 网络层(CSNP 协议) + +| 端口 | 服务名称 | 协议 | 说明 | 状态 | +|------|----------|------|------|------| +| 39303 | CSNP 主节点 | TCP/UDP | Constitutional Structured Network Protocol | 🟢 规划 | +| 39304 | CSNP 发现服务 | UDP | 节点发现协议 | 🟢 规划 | +| 39305 | CSNP 同步服务 | TCP | 区块同步服务 | 🟢 规划 | + +### L1 层 - 协议层 + +| 端口 | 服务名称 | 协议 | 说明 | 状态 | +|------|----------|------|------|------| +| 9545 | CBPP 节点 RPC | HTTP | Constitutional Block Production Protocol | ✅ 运行中 | +| 9546 | CBPP WebSocket | WebSocket | CBPP 实时通信 | 🟢 规划 | +| 9547 | NAC Lens HTTP | HTTP | NAC Lens 协议(原 NRPC4.0) | 🟢 规划 | +| 9548 | NAC Lens WebSocket | WebSocket | NAC Lens 实时通信 | 🟢 规划 | +| 9549 | NVM RPC | HTTP | NAC Virtual Machine RPC 接口 | 🟢 规划 | + +### L2 层 - 应用层 + +| 端口 | 服务名称 | 协议 | 说明 | 状态 | +|------|----------|------|------|------| +| 9550 | NAC API Gateway | HTTP/HTTPS | 统一 API 网关(对外主入口) | ✅ 运行中 | +| 9551 | Explorer API | HTTP | 区块链浏览器 API | ✅ 运行中 | +| 9554 | CNNL 编译服务 | HTTP | Constitutional Neural Network Language | 🟢 规划 | +| 9555 | Charter 编译服务 | HTTP | Charter 智能合约编译器 | 🟢 规划 | +| 9556 | ACC-20 协议服务 | HTTP | Asset Compliance Code 20 | 🟢 规划 | + +### 管理和监控服务 + +| 端口 | 服务名称 | 协议 | 说明 | 状态 | +|------|----------|------|------|------| +| 9090 | Prometheus | HTTP | 监控指标采集 | ✅ 运行中 | +| 9091 | Prometheus Metrics | HTTP | NAC 节点指标暴露端口 | 🟢 规划 | +| 3000 | 量子浏览器 | HTTP | NAC Quantum Explorer | ✅ 运行中 | +| 3333 | Gitea | HTTP | Git 仓库管理 | ✅ 运行中 | +| 8081 | 认证服务 | HTTP | NAC Auth Service | ✅ 运行中 | + +## 三、以太坊端口清理记录 + +| 以太坊端口 | 原用途 | NAC 替代端口 | 清理状态 | +|-----------|--------|-------------|---------| +| 8545 | Geth HTTP RPC | 9547 (NAC Lens) | ✅ 已清理(工单#045) | +| 8546 | Geth WebSocket | 9548 (NAC Lens WS) | ✅ 已清理(工单#045) | +| 30303 | P2P 网络 | 39303 (CSNP) | ✅ 已清理(工单#045) | +| 8080 | 通用 API | 9550 (NAC API) | ✅ 已替换 | + +## 四、域名映射 + +| 域名 | 后端端口 | 服务 | 说明 | +|------|---------|------|------| +| api.newassetchain.io | 9550 | NAC API Gateway | 主 API 入口 | +| explorer.newassetchain.io | 3000 | 量子浏览器 | 区块链浏览器 | +| git.newassetchain.io | 3333 | Gitea | 代码仓库 | + +--- +*文档维护者: NAC 技术团队* +*最后更新: 2026-02-22*