Docker-Dufs(轻量文件服务器)

及其轻量的文件服务器，应用程序不足2M，作为基础Web共享非常好用

**相关链接：**
- GitHub：https://github.com/sigoden/dufs
  - Releases：https://github.com/sigoden/dufs/releases
- Docker：https://hub.docker.com/r/sigoden/dufs

## Linux 部署
```bash
wget https://github.com/sigoden/dufs/releases/download/v0.43.0/dufs-v0.43.0-x86_64-unknown-linux-musl.tar.gz -o dufs.tar.gz  # 下载二进制文件
tar -xzf dufs.tar.gz && chmod +x dufs  # 解压并给执行权限

# 运行方式(只列举较常见方式)
dufs  # 只读模式，当前工作目录
dufs -A  # 允许所有操作(上传/删除/搜索/创建/编辑)，当前工作目录
dufs --allow-upload Downloads  # 仅允许上传，指定目录
dufs -a admin:123@/:rw  # 用户验证@指定目录1:读写,指定目录2...
```

## Docker 部署
```bash
# 挂载当前目录，允许所有操作
docker run -it --rm -v ${PWD}:/data -p 5000:5000 sigoden/dufs /data -A
```

## docker-compose
```bash
mkdir -p data  # 创建存储文件夹
nano docker-compose.yml  # 创建 docker-compose.yml 配置文件
docker-compose up -d  # 拉取并部署
```
`docker-compose.yml`，根据实际情况调整
```yaml
services:
  dufs:
    stdin_open: true  # 允许标准输入(-i)
    tty: true  # 允许终端交互(-t)
    image: sigoden/dufs  # 指定镜像
    # command: /data -A  # 启动命令,使用环境变量来配置故禁用
    ports:
      - 5000:5000  # 暴露端口
    volumes:
      - ./data:/data  # 挂载目录至内部路径
    environment:
      # - DUFS_PORT=5000  # 监听端口(默认5000)
      - DUFS_SERVE_PATH=/data  # 指定共享目录(默认/根目录),若是使用用户验证则禁用否则会限制在这个目录下
      # - DUFS_AUTH=admin:admin@/:rw|user:pass@/data  # 添加用户验证(格式: 用户1:密码@路径:权限,路径:权限|用户2:密码@路径:权限),帐号密码@隔开;路径,隔开;多用户|隔开
      - DUFS_ALLOW_ARCHIVE=true  # 允许创建ZIP压缩包
      # - DUFS_HIDDEN=tmp,*.log,*.lock  # 隐藏文件(可使用通配符)
      # ========================== 操作权限配置 ==========================
      - DUFS_ALLOW_ALL=true  # 允许所有操作(若是需要精确控制权限则禁用)
      # - DUFS_ALLOW_UPLOAD=true  # 允许上传
      # - DUFS_ALLOW_DELETE=true  # 允许删除
      # - DUFS_ALLOW_SEARCH=true  # 允许搜索
      # - DUFS_ALLOW_SYMLINK=true  # 允许创建符号链接
      # ========================== 渲染 index.html(二选一) ==========================
      # - DUFS_RENDER_INDEX=true  # 尝试渲染 index.html(找不到则返回)
      - DUFS_RENDER_TRY_INDEX=true  # 尝试渲染 index.html(默认渲染 index.htm,找不到则返回目录列表)
```

## Dufs 命令参数
[官方参数解析](https://github.com/sigoden/dufs?tab=readme-ov-file#cli)
```bash
Dufs 是一个独特的实用文件服务器 - https://github.com/sigoden/dufs

用法: dufs [选项] [服务路径]

参数:
  [服务路径] 指定要服务的路径 [默认: .]  # DUFS_SERVE_PATH=/data

选项：(DUFS_+选项名 就是环境变量名称，下方列出可用变量)
  -c, --config <文件>  # 指定配置文件  # DUFS_CONFIG=config.yaml
  -b, --bind <地址>  # 指定绑定地址或 Unix 套接字  # DUFS_BIND=0.0.0.0
  -p, --port <端口>  #  指定要监听的端口 [默认: 5000]  # DUFS_PORT=5000
      --path-prefix <路径>  # 指定路径前缀(子地址)  # DUFS_PATH_PREFIX=/dufs
      --hidden <值>  #  从目录列表中隐藏路径，例如 tmp,*.log,*.lock  # DUFS_HIDDEN=tmp,*.log,*.lock
  -a, --auth <规则>  # 添加认证角色，例如 user:pass@/dir1:rw,/dir2  # DUFS_AUTH=admin:admin@/:rw|user:pass@/data
  -A, --allow-all  # 允许所有操作  # DUFS_ALLOW_ALL=true
      --allow-upload  # 允许上传文件/文件夹  # DUFS_ALLOW_UPLOAD=true
      --allow-delete  # 允许删除文件/文件夹  # DUFS_ALLOW_DELETE=true
      --allow-search  # 允许搜索文件/文件夹  # DUFS_ALLOW_SEARCH=true
      --allow-symlink  # 允许对根目录外的文件/文件夹创建符号链接  # DUFS_ALLOW_SYMLINK=true
      --allow-archive  # 允许生成 zip 压缩包  # DUFS_ALLOW_ARCHIVE=true
      --enable-cors  # 启用 CORS，设置 `Access-Control-Allow-Origin: *`  # DUFS_ENABLE_CORS=true
      --render-index  # 在请求目录时提供 index.html，如果没有找到 index.html 则返回 404  # DUFS_RENDER_INDEX=true
      --render-try-index  # 在请求目录时提供 index.html，如果没有找到 index.html 则返回目录列表  # DUFS_RENDER_TRY_INDEX=true
      --render-spa  # 提供单页面应用（SPA）  # DUFS_RENDER_SPA=true
      --assets <路径>  # 设置用于覆盖内置资源的资源目录路径  # DUFS_ASSETS=./assets
      --log-format <格式>  # 自定义 HTTP 日志格式  # DUFS_LOG_FORMAT=""
      --log-file <文件>  # 指定日志文件保存位置，而非标准输出/标准错误  # DUFS_LOG_FILE=./dufs.log
      --compress <级别>  # 设置 zip 压缩级别 [默认: low] [可能的值: none, low, medium, high]  # DUFS_COMPRESS=low
      --completions <shell>  # 打印 <shell> 的 shell 补全脚本 [可能的值: bash, elvish, fish, powershell, zsh]
      --tls-cert <路径>  # 指定 SSL/TLS 证书的路径以使用 HTTPS 服务  # DUFS_TLS_CERT=cert.pem
      --tls-key <路径>  # 指定 SSL/TLS 证书的私钥路径  # DUFS_TLS_KEY=key.pem
  -h, --help  # 打印帮助
  -V, --version  # 打印版本
```
[应用程序接口](https://github.com/sigoden/dufs?tab=readme-ov-file#api)
```bash
curl -T path-to-file http://127.0.0.1:5000/new-path/path-to-file  # 上传文件
curl http://127.0.0.1:5000/path-to-file  # 下载文件
curl http://127.0.0.1:5000/path-to-file?hash  # 获取文件的哈希值
curl -o path-to-folder.zip http://127.0.0.1:5000/path-to-folder?zip  # 文件夹打包为zip并下载
curl -X DELETE http://127.0.0.1:5000/path-to-file-or-folder  # 删除文件或文件夹
curl -X MKCOL http://127.0.0.1:5000/path-to-folder  # 创建目录
curl -X MOVE http://127.0.0.1:5000/path -H "Destination: http://127.0.0.1:5000/new-path"  # 移动文件或文件夹
curl http://127.0.0.1:5000?q=Dockerfile  # 搜索文件名包含Dockerfile的文件
curl http://127.0.0.1:5000?simple  # 输出简单格式的目录内容
curl http://127.0.0.1:5000?json  # 输出JSON格式的目录内容
curl http://127.0.0.1:5000/file --user user:pass  # 用户验证授权
curl http://127.0.0.1:5000/file --user user:pass --digest  # 摘要式身份验证授权
curl http://127.0.0.1:5000/__dufs__/health  # 运行状况检查
curl -C- -o file http://127.0.0.1:5000/file  # 断点续传下载文件
# 断电续传
upload_offset=$(curl -I -s http://127.0.0.1:5000/file | tr -d '\r' | sed -n 's/content-length: //p')
dd skip=$upload_offset if=file status=none ibs=1 | \
  curl -X PATCH -H "X-Update-Range: append" --data-binary @- http://127.0.0.1:5000/file
```
[配置文件](https://github.com/sigoden/dufs?tab=readme-ov-file#configuration-file)，使用 `--config config.yaml` 指定配置文件
```yaml
serve-path: '.'  # 指定要服务的路径，默认为当前目录
bind: 0.0.0.0  # 绑定地址，0.0.0.0 表示绑定所有可用网络接口
port: 5000  # 指定要监听的端口，默认为 5000
path-prefix: /dufs  # 指定路径前缀
hidden:  # 从目录列表中隐藏的路径
  - tmp  # 隐藏 tmp 目录
  - '*.log'  # 隐藏所有以 .log 结尾的文件
  - '*.lock'  # 隐藏所有以 .lock 结尾的文件
auth:  # 认证规则
  - admin:admin@/:rw  # 用户 admin 在根目录及其子目录下拥有读写权限
  - user:pass@/src:rw,/share  # 用户 user 在 /src 和 /share 目录及其子目录下拥有读写权限
  - '@/'  # 根据 YAML 规范，需要加引号。表示匿名用户在根目录及其子目录下拥有访问权限
allow-all: false  # 是否允许所有操作，默认为 false
allow-upload: true  # 是否允许上传文件/文件夹
allow-delete: true  # 是否允许删除文件/文件夹
allow-search: true  # 是否允许搜索文件/文件夹
allow-symlink: true  # 是否允许对根目录外的文件/文件夹创建符号链接
allow-archive: true  # 是否允许生成 zip 压缩包
enable-cors: true  # 是否启用 CORS，设置 `Access-Control-Allow-Origin: *`
render-index: true  # 在请求目录时是否提供 index.html，如果没有找到 index.html 则返回 404
render-try-index: true  # 在请求目录时是否提供 index.html，如果没有找到 index.html 则返回目录列表
render-spa: true  # 是否提供单页面应用（SPA）
assets: ./assets/  # 设置用于覆盖内置资源的资源目录路径
log-format: '$remote_addr "$request" $status $http_user_agent'  # 自定义 HTTP 日志格式
log-file: ./dufs.log  # 指定日志文件保存位置
compress: low  # 设置 zip 压缩级别，默认为 low，可能的值为 none, low, medium, high
tls-cert: tests/data/cert.pem  # 指定 SSL/TLS 证书的路径以使用 HTTPS 服务
tls-key: tests/data/key_pkcs1.pem  # 指定 SSL/TLS 证书的私钥路径
```