# 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*