admin管理员组文章数量:1622542
文件服务器
- 介绍
- docker安装
- 二进制安装
- API调用
介绍
项目github官网地址
Dufs是一款由Rust编写的轻量级文件服务器,不仅支持静态文件服务,还能轻松上传、下载、搜索文件,甚至支持WebDAV,让我们通过Web方式远程管理文件变得轻而易举。而且,它跨平台,无论是Windows、macOS还是Linux,都能轻松驾驭
性能特色
- 静态文件服务:一键开启,让你的文件触手可及。
- 上传下载:支持拖放上传,文件夹打包下载为zip,省时又省力。
- 文件操作:创建、编辑、搜索文件,一切尽在掌握。
- 断点续传:再也不用担心大文件传输中断了,Dufs支持断点续传,让你的下载上传无忧。
- 访问控制:灵活的权限设置,无论是公开分享还是私密访问,都能轻松搞定。
- HTTPS & WebDAV:安全传输,远程管理,一个都不能少。
docker安装
Ubuntu2404-server
该项目支持多平台安装,这里我使用docker进行快速搭建
root@huhy:~# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
sigoden/dufs latest f7f212903ad7 3 months ago 4.37MB
docker run -v `pwd`:/data -p 5000:5000 --rm sigoden/dufs /data -A
-
-v \pwd
:/data
:- -v: 这是用于挂载卷的选项。
pwd
: 这是一个命令替换,返回当前工作目录的路径。- :/data: 把主机上的当前目录(由 pwd 命令获取的路径)挂载到容器内的 /data 目录中。这样,容器可以访问主机上的这个目录中的文件。
-p 5000:5000:
-
-p: 这是用于端口映射的选项。
5000:5000: 将主机的 5000 端口映射到容器的 5000 端口。这样,主机访问 localhost:5000 时,会转发到容器的 5000 端口。 -
–rm: 这个选项指定在容器停止运行后,自动删除容器。这样可以防止积累不必要的临时容器。
-
sigoden/dufs: Docker 镜像的名称,sigoden/dufs 是镜像的全名,运行的镜像是 sigoden 用户创建的 dufs 镜像。
-
/data: 这是传递给 dufs 程序的第一个参数,表示 dufs 要共享的目录路径(这里指向容器内的 /data 目录,即挂载的主机目录)。
-
-A: 这是传递给 dufs 程序的一个选项,通常用于表示启用身份验证或匿名访问等配置(具体功能取决于 dufs 的实现)
使用home目录作为共享目录:
root@huhy:/home# ls
huhy sigoden.tar
root@huhy:/home# docker run -v `pwd`:/data -p 5000:5000 --rm sigoden/dufs /data -A
Listening on:
http://127.0.0.1:5000/
http://172.17.0.2:5000/
http://[::1]:5000/
界面IP:5000查看
win系统可界面上传
界面创建目录等
二进制安装
命令在docker环境中不能使用,因为该镜像很小,没有bash环境,如果需要使用命令,则使用其他搭建方式,有镜像需要可评论区
上传到home目录下解压
[root@localhost home]# tar -xf dufs-v0.42.0-x86_64-unknown-linux-musl.tar.gz
[root@localhost home]# ls
dufs
[root@localhost home]# ./dufs -A
Listening on:
http://127.0.0.1:5000/
http://192.168.200.100:5000/
http://[::1]:5000/
界面即可访问:IP:5000
也可以指定配置文件来启动
[root@localhost home]# cat config.yaml
serve-path: '.'
bind: 0.0.0.0
port: 5001
path-prefix: /dufs
hidden:
- tmp
- '*.log'
- '*.lock'
auth:
- 'admin:admin@/:rw'
- 'user:pass@/src:rw,/share'
- '@/'
allow-all: false
allow-upload: true
allow-delete: true
allow-search: true
allow-symlink: true
allow-archive: true
enable-cors: true
render-index: true
render-try-index: true
render-spa: true
log-format: '$remote_addr "$request" $status $http_user_agent'
log-file: ./dufs.log
compress: low
[root@localhost home]# ./dufs -c config.yaml
Listening on:
http://127.0.0.1:5001/dufs/
http://192.168.200.100:5001/dufs/
界面访问;http://IP:5001/dufs/
启用守护进程systemd
vi /etc/systemd/system/dufs.service
[Unit]
Description=dufs file server
After=network.target
[Service]
ExecStart=/home/dufs -A
Restart=always
User=root
Group=root
WorkingDirectory=/home
[Install]
WantedBy=multi-user.target
systemctl daemon-reload
终止掉刚刚启动的dufs,重新启动
[root@localhost home]# systemctl start dufs
[root@localhost home]# systemctl status dufs
● dufs.service - dufs file server
Loaded: loaded (/etc/systemd/system/dufs.service; disabled; vendor preset: disabled)
Active: active (running) since Fri 2024-09-27 09:52:02 EDT; 2s ago
Main PID: 2388 (dufs)
CGroup: /system.slice/dufs.service
└─2388 /home/dufs -A
Sep 27 09:52:02 localhost.localdomain systemd[1]: Started dufs file server.
Sep 27 09:52:02 localhost.localdomain dufs[2388]: Listening on:
Sep 27 09:52:02 localhost.localdomain dufs[2388]: http://127.0.0.1:5000/
Sep 27 09:52:02 localhost.localdomain dufs[2388]: http://192.168.200.100:5000/
Sep 27 09:52:02 localhost.localdomain dufs[2388]: http://[::1]:5000/
[root@localhost home]#
[root@localhost home]# systemctl enable --now dufs
Created symlink from /etc/systemd/system/multi-user.target.wants/dufs.service to /etc/systemd/system/dufs.service.
命令手册
Dufs is a distinctive utility file server - https://github/sigoden/dufs
Usage: dufs [OPTIONS] [serve-path]
Arguments:
[serve-path] Specific path to serve [default: .]
Options:
-c, --config <file> Specify configuration file
-b, --bind <addrs> Specify bind address or unix socket
-p, --port <port> Specify port to listen on [default: 5000]
--path-prefix <path> Specify a path prefix
--hidden <value> Hide paths from directory listings, e.g. tmp,*.log,*.lock
-a, --auth <rules> Add auth roles, e.g. user:pass@/dir1:rw,/dir2
-A, --allow-all Allow all operations
--allow-upload Allow upload files/folders
--allow-delete Allow delete files/folders
--allow-search Allow search files/folders
--allow-symlink Allow symlink to files/folders outside root directory
--allow-archive Allow zip archive generation
--enable-cors Enable CORS, sets `Access-Control-Allow-Origin: *`
--render-index Serve index.html when requesting a directory, returns 404 if not found index.html
--render-try-index Serve index.html when requesting a directory, returns directory listing if not found index.html
--render-spa Serve SPA(Single Page Application)
--assets <path> Set the path to the assets directory for overriding the built-in assets
--log-format <format> Customize http log format
--log-file <file> Specify the file to save logs to, other than stdout/stderr
--compress <level> Set zip compress level [default: low] [possible values: none, low, medium, high]
--completions <shell> Print shell completion script for <shell> [possible values: bash, elvish, fish, powershell, zsh]
--tls-cert <path> Path to an SSL/TLS certificate to serve with HTTPS
--tls-key <path> Path to the SSL/TLS certificate's private key
-h, --help Print help
-V, --version Print version
基本用法:
dufs [OPTIONS] [serve-path] serve-path: 指定要服务的路径,默认为当前目录(.)
配置相关:
-c, --config <file>: 指定配置文件
网络相关:
-b, --bind <addrs>: 指定绑定地址或unix socket
-p, --port <port>: 指定监听端口,默认5000
--path-prefix <path>: 指定路径前缀
隐藏文件:
--hidden <value>: 在目录列表中隐藏路径,如tmp,.log,.lock
权限控制:
-a, --auth <rules>: 添加认证规则,如user:pass@/dir1:rw,/dir2
-A, --allow-all: 允许所有操作
--allow-upload: 允许上传文件/文件夹
--allow-delete: 允许删除文件/文件夹
--allow-search: 允许搜索文件/文件夹
--allow-symlink: 允许链接到根目录外的文件/文件夹
--allow-archive: 允许生成zip压缩包
跨域:
--enable-cors: 启用CORS,设置Access-Control-Allow-Origin: *
渲染选项:
--render-index: 请求目录时提供index.html,找不到则返回404
--render-try-index: 请求目录时提供index.html,找不到则返回目录列表
--render-spa: 服务单页应用(SPA)
资源:
--assets <path>: 设置资源目录路径,用于覆盖内置资源
日志:
--log-format <format>: 自定义HTTP日志格式
--log-file <file>: 指定保存日志的文件
压缩:
--compress <level>: 设置zip压缩级别[默认:low] [可选值:none, low, medium, high]
Shell补全:
--completions <shell>: 打印shell补全脚本 [可选值:bash, elvish, fish, powershell, zsh]
HTTPS:
--tls-cert <path>: SSL/TLS证书路径
--tls-key <path>: SSL/TLS证书私钥路径
帮助:
-h, --help: 打印帮助信息
-V, --version: 打印版本信息
修改默认的端口
dufs . -p 8080
共享当前目录并允许所有操作(上传、删除等)
dufs -A
只允许上传:
dufs --allow-upload
指定特定目录
dufs temp
指定文件
dufs temp.doc
制定8080端口
dufs -p 8080
API调用
- 上传文件
curl -T path-to-file http://127.0.0.1:5000/new-path/path-to-file
- -T path-to-file: 上传本地文件 path-to-file 到服务器。
- http://127.0.0.1:5000/new-path/path-to-file: 将文件上传到服务器的指定路径 new-path/path-to-file。
- 下载文件
curl http://127.0.0.1:5000/path-to-file # download the file
curl http://127.0.0.1:5000/path-to-file?hash # retrieve the sha256 hash of the file
- 下载文件: 直接访问文件的 URL 将文件下载到本地。
- 获取文件的 SHA256 哈希值: 通过在 URL 后添加 ?hash,获取文件的 SHA256 哈希值,而不是文件内容。
- 下载文件夹为 ZIP 文件
curl -o path-to-folder.zip http://127.0.0.1:5000/path-to-folder?zip
- -o path-to-folder.zip: 指定下载后保存的 ZIP 文件名。
- ?zip: 在文件夹 URL 后添加 ?zip,将该文件夹打包为 ZIP 文件进行下载。
4. 删除文件/文件夹
curl -X DELETE http://127.0.0.1:5000/path-to-file-or-folder
- -X DELETE: 使用 DELETE 方法删除指定路径的文件或文件夹。
- 创建目录
curl -X MKCOL http://127.0.0.1:5000/path-to-folder
- -X MKCOL: 使用 MKCOL 方法创建一个新的目录。
- 移动文件/文件夹
curl -X MOVE http://127.0.0.1:5000/path -H "Destination: http://127.0.0.1:5000/new-path"
- -X MOVE: 使用 MOVE 方法将文件或文件夹从 path 移动到 new-path。
- -H “Destination: http://127.0.0.1:5000/new-path”: 指定新的路径(目标路径)。
- 列出/搜索目录内容
curl http://127.0.0.1:5000?q=Dockerfile # search for files, similar to `find -name Dockerfile`
curl http://127.0.0.1:5000?simple # output names only, similar to `ls -1`
curl http://127.0.0.1:5000?json # output paths in json format
- ?q=Dockerfile: 搜索目录中与 Dockerfile 匹配的文件,类似于 find -name Dockerfile。
- ?simple: 只输出文件或文件夹的名称,类似于 ls -1。
- ?json: 以 JSON 格式输出目录内容。
- 授权访问
curl http://127.0.0.1:5000/file --user user:pass # basic auth
curl http://127.0.0.1:5000/file --user user:pass --digest # digest auth
- –user user:pass: 使用基本验证,提供用户名 user 和密码 pass 进行身份验证。
- –digest: 使用摘要认证(Digest Authentication),这是更安全的一种认证方式。
- 断点续传下载
curl -C- -o file http://127.0.0.1:5000/file
- -C-: 断点续传下载,自动从上次中断处恢复下载。
- -o file: 将下载的文件保存为指定名称。
10.支持断点续传的上传 (Resumable uploads)
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
- 第一行: 获取已上传的文件大小,作为断点续传的起点。
- -I: 获取文件的头信息(header)。
- tr -d ‘\r’: 删除回车符。
- sed -n ‘s/content-length: //p’: 提取 Content-Length 头的值,表示已上传的字节数。
- 第二行: 从断点处继续上传文件。
- dd skip=$upload_offset if=file status=none ibs=1: 跳过已上传的部分,从断点处开始读取文件。
- curl -X PATCH -H “X-Update-Range: append” --data-binary @-: 使用 PATCH 方法上传文件剩余部分。
版权声明:本文标题:GitHub开源的轻量级文件服务器,可docker一键部署 内容由热心网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:https://m.elefans.com/dongtai/1728871881a1177360.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论