From da344caf10ec84ac0b8230f4e16918c588a62118 Mon Sep 17 00:00:00 2001
From: nacadmin <admin@newassetchain.io>
Date: Sun, 22 Feb 2026 05:58:29 +0800
Subject: [PATCH] =?UTF-8?q?docs(#045):=20=E6=B7=BB=E5=8A=A0=20NAC=20?=
 =?UTF-8?q?=E4=B8=93=E5=B1=9E=E7=AB=AF=E5=8F=A3=E6=A0=87=E5=87=86=20v1.0.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## 变更内容

### 防火墙规则更新（主网）
- 删除以太坊混淆端口：8545/tcp, 30333/tcp
- 添加 NAC 专属端口：9545, 9547, 9548, 9550/tcp, 39303/tcp+udp

### 新增文档
- docs/standards/port_standard_v1.0.0.md：NAC 专属端口标准正式文档

### 端口标准摘要
- L0 层（CSNP）: 39303-39305
- L1 层（CBPP/NAC Lens/NVM）: 9545-9549
- L2 层（API/CNNL/Charter）: 9550-9556
- 管理层: 3000, 3333, 8081, 9090

关联工单: #045
---
 docs/standards/port_standard_v1.0.0.md | 73 ++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 docs/standards/port_standard_v1.0.0.md

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*