Docker 部署 Dufs 文件服务 🐳

📋 目录导航

🎯 项目简介
✨ 核心特性
🐳 一、Docker 部署 Dufs
- 1. 创建部署目录和 docker-compose.yml 文件 📁
- 2. 拉取镜像并启动容器 🚀
🚀 二、使用 Dufs
- 1. 访问 Web 界面 💻
- 2. 功能验证测试 🧪
🌐 三、Nginx 反向代理配置
- 1. 创建 Nginx 配置文件 🔧
- 2. 测试并重载 Nginx 🔄
🔧 四、容器维护命令
🌟 启航文件，共享无限

🎯 项目简介

🐱 GitHub 项目地址： https://github.com/sigoden/dufs
🐋 Docker 镜像地址： https://hub.docker.com/r/sigoden/dufs

Dufs 是一个轻量级、高性能的文件服务器，支持多种文件操作功能。通过 Docker 部署，可以快速搭建个人或团队使用的文件共享服务。🌟

✨ 核心特性

特性类别	功能描述	优势
📁 多协议支持	支持 HTTP、WebDAV 等多种协议	灵活适应不同使用场景
🔐 认证机制	支持基本认证和令牌认证	保障文件访问安全
📊 文件管理	提供完整的文件上传、下载、删除功能	完整的文件操作体验
🎨 美观界面	现代化的 Web 文件管理界面	提供良好的用户体验
⚡ 高性能	基于 Rust 开发，资源占用低性能高	高效处理大量文件请求
🔧 易于部署	Docker 容器化部署，简单快捷	快速搭建文件服务

🐳 一、Docker 部署 Dufs

1. 创建部署目录和 `docker-compose.yml` 文件 📁

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


mkdir -p /vol1/1000/compose/dufs && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
   dufs:
      command: /data -A
      container_name: dufs
      image: sigoden/dufs
      network_mode: bridge
      restart: always
      ports:
         - 5000:5000
      volumes:
         - ./data:/data
         - ./README.md:/data/README.md
         - /vol2/1000/阿里云盘:/data/阿里云盘
         - /vol2/1000/downloads:/data/downloads
         - /vol2/1000/file:/data/file
         - /vol2/1000/光影集:/data/media
         - /vol2/1000/backup:/data/backup
         - /vol1/1000/compose/random-pic-api/photos:/data/壁纸待处理
         - /vol2/1000/阿里云盘/教程文件/壁纸原图:/data/壁纸原图

# command: /data -A  # 允许所有操作，如上传/删除/搜索/创建/编辑...，服务/data目录
# command: /data -A --compress none  # 禁用压缩（大文件传输更高效）
# command: /data -a admin:123@/:rw # 密码保护
EOF

2. 拉取镜像并启动容器 🚀

1

docker-compose up -d

🚀 二、使用 Dufs

1. 访问 Web 界面 💻

本地访问: http://localhost:5000
域名访问: https://dufs.example.com（配置反向代理后）

2. 功能验证测试 🧪

测试项目	命令	预期结果
服务状态检查	`curl -I http://localhost:5000`	返回 HTTP 200 状态码
文件上传测试	`curl -X POST -F "file=@test.txt" http://localhost:5000/upload`	文件成功上传
目录列表查看	`curl http://localhost:5000`	显示目录文件列表
文件下载测试	`curl -O http://localhost:5000/test.txt`	文件成功下载

🌐 三、Nginx 反向代理配置

访问地址示例： https://dufs.example.com

1. 创建 Nginx 配置文件 🔧

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54


mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/dufs.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;

    server_name dufs.example.com;  # 🌐 请替换为您的实际域名

    # SSL 证书配置（请替换为实际路径）
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;

    # TLS 安全配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;

    # 安全响应头
    add_header Strict-Transport-Security "max-age=31536000" always;
    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options SAMEORIGIN always;
    add_header X-XSS-Protection "1; mode=block";

    # 大文件传输支持
    client_max_body_size 10G;
    proxy_request_buffering off;

    # 反向代理配置
    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时设置
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
    }

    # 错误页面
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
        internal;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1

sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


# 进入项目目录
cd /vol1/1000/compose/dufs

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop dufs      # 停止容器
docker start dufs     # 启动容器  
docker restart dufs   # 重启容器

# 删除容器
docker rm dufs        # 删除已停止容器
docker rm -f dufs     # 强制删除运行中容器

# 进入容器Shell
docker exec -it dufs sh      # 使用sh进入容器

# 查看容器详情和资源使用
docker inspect dufs     # 查看详细配置
docker stats dufs       # 实时资源监控

## 容器日志管理
docker logs dufs           # 查看日志
docker logs -f dufs        # 实时跟踪日志
docker logs --tail 100 dufs  # 查看最后100行
docker logs -t dufs        # 带时间戳的日志

## 健康检查
docker inspect --format='{{.State.Health.Status}}' dufs

3. Docker 镜像管理 📀

1
2
3
4


docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航文件，共享无限

通过本文档，你已经成功使用 Docker 部署了 Dufs 文件服务，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

📁 高效共享 轻松实现文件在线访问和管理，支持多协议访问和完整文件操作
🔒 安全可控 通过认证机制保障数据安全，细粒度权限控制确保访问安全
⚡ 轻量高性能 基于 Rust 的高效架构，确保快速响应和稳定服务

文件服务之路，是一场与数据共享相伴的便捷旅程。愿 Dufs 成为你可靠的文件管家，陪伴你在每一次文件共享和资源管理的重要时刻。

从现在开始，轻松共享，高效协作——构建你便捷可靠的文件服务生态吧！🚀

📌 持续迭代：建议关注 Dufs 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你部署顺利，共享无忧！🎉