先说主线:一条命令,目录就成了文件站
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 即可:
# 以 Linux x86_64 为例,版本号以 Releases 页面最新为准tar -xzf dufs-*.tar.gzsudo install -m 755 dufs /usr/local/bin/dufs --version方式二:cargo 安装
cargo install dufs方式三:Homebrew(macOS / Linux)
brew install dufs方式四:Docker
官方镜像 sigoden/dufs,一条命令跑起来:
docker run -d --name dufs \ -v /srv/share:/data \ -p 5000:5000 \ --restart unless-stopped \ sigoden/dufs /data -A注意容器里的数据目录是挂载进去的 /data,命令最后的 /data -A 是传给 dufs 的参数:服务这个目录,并打开全部操作权限。生产环境不要照抄这个 -A,权限怎么收,见下面权限一节。
快速上手:从只读到可写
只读分享一个目录(最安全的起步姿势):
dufs /srv/share打开全部操作(上传、删除、搜索、新建、编辑):
dufs -A /srv/share不想一把全开,可以逐项打开,这是更推荐的粒度:
dufs /srv/share \ --allow-upload \ --allow-delete \ --allow-search \ --allow-archive常用启动参数:
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,每个账号、每组路径各一条规则。
实际例子:
# 管理员全站读写,访客只能看 /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$ 开头),先生成再填进去:
openssl passwd -6 '你的密码'# 输出形如 $6$xxxxxxxx$yyyyyyyy....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-prefix | URL 路径前缀 | 无 |
--tls-cert / --tls-key | HTTPS 证书与私钥 | 无 |
-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/sharebind: 127.0.0.1port: 5000allow-upload: trueallow-delete: trueallow-search: trueallow-archive: truehidden: .git,*.logauth: - admin:强密码@/:rw - guest:guest123@/public:ro再写 unit 文件 /etc/systemd/system/dufs.service:
[Unit]Description=dufs file serverAfter=network.target
[Service]ExecStart=/usr/local/bin/dufs -c /etc/dufs/config.yamlRestart=on-failureUser=dufsGroup=dufs
[Install]WantedBy=multi-user.targetsudo systemctl daemon-reloadsudo systemctl enable --now dufssystemctl status dufs绑 127.0.0.1 再用 Nginx/Caddy 反代出去、套上域名和 HTTPS,是自建服务的标准入口做法;dufs 自己也能直接上 HTTPS:
dufs /srv/share --tls-cert /path/fullchain.pem --tls-key /path/privkey.pemWebDAV:同一个地址直接挂载
不用额外配置,dufs 的服务地址本身就是 WebDAV 端点:
http://你的域名:5000/Windows 资源管理器、macOS Finder、手机文件 App 添加网络位置/服务器时填这个地址,再填 -a 里配的账号密码即可。需要提醒的是,WebDAV 的读写同样受 --allow-* 全局开关和账号规则约束:只读模式起的服务,挂载上去也只能读。
和本系列上一篇 Davflare 对比一下就有意思了:Davflare 是把 WebDAV 放在 Cloudflare 边缘、文件存 R2,零服务器但单文件有上限;dufs 是把 WebDAV 放在自己机器上,文件就在本地硬盘,没有单文件限制,代价是机器得自己开着。两者一个云上一个本地,正好互补。
curl API:脚本里传文件全靠它
dufs 对 curl 极其友好,常用操作各一行:
# 上传文件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 格式列目录
# 取文件 sha256curl '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 加偏移头:
# 先查已上传的字节数,再从断点接着传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健康检查端点是现成的,监控可以直接探:
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 就是你可以放心常驻在服务器上的小工具。