# NAC公链服务器部署指南

## 目标服务器信息

**备份服务器**:
- IP: 103.96.148.7
- SSH端口: 22000
- 用户: root
- 操作系统: Linux

## 部署步骤

### 1. 上传部署包

将`nac-blockchain-v1.0.0.tar.gz`上传到服务器：

```bash
# 在本地执行
scp -P 22000 releases/nac-blockchain-v1.0.0.tar.gz root@103.96.148.7:/root/
```

### 2. 登录服务器

```bash
ssh -p 22000 root@103.96.148.7
```

### 3. 解压部署包

```bash
cd /root
tar -xzf nac-blockchain-v1.0.0.tar.gz
cd nac-blockchain-v1.0.0
```

### 4. 安装依赖

#### 安装Rust

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
```

#### 验证安装

```bash
rustc --version
cargo --version
```

### 5. 编译项目

```bash
cargo build --release
```

预计编译时间：5-10分钟

### 6. 运行测试

```bash
cargo test --release
```

预期结果：
```
running 180 tests
test result: ok. 180 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
```

### 7. 生成文档

```bash
cargo doc --no-deps
```

文档将生成在 `target/doc/nvm_l1/index.html`

### 8. 验证部署

```bash
# 检查编译产物
ls -lh target/release/

# 查看项目结构
tree -L 2 src/
```

## 性能验证

### 运行基准测试

```bash
cargo bench
```

### 检查代码质量

```bash
# 格式化检查
cargo fmt --check

# 代码检查
cargo clippy -- -D warnings
```

## 目录结构

部署后的目录结构：

```
/root/nac-blockchain-v1.0.0/
├── src/                    # 源代码
│   ├── phase14_sovereignty/      # Phase 14: 主权验证层
│   ├── phase15_value_standard/   # Phase 15: 价值尺度层
│   ├── phase16_oracle_crosschain/ # Phase 16: 预言机与跨链
│   ├── phase17_liquidity_derivatives/ # Phase 17: 流动性与衍生品
│   ├── phase18_governance_data/  # Phase 18: 治理与数据
│   ├── phase19_performance/      # Phase 19: 性能优化
│   ├── phase20_deployment/       # Phase 20: 部署工具
│   └── lib.rs                    # 库入口
├── target/                 # 编译产物
│   ├── release/            # Release版本
│   └── doc/                # 文档
├── Cargo.toml              # 项目配置
├── README.md               # 项目说明
└── deploy.sh               # 部署脚本
```

## 常见问题

### Q1: 编译失败

**问题**: `error: linker 'cc' not found`

**解决**:
```bash
# Ubuntu/Debian
sudo apt-get install build-essential

# CentOS/RHEL
sudo yum groupinstall "Development Tools"
```

### Q2: 内存不足

**问题**: 编译时内存不足

**解决**:
```bash
# 使用单线程编译
cargo build --release -j 1
```

### Q3: 测试失败

**问题**: 某些测试失败

**解决**:
```bash
# 查看详细错误
cargo test --release -- --nocapture

# 运行特定测试
cargo test phase14 --release
```

## 性能指标

部署成功后的预期性能：

| 指标 | 数值 |
|------|------|
| 编译时间 | 5-10分钟 |
| 测试通过率 | 100% (180/180) |
| 代码量 | 12,510行 |
| 二进制大小 | ~10MB |
| 内存占用 | ~500MB |

## 下一步

1. **配置测试网络**
   - 编辑创世区块配置
   - 设置节点参数
   - 启动测试网络

2. **部署生态工具**
   - 部署区块浏览器
   - 部署水龙头
   - 配置钱包

3. **监控和维护**
   - 设置日志监控
   - 配置性能监控
   - 定期备份数据

## 技术支持

如有问题，请联系：
- 邮箱: dev@newassetchain.io
- GitHub: https://github.com/newassetchain
- Discord: https://discord.gg/newassetchain

---

**部署日期**: 2026-02-04
**版本**: 1.0.0
**文档版本**: 1.0