Dragonfly项目服务端安装与部署指南

Dragonfly项目服务端安装与部署指南

Dragonfly This repository has be archived and moved to the new repository https://github.com/dragonflyoss/Dragonfly2. 项目地址: https://gitcode.com/gh_mirrors/dra/Dragonfly

前言

Dragonfly是一个基于P2P技术的智能分发系统，主要用于大规模文件分发场景。本文将详细介绍如何安装和部署Dragonfly的服务端组件supernode，这是整个系统的核心调度节点。

部署方式选择

Dragonfly服务端支持两种部署方式：

1. Docker部署：适合快速体验和测试环境
2. 物理机部署：推荐用于生产环境，性能更稳定

环境准备

Docker部署要求

• Git 1.9.1+
• Docker 1.12.0+

物理机部署要求

• Git 1.9.1+
• Golang 1.12.x
• Nginx 0.8+

Docker部署方案

获取supernode镜像

有两种方式获取镜像：

方式一：直接拉取官方镜像

docker pull dragonflyoss/supernode:1.0.0

方式二：自行构建镜像

git clone <Dragonfly仓库地址>
cd Dragonfly
TAG="1.0.0"
make docker-build-supernode DF_VERSION=$TAG

获取镜像ID：

docker image ls | grep 'supernode' | awk '{print $3}' | head -n1

启动supernode容器

docker run -d --name supernode --restart=always \
  -p 8001:8001 -p 8002:8002 \
  -v /home/admin/supernode:/home/admin/supernode \
  ${supernodeDockerImageId} --download-port=8001

参数说明：

• 8001端口：文件下载端口
• 8002端口：supernode服务端口
• 数据卷挂载：持久化存储配置和缓存数据

物理机部署方案

获取supernode可执行文件

方式一：下载预编译包

version=1.0.0
wget <Dragonfly发布包地址>/Dragonfly_${version}_linux_amd64.tar.gz
tar -zxf Dragonfly_1.0.0_linux_amd64.tar.gz -C /usr/local/bin

方式二：从源码编译

git clone <Dragonfly仓库地址>
cd Dragonfly
make build-supernode && make install-supernode

启动supernode服务

supernodeHomeDir=/home/admin/supernode
supernodeDownloadPort=8001
supernode --home-dir=$supernodeHomeDir --port=8002 --download-port=$supernodeDownloadPort

配置文件服务器

以Nginx为例：

1. 添加配置：

server {
    listen 8001;
    location / {
        root /home/admin/supernode/repo;
    }
}

2. 启动Nginx：

sudo nginx

部署后验证

1. 检查端口是否正常监听：

telnet 127.0.0.1 8001  # 文件下载端口
telnet 127.0.0.1 8002  # supernode服务端口

2. 测试文件下载功能（需要先安装客户端）：

dfget --url "http://<资源URL>" --output ./testfile --node "127.0.0.1:8002=1"

生产环境建议

1. 高可用部署：建议至少部署2个supernode节点
2. 资源规划：
   • 磁盘空间：根据预计缓存文件大小配置
   • 内存：建议8GB以上
3. 监控指标：
   • 节点负载
   • P2P成功率
   • 带宽利用率

常见问题

Q：为什么需要同时配置supernode和Nginx？ A：supernode负责P2P调度，Nginx作为静态文件服务器提供回源下载能力，两者配合完成完整的分发流程。

Q：8001和8002端口有什么区别？ A：8001是下载端口，由Nginx监听；8002是supernode服务端口，用于客户端连接和节点间通信。

通过本文的指导，您应该已经成功部署了Dragonfly的服务端组件。接下来可以继续配置客户端，构建完整的P2P分发网络。

Dragonfly This repository has be archived and moved to the new repository https://github.com/dragonflyoss/Dragonfly2. 项目地址: https://gitcode.com/gh_mirrors/dra/Dragonfly