210 lines
3.6 KiB
Markdown
210 lines
3.6 KiB
Markdown
# 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
|