2717 字
14 分钟
dufs:一个二进制就是一台带 WebDAV 的文件服务器
2026-11-16

先说主线:一条命令,目录就成了文件站#

Terminal window
dufs -A /srv/share

就这一行。/srv/share 立刻变成一个带网页界面的文件站:浏览器打开能浏览、拖拽上传、打包下载,同一个地址还是一个 WebDAV 服务端,电脑和手机可以直接挂载。没有数据库要装,没有配置文件要先写,没有运行时要配——dufs 是 Rust 写的一个单二进制文件,这就是它和传统网盘最大的区别:别的网盘是「部署一套系统」,dufs 是「运行一个命令」。

项目地址:https://github.com/sigoden/dufs

它适合的场景很明确:临时给同事传一批文件、把服务器上某个目录开放给自己远程取用、给下载站当静态文件源、内网里快速起一个带权限的共享盘。它不做用户注册、不做相册、不做在线文档——那些是 Cloudreve 和 Nextcloud 的活。dufs 只做文件服务本身,并且把这一件事做到了极简。

它能干什么#

  • 静态文件服务:目录浏览、单文件分发,也可以托管静态站点。
  • 上传与编辑:拖拽上传文件和文件夹,网页里新建、编辑、删除、重命名、搜索文件。
  • 打包下载:整个文件夹一键打成 zip 下载。
  • 断点续传:上传和下载都支持断点续传,传大文件断了不用重来。
  • 访问控制:按账号、按目录粒度设置只读/读写权限,支持匿名公开指定目录。
  • WebDAV:同一端口直接提供 WebDAV,系统自带的文件管理器就能挂载。
  • HTTPS:参数直接指定证书就能上 HTTPS,不强制依赖反向代理。
  • curl 友好:全部功能都有对应的 HTTP 接口,脚本里一行 curl 就能上传下载。

默认监听端口是 5000。最关键的一条默认行为:不开任何 --allow-* 参数时,dufs 是纯只读的,访客只能看和下载;写操作必须显式打开,这个默认值对公网暴露非常友好。

安装:四种方式,任选其一#

方式一:下载官方二进制(最推荐)#

去 GitHub Releases 下载对应平台的压缩包,解压后把 dufs 放进 PATH 即可:

Terminal window
# 以 Linux x86_64 为例,版本号以 Releases 页面最新为准
tar -xzf dufs-*.tar.gz
sudo install -m 755 dufs /usr/local/bin/
dufs --version

方式二:cargo 安装#

Terminal window
cargo install dufs

方式三:Homebrew(macOS / Linux)#

Terminal window
brew install dufs

方式四:Docker#

官方镜像 sigoden/dufs,一条命令跑起来:

Terminal window
docker run -d --name dufs \
-v /srv/share:/data \
-p 5000:5000 \
--restart unless-stopped \
sigoden/dufs /data -A

注意容器里的数据目录是挂载进去的 /data,命令最后的 /data -A 是传给 dufs 的参数:服务这个目录,并打开全部操作权限。生产环境不要照抄这个 -A,权限怎么收,见下面权限一节。

快速上手:从只读到可写#

只读分享一个目录(最安全的起步姿势):

Terminal window
dufs /srv/share

打开全部操作(上传、删除、搜索、新建、编辑):

Terminal window
dufs -A /srv/share

不想一把全开,可以逐项打开,这是更推荐的粒度:

Terminal window
dufs /srv/share \
--allow-upload \
--allow-delete \
--allow-search \
--allow-archive

常用启动参数:

Terminal window
dufs /srv/share -b 127.0.0.1 -p 8080 # 只绑本机、换端口
dufs /srv/share --path-prefix /files # 挂到 /files 前缀下,方便反代
dufs /srv/share --hidden '.git,*.log,tmp' # 目录列表里隐藏这些路径
dufs /srv/share --render-index # 目录下有 index.html 时当静态站托管

权限规则:-a 一条参数管全部#

dufs 的访问控制全靠 -a(--auth)参数,格式是:

账号:密码@路径1:权限,路径2:权限
  • @ 前面是账号密码,匿名访客不写账号、直接写 @/。
  • 路径后缀 :rw 表示读写、:ro 表示只读,:ro 可以省略(不写后缀默认只读)。
  • 一条命令可以写多个 -a,每个账号、每组路径各一条规则。

实际例子:

Terminal window
# 管理员全站读写,访客只能看 /public,且必须登录
dufs /srv/share -A \
-a 'admin:强密码@/:rw' \
-a 'guest:guest123@/public'
# 完全公开只读(任何人免登录浏览下载)
dufs /srv/share -a '@/'
# 某账号对根目录读写、但对 /private 只读
dufs /srv/share -A \
-a 'alice:密码@/:rw,/private:ro'

有一条容易踩的上下级关系必须记住:--allow-* 全局开关是权限上限,账号规则里的 :rw 突破不了它。比如你没加 --allow-upload,哪怕给 admin 配了 :rw,他也传不了文件——想让人能写,先开全局开关,再在账号规则里收口子。

密码用哈希,别写明文#

-a 支持 sha-512 哈希密码($6$ 开头),先生成再填进去:

Terminal window
openssl passwd -6 '你的密码'
# 输出形如 $6$xxxxxxxx$yyyyyyyy....
Terminal window
dufs /srv/share -A -a 'admin:$6$xxxxxxxx$yyyyyyyy....@/:rw'

两个注意点:哈希串里有 $,写进命令时必须用单引号包住,防 shell 把它当变量展开;另外哈希密码下 Digest 认证不可用,客户端请走 Basic 认证。

WARNING

-A 全开放绝对不要裸奔公网。 -A 意味着上传、删除、编辑全部打开,如果再不配 --auth,任何人扫到你的 5000 端口就能往你硬盘里写文件、删文件。公网使用只有两种正确姿势:要么 -A 加完整的 -a 账号规则,要么只绑 127.0.0.1 再走反向代理加认证。图省事裸奔,被人当免费图床和跳板只是时间问题。

参数速查表#

参数作用默认
-p, --port监听端口5000
-b, --bind绑定地址,可绑多个或 Unix socket全部地址
-A, --allow-all打开全部操作(上传/删除/搜索/打包等)关
--allow-upload允许上传关
--allow-delete允许删除关
--allow-search允许搜索关
--allow-archive允许文件夹打包下载关
--allow-symlink允许符号链接指向根目录外关
-a, --auth账号与路径权限规则,可多次使用无
--hidden目录列表中隐藏的路径(逗号分隔,支持通配)无
--path-prefixURL 路径前缀无
--tls-cert / --tls-keyHTTPS 证书与私钥无
-c, --config指定 YAML 配置文件无
--render-index目录请求时返回 index.html(静态站模式)关
--render-spa单页应用模式关
--log-file访问日志写入文件输出到终端

所有参数都可以用 DUFS_ 前缀的环境变量代替(比如 DUFS_PORT=5000、DUFS_AUTH=...),参数多起来后更推荐写配置文件,下一节就讲。

长期运行:systemd 托管 + 配置文件#

临时用用命令行足够;要常驻,按老规矩交给 systemd。先把启动参数收进一份 YAML 配置文件 /etc/dufs/config.yaml:

serve-path: /srv/share
bind: 127.0.0.1
port: 5000
allow-upload: true
allow-delete: true
allow-search: true
allow-archive: true
hidden: .git,*.log
auth:
- admin:强密码@/:rw
- guest:guest123@/public:ro

再写 unit 文件 /etc/systemd/system/dufs.service:

[Unit]
Description=dufs file server
After=network.target
[Service]
ExecStart=/usr/local/bin/dufs -c /etc/dufs/config.yaml
Restart=on-failure
User=dufs
Group=dufs
[Install]
WantedBy=multi-user.target
Terminal window
sudo systemctl daemon-reload
sudo systemctl enable --now dufs
systemctl status dufs

绑 127.0.0.1 再用 Nginx/Caddy 反代出去、套上域名和 HTTPS,是自建服务的标准入口做法;dufs 自己也能直接上 HTTPS:

Terminal window
dufs /srv/share --tls-cert /path/fullchain.pem --tls-key /path/privkey.pem

WebDAV:同一个地址直接挂载#

不用额外配置,dufs 的服务地址本身就是 WebDAV 端点:

http://你的域名:5000/

Windows 资源管理器、macOS Finder、手机文件 App 添加网络位置/服务器时填这个地址,再填 -a 里配的账号密码即可。需要提醒的是,WebDAV 的读写同样受 --allow-* 全局开关和账号规则约束:只读模式起的服务,挂载上去也只能读。

和本系列上一篇 Davflare 对比一下就有意思了:Davflare 是把 WebDAV 放在 Cloudflare 边缘、文件存 R2,零服务器但单文件有上限;dufs 是把 WebDAV 放在自己机器上,文件就在本地硬盘,没有单文件限制,代价是机器得自己开着。两者一个云上一个本地,正好互补。

curl API:脚本里传文件全靠它#

dufs 对 curl 极其友好,常用操作各一行:

Terminal window
# 上传文件
curl -T local-file.zip http://127.0.0.1:5000/dir/remote-file.zip
# 下载文件
curl -O http://127.0.0.1:5000/dir/remote-file.zip
# 文件夹打包下载
curl -o dir.zip 'http://127.0.0.1:5000/dir?zip'
# 删除文件
curl -X DELETE http://127.0.0.1:5000/dir/file.txt
# 新建目录
curl -X MKCOL http://127.0.0.1:5000/new-dir
# 移动/重命名
curl -X MOVE http://127.0.0.1:5000/old.txt -H 'Destination: http://127.0.0.1:5000/new.txt'
# 搜索与列表
curl 'http://127.0.0.1:5000/?q=报告' # 按名搜索
curl 'http://127.0.0.1:5000/dir?json' # JSON 格式列目录
# 取文件 sha256
curl 'http://127.0.0.1:5000/file.iso?hash'
# 带账号密码
curl -T file.zip --user admin:密码 http://127.0.0.1:5000/file.zip

断点续传下载用 curl -C -;断点续传上传走 PATCH 加偏移头:

Terminal window
# 先查已上传的字节数,再从断点接着传
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

健康检查端点是现成的,监控可以直接探:

Terminal window
curl http://127.0.0.1:5000/__dufs__/health

和其他方案的分工#

需求更合适
临时分享一个目录、快速起文件站dufs(本篇)
长期私人网盘、分享链接、存储策略Cloudreve
给一堆既有存储(S3/WebDAV/SFTP)套统一网页界面Filestash
零服务器、文件放云端对象存储Davflare

一句话:dufs 是文件服务器里的「瑞士军刀小刀」——不替代正经网盘,但任何需要「马上把目录开放出来」的场合,它都是最快的答案。

排障清单#

  • 网页能看但传不了文件:没开 --allow-upload(或没用 -A)。记住全局开关是上限,先开开关再谈账号权限。
  • 账号明明配了 :rw 还是只读:同上,多半是对应的 --allow-* 没开;或者路径规则写错——路径是相对服务根目录的,且更具体的路径规则优先生效。
  • 登录一直失败:哈希密码的命令没加单引号,被 shell 展开坏了;或者客户端在用 Digest 认证而你用的是哈希密码,改走 Basic。
  • 挂载 WebDAV 能连但写不进去:检查 --allow-upload 与账号对该路径是否有 :rw;另外确认客户端填的是服务根地址而不是某个子目录的分享链接。
  • Docker 里挂载的目录在网页上是空的:宿主机目录权限问题,或 -v 路径写错;容器内以 root 运行一般能读,先 docker exec 进去 ls /data 确认。
  • 反代后上传大文件失败:反向代理的请求体大小限制(Nginx 的 client_max_body_size)在拦,把它调到与需求匹配或关掉。
  • 端口冲突/起不来:ss -tlnp | grep 5000 看谁占着,换 -p 端口即可。

小结#

dufs 把文件服务压缩到了极限:一个二进制、一条命令、零依赖,静态托管、上传下载、断点续传、权限规则、WebDAV、HTTPS 全都在里面。它不会取代 Cloudreve、Nextcloud 这类正经网盘,但作为「随手把目录变文件站」的工具,目前很难找到第二个这么利落的。用的时候只记一条铁律:开写权限必配账号规则,-A 永不裸奔——守住这条,dufs 就是你可以放心常驻在服务器上的小工具。

dufs:一个二进制就是一台带 WebDAV 的文件服务器
https://www.anexns.cloudns.org/posts/clouddrive-dufs/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0