Docker Deployment - Node Operations

Docker

Docker 容器化部署

最快速启动 Aeternity 节点的方式

前置要求

已安装 Docker Engine (19.03+)
已安装 Docker Compose (可选，推荐)
至少 4GB RAM (主网同步建议 8GB+)
至少 50GB 磁盘空间 (SSD 推荐)

快速启动 (Quick Start)

使用官方镜像启动一个临时节点（数据不持久化）：

docker run -d --name ae-node \
  -p 3013:3013 \
  -p 3014:3014 \
  -p 3015:3015 \
  aeternity/aeternity

注意：此命令未挂载数据卷，容器删除后区块数据将丢失。

生产环境配置 (持久化)

1. 创建数据目录

mkdir -p ~/aeternity/node/data
mkdir -p ~/aeternity/node/keys

2. 启动命令

挂载数据卷以持久化区块链数据和账户密钥：

docker run -d --name ae-node \
  -p 3013:3013 \
  -p 3014:3014 \
  -p 3015:3015 \
  -v ~/aeternity/node/data:/home/aeternity/node/data/mnesia \
  -v ~/aeternity/node/keys:/home/aeternity/node/keys \
  aeternity/aeternity

3. 验证状态

curl http://localhost:3013/v3/status

Docker Compose (推荐)

使用 docker-compose.yml 管理更方便：

version: '3'
services:
  node:
    image: aeternity/aeternity:latest
    container_name: ae-node
    restart: unless-stopped
    ports:
      - "3013:3013"
      - "3014:3014"
      - "3015:3015"
    volumes:
      - ./data:/home/aeternity/node/data/mnesia
      - ./keys:/home/aeternity/node/keys
      - ./aeternity.yaml:/home/aeternity/aeternity.yaml
    environment:
      AE__FORK_MANAGEMENT__NETWORK_ID: ae_mainnet

从快照恢复 (加速同步)

从零同步主网可能需要数天。推荐下载官方提供的数据库快照：

停止节点：docker stop ae-node
下载快照：访问官方文档获取最新快照链接
解压至数据目录：tar -xvf mnesia_snapshot.tar.gz -C ~/aeternity/node/data/
重启节点：docker start ae-node