[目录重组] - services/nac-admin → ops/nac-admin(运维后台归入 ops/) - nac-monitor/nac-daemon/nac-deploy/nac-cee-integration → ops/(运维工具归组) - nac-sdk/nac-cli/nac-serde → sdk/(开发者工具归组) - nac-api-server/nac-explorer-api → services/(对外服务归组) - 备份文件 → archive/(历史版本归档) [nac-admin 职责拆分] - 保留运维功能:Dashboard(节点监控)、AuditLog(审计)、RegulatoryMonitor(合规) - 迁出业务功能: - KnowledgeBase → services/nac-knowledge-portal/ - Crawlers → services/nac-data-crawler/ - ApprovalCases + TagEngine → services/nac-rwa-portal/ - ProtocolRegistry → services/nac-protocol-registry/ [修复] - rpc.newassetchain.io nginx 配置修复(9547→9550,NAC_Lens 网关) 设计原则:ops/ 是合理的中心化运维入口,区块链协议和业务服务 完全独立,不归属任何 admin 目录,避免中心化联想。 |
||
|---|---|---|
| .. | ||
| k8s | ||
| src | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Dockerfile | ||
| README.md | ||
| TICKET_14_COMPLETION_LOG.md | ||
| docker-compose.yml | ||
README.md
NAC部署工具
NAC公链节点的部署工具,支持Docker、Kubernetes等多种部署方式。
功能特性
1. Docker部署 ✅
- ✅ 多阶段构建Dockerfile
- ✅ Docker Compose编排
- ✅ 镜像优化(< 100MB)
- ✅ 健康检查
2. Kubernetes部署 ✅
- ✅ K8s Deployment配置
- ✅ Service配置
- ✅ PVC存储配置
- ✅ HPA自动扩缩容
- ✅ 滚动更新策略
3. 配置管理 ✅
- ✅ 环境变量管理
- ✅ ConfigMap配置
- ✅ Secret密钥管理
- ✅ 配置验证
4. 健康检查 ✅
- ✅ 存活探针(Liveness Probe)
- ✅ 就绪探针(Readiness Probe)
- ✅ 启动探针(Startup Probe)
- ✅ Prometheus监控指标
快速开始
Docker部署
# 构建镜像
docker build -t nac-blockchain/node:latest -f nac-deploy/Dockerfile .
# 运行节点
docker run -d \
--name nac-node \
-p 8545:8545 \
-p 8546:8546 \
-p 30303:30303 \
-v nac-data:/data/nac \
nac-blockchain/node:latest
# 使用Docker Compose
cd nac-deploy
docker-compose up -d
Kubernetes部署
# 创建命名空间
kubectl create namespace nac-blockchain
# 应用配置
kubectl apply -f nac-deploy/k8s/
# 查看状态
kubectl get pods -n nac-blockchain
kubectl get svc -n nac-blockchain
# 查看日志
kubectl logs -f -n nac-blockchain -l app=nac-node
配置说明
环境变量
| 变量名 | 说明 | 默认值 |
|---|---|---|
| NAC_NETWORK | 网络类型 | mainnet |
| NAC_LOG_LEVEL | 日志级别 | info |
| NAC_RPC_HOST | RPC监听地址 | 0.0.0.0 |
| NAC_RPC_PORT | RPC端口 | 8545 |
| NAC_WS_PORT | WebSocket端口 | 8546 |
| NAC_P2P_PORT | P2P端口 | 30303 |
| NAC_DATA_DIR | 数据目录 | /data/nac |
端口说明
| 端口 | 协议 | 说明 |
|---|---|---|
| 8545 | TCP | HTTP RPC |
| 8546 | TCP | WebSocket RPC |
| 30303 | TCP/UDP | P2P网络 |
| 9090 | TCP | Prometheus指标 |
监控
Prometheus
访问 http://localhost:9090 查看Prometheus监控。
Grafana
访问 http://localhost:3000 查看Grafana仪表板(默认用户名/密码:admin/admin)。
健康检查
# Docker
docker exec nac-node nac-node health
# Kubernetes
kubectl exec -n nac-blockchain -it <pod-name> -- nac-node health
故障排查
查看日志
# Docker
docker logs -f nac-node
# Kubernetes
kubectl logs -f -n nac-blockchain -l app=nac-node
检查资源使用
# Docker
docker stats nac-node
# Kubernetes
kubectl top pods -n nac-blockchain
版本历史
v1.0.0 (2026-02-18)
- ✅ 实现Docker部署
- ✅ 实现Kubernetes部署
- ✅ 实现配置管理
- ✅ 实现健康检查
- ✅ 添加监控支持
- ✅ 完整的文档
许可证
NAC公链项目专有
作者
NAC开发团队