阿里巴巴Dragonfly多机部署实战指南-优快云博客

阿里巴巴Dragonfly多机部署实战指南

Dragonfly 项目地址: https://gitcode.com/gh_mirrors/dragonfly6/Dragonfly

前言

Dragonfly是阿里巴巴开源的一款基于P2P技术的智能镜像分发系统，特别适合大规模容器化场景下的镜像分发。本文将详细介绍如何在实际生产环境中部署Dragonfly的多机集群，帮助读者构建高效的镜像分发网络。

部署架构概述

在多机部署场景下，Dragonfly采用典型的客户端-服务器架构：

SuperNode：作为中心调度节点，负责协调P2P网络中的资源调度
dfclient：部署在各个工作节点上的客户端，负责实际的镜像下载和P2P共享

环境准备

硬件要求

建议准备至少三台主机：

一台作为SuperNode服务器（建议配置较高）
两台作为dfclient客户端节点

软件要求

所有节点需要满足：

已安装Docker引擎（版本1.10.0以上）
节点间网络互通（建议局域网环境）
系统时钟同步

详细部署步骤

第一步：部署SuperNode服务

在选定的SuperNode主机上执行：

docker run -d --name supernode \
  --restart=always \
  -p 8001:8001 \
  -p 8002:8002 \
  -v /data/dragonfly/supernode:/home/admin/supernode \
  dragonflyoss/supernode:1.0.2 \
  --download-port=8001 \
  --verbose

参数说明：

8001端口：用于文件下载
8002端口：用于API通信
--verbose：开启详细日志（生产环境可去掉）

第二步：部署dfclient客户端

在每台工作节点上执行以下操作：

1. 准备配置文件

创建配置文件目录和文件：

mkdir -p /etc/dragonfly
cat <<EOF > /etc/dragonfly/dfget.yml
nodes:
  - dfsupernode:8002  # SuperNode地址和API端口
EOF

2. 启动dfclient容器

docker run -d --name dfclient \
  --restart=always \
  --net=host \
  -v /etc/dragonfly:/etc/dragonfly \
  -v /var/lib/dragonfly:/root/.small-dragonfly \
  dragonflyoss/dfclient:1.0.2 \
  --registry https://registry-1.docker.io \
  --ratelimit 20M

关键参数解析：

--net=host：使用主机网络模式，提升性能
--ratelimit：限制单个客户端带宽使用
--registry：指定默认镜像仓库地址

第三步：配置Docker引擎

修改每台工作节点的Docker配置：

cat <<EOF > /etc/docker/daemon.json
{
  "registry-mirrors": ["http://127.0.0.1:65001"],
  "max-concurrent-downloads": 10
}
EOF
systemctl restart docker

优化建议：

调整max-concurrent-downloads可提高并行下载效率
对于私有仓库，需额外配置认证信息

功能验证与测试

基础功能测试

docker pull nginx:alpine

验证P2P分发效果

# 查看下载日志
docker exec dfclient tail -n 50 /root/.small-dragonfly/logs/dfclient.log

# 检查P2P传输情况
docker exec dfclient grep 'peer task done' /root/.small-dragonfly/logs/dfclient.log