[{"_1":2,"_213":-5,"_214":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_196":197},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)",{"_23":24,"_25":26,"_100":101,"_129":-7,"_130":-7,"_131":-7,"_132":-7,"_133":-5,"_134":-5,"_135":11,"_136":11,"_94":137,"_188":11,"_159":89,"_189":158,"_190":93,"_31":42,"_191":11,"_192":17,"_193":44,"_194":-5,"_195":11},"scanningType","none","tagData",{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_85":86,"_87":30,"_88":89,"_90":91,"_92":93,"_94":95,"_96":46,"_97":86,"_98":55,"_99":17},"content_type","image","creator",326639,"digest","sha256:8dd3b750015734703e64b55641fb7d2254c112e0ff3967074766177dc15dc982","full_size",2965974,"id",237431708,"images",[39,57,63,70,76,80],{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},"architecture","amd64","sha256:5ac1f2b072da0bd05c81a3184fab90aa5676b3317d0a8de05914a7d71b93bf33","features","","last_pulled","2026-09-20T13:10:16.484027737Z","last_pushed","2026-05-07T01:54:35.762657348Z","os","linux","os_features","os_version","size","status","active","variant",{"_40":58,"_31":59,"_43":44,"_45":60,"_47":61,"_49":50,"_51":44,"_52":-5,"_53":62,"_54":55,"_56":-5},"arm64","sha256:bc2638d0e3df821a970136afdf40fead293bf10880db80bc3e855acb34b989be","2026-09-20T13:02:32.784337665Z","2026-05-07T01:54:34.637262171Z",2721873,{"_40":64,"_31":65,"_43":44,"_45":66,"_47":67,"_49":50,"_51":44,"_52":-5,"_53":68,"_54":55,"_56":69},"arm","sha256:402e6f4cc23b36ab1b3a6ef941d577d7fd34cdc7a402ca05caa06c0081116521","2026-09-20T13:02:33.020144197Z","2026-05-07T01:54:34.267844471Z",2392219,"v7",{"_40":71,"_31":72,"_43":44,"_45":73,"_47":74,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},"unknown","sha256:0a10eb204c77c29538d63c28e77541e72ae303137b20c389d36696c15bf7a8a9","2026-09-20T13:02:33.258472155Z","2026-05-07T01:54:35.386733004Z",13747,{"_40":71,"_31":77,"_43":44,"_45":78,"_47":79,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},"sha256:2cc723f6f633c04a6d75ab0bf00b82b4cca80360a48cada5d0c7a8798cad643c","2026-09-20T13:02:33.481007719Z","2026-05-07T01:54:34.982784668Z",{"_40":71,"_31":81,"_43":44,"_45":82,"_47":83,"_49":71,"_51":44,"_52":-5,"_53":84,"_54":55,"_56":-5},"sha256:96ddbb00425c0e6c3f532cee6cf77b653b4079a09c334796dfff119a925f509e","2026-09-20T13:02:33.718657647Z","2026-05-07T01:54:36.086408177Z",13783,"last_updated","2026-05-07T01:54:36.824235Z","last_updater","last_updater_username","sigoden","media_type","application/vnd.oci.image.index.v1+json","name","latest","repository",17399310,"tag_last_pulled","tag_last_pushed","tag_status","v2","tagImages",[102,114,120,126,127,128],{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_103":104,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},"layers",[105,109,112],{"_31":106,"_53":34,"_107":108},"sha256:72320bf31c6a7ca99e6d4d2e5cc44d2fb8d62c0ecaec88f68afb6c0f38b4e4f9","instruction","COPY /bin/dufs /bin/dufs # buildkit",{"_53":110,"_107":111,"_31":44},0,"STOPSIGNAL SIGINT",{"_53":110,"_107":113,"_31":44},"ENTRYPOINT [\"/bin/dufs\"]",{"_40":58,"_31":59,"_43":44,"_45":60,"_47":61,"_103":115,"_49":50,"_51":44,"_52":-5,"_53":62,"_54":55,"_56":-5},[116,118,119],{"_31":117,"_53":62,"_107":108},"sha256:a0d0487d99c8bf6461e9bbb7ea932a9fa19f458889a872234eb13ae97e96a847",{"_53":110,"_107":111,"_31":44},{"_53":110,"_107":113,"_31":44},{"_40":64,"_31":65,"_43":44,"_45":66,"_47":67,"_103":121,"_49":50,"_51":44,"_52":-5,"_53":68,"_54":55,"_56":69},[122,124,125],{"_31":123,"_53":68,"_107":108},"sha256:87cfe3ee3a233773bdf8624d403d8b2bffbe2351d636f588829fe9dc071d9ece",{"_53":110,"_107":111,"_31":44},{"_53":110,"_107":113,"_31":44},{"_40":71,"_31":72,"_43":44,"_45":73,"_47":74,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},{"_40":71,"_31":77,"_43":44,"_45":78,"_47":79,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},{"_40":71,"_31":81,"_43":44,"_45":82,"_47":83,"_49":71,"_51":44,"_52":-5,"_53":84,"_54":55,"_56":-5},"layerOrdinals","packageName","cveId","sbom","scoutSummary","staticSummary","isScoutPaymentRequired","canSeeVulnerabilities",{"_138":139,"_144":145,"_146":147,"_148":149,"_150":11,"_85":151,"_152":153,"_154":155,"_92":158,"_159":89,"_160":161,"_162":28,"_163":164,"_54":165,"_166":55,"_167":-5,"_168":110,"_169":170,"_171":11,"_172":89,"_173":174,"_179":11,"_180":181,"_185":89,"_186":187},"categories",[140],{"_92":141,"_142":143},"Web servers","slug","web-servers","content_types",[28],"date_registered","2022-06-19T15:40:24.505543Z","description","Dufs is a file server supports static serving, uploading, searching, accessing control, webdav...","is_private","2026-05-07T01:54:40.721583Z","last_modified","2024-11-05T09:24:16.654144Z","media_types",[156,157,91],"application/vnd.docker.container.image.v1+json","application/vnd.docker.distribution.manifest.list.v2+json","dufs","namespace","pull_count",1309375,"repository_type","star_count",28,1,"status_description","source","collaborator_count","full_description","# Dufs\n\n[![CI](https://github.com/sigoden/dufs/actions/workflows/ci.yaml/badge.svg)](https://github.com/sigoden/dufs/actions/workflows/ci.yaml)\n[![Crates](https://img.shields.io/crates/v/dufs.svg)](https://crates.io/crates/dufs)\n\nDufs is a distinctive utility file server that supports static serving, uploading, searching, accessing control, webdav...\n\n![demo](https://user-images.githubusercontent.com/4012553/220513063-ff0f186b-ac54-4682-9af4-47a9781dee0d.png)\n\n## Usage\n\n### With docker\n\n```\ndocker run -v `pwd`:/data -p 5000:5000 --rm -it sigoden/dufs /data -A\n```\n\n### With docker-compose\n\n```yaml\nversion: '3'\nservices:\n dufs:\n image: sigoden/dufs\n ports:\n - 5000:5000\n volumes:\n - .:/data\n command: /data -A\n```\n\n## Features\n\n- Serve static files\n- Download folder as zip file\n- Upload files and folders (Drag & Drop)\n- Create/Edit/Search files\n- Partial responses (Parallel/Resume download)\n- Access control\n- Support https\n- Support webdav\n- Easy to use with curl\n\n## CLI\n\n```\nDufs is a distinctive utility file server - https://github.com/sigoden/dufs\n\nUsage: dufs [OPTIONS] [serve-path]\n\nArguments:\n [serve-path] Specific path to serve [default: .]\n\nOptions:\n -c, --config Specify configuration file\n -b, --bind Specify bind address or unix socket\n -p, --port Specify port to listen on [default: 5000]\n --path-prefix Specify a path prefix\n --hidden Hide paths from directory listings, e.g. tmp,*.log,*.lock\n -a, --auth Add auth roles, e.g. user:pass@/dir1:rw,/dir2\n -A, --allow-all Allow all operations\n --allow-upload Allow upload files/folders\n --allow-delete Allow delete files/folders\n --allow-search Allow search files/folders\n --allow-symlink Allow symlink to files/folders outside root directory\n --allow-archive Allow zip archive generation\n --enable-cors Enable CORS, sets `Access-Control-Allow-Origin: *`\n --render-index Serve index.html when requesting a directory, returns 404 if not found index.html\n --render-try-index Serve index.html when requesting a directory, returns directory listing if not found index.html\n --render-spa Serve SPA(Single Page Application)\n --assets Set the path to the assets directory for overriding the built-in assets\n --log-format Customize http log format\n --log-file Specify the file to save logs to, other than stdout/stderr\n --compress Set zip compress level [default: low] [possible values: none, low, medium, high]\n --completions Print shell completion script for [possible values: bash, elvish, fish, powershell, zsh]\n --tls-cert Path to an SSL/TLS certificate to serve with HTTPS\n --tls-key Path to the SSL/TLS certificate's private key\n -h, --help Print help\n -V, --version Print version\n```\n\n## Examples\n\nServe current working directory in read-only mode\n\n```\ndufs\n```\n\nAllow all operations like upload/delete/search/create/edit...\n\n```\ndufs -A\n```\n\nOnly allow upload operation\n\n```\ndufs --allow-upload\n```\n\nServe a specific directory\n\n```\ndufs Downloads\n```\n\nServe a single file\n\n```\ndufs linux-distro.iso\n```\n\nServe a single-page application like react/vue\n\n```\ndufs --render-spa\n```\n\nServe a static website with index.html\n\n```\ndufs --render-index\n```\n\nRequire username/password\n\n```\ndufs -a admin:123@/:rw\n```\n\nListen on specific host:ip \n\n```\ndufs -b 127.0.0.1 -p 80\n```\n\nListen on unix socket\n```\ndufs -b /tmp/dufs.socket\n```\n\nUse https\n\n```\ndufs --tls-cert my.crt --tls-key my.key\n```\n\n## API\n\nUpload a file\n\n```sh\ncurl -T path-to-file http://127.0.0.1:5000/new-path/path-to-file\n```\n\nDownload a file\n```sh\ncurl http://127.0.0.1:5000/path-to-file # download the file\ncurl http://127.0.0.1:5000/path-to-file?hash # retrieve the sha256 hash of the file\n```\n\nDownload a folder as zip file\n\n```sh\ncurl -o path-to-folder.zip http://127.0.0.1:5000/path-to-folder?zip\n```\n\nDelete a file/folder\n\n```sh\ncurl -X DELETE http://127.0.0.1:5000/path-to-file-or-folder\n```\n\nCreate a directory\n\n```sh\ncurl -X MKCOL http://127.0.0.1:5000/path-to-folder\n```\n\nMove the file/folder to the new path\n\n```sh\ncurl -X MOVE http://127.0.0.1:5000/path -H \"Destination: http://127.0.0.1:5000/new-path\"\n```\n\nList/search directory contents\n\n```sh\ncurl http://127.0.0.1:5000?q=Dockerfile # search for files, similar to `find -name Dockerfile`\ncurl http://127.0.0.1:5000?simple # output names only, similar to `ls -1`\ncurl http://127.0.0.1:5000?json # output paths in json format\n```\n\nWith authorization (Both basic or digest auth works)\n\n```sh\ncurl http://127.0.0.1:5000/file --user user:pass # basic auth\ncurl http://127.0.0.1:5000/file --user user:pass --digest # digest auth\n```\n\nResumable downloads\n\n```sh\ncurl -C- -o file http://127.0.0.1:5000/file\n```\n\nResumable uploads\n\n```sh\nupload_offset=$(curl -I -s http://127.0.0.1:5000/file | tr -d '\\r' | sed -n 's/content-length: //p')\ndd skip=$upload_offset if=file status=none ibs=1 | \\\n curl -X PATCH -H \"X-Update-Range: append\" --data-binary @- http://127.0.0.1:5000/file\n```\n\nHealth checks\n\n```sh\ncurl http://127.0.0.1:5000/__dufs__/health\n```\n\n## Environment variables\n\nAll options can be set using environment variables prefixed with `DUFS_`.\n\n```\n[serve-path] DUFS_SERVE_PATH=\".\"\n --config DUFS_CONFIG=config.yaml\n-b, --bind DUFS_BIND=0.0.0.0\n-p, --port DUFS_PORT=5000\n --path-prefix DUFS_PATH_PREFIX=/dufs\n --hidden DUFS_HIDDEN=tmp,*.log,*.lock\n-a, --auth DUFS_AUTH=\"admin:admin@/:rw|@/\" \n-A, --allow-all DUFS_ALLOW_ALL=true\n --allow-upload DUFS_ALLOW_UPLOAD=true\n --allow-delete DUFS_ALLOW_DELETE=true\n --allow-search DUFS_ALLOW_SEARCH=true\n --allow-symlink DUFS_ALLOW_SYMLINK=true\n --allow-archive DUFS_ALLOW_ARCHIVE=true\n --enable-cors DUFS_ENABLE_CORS=true\n --render-index DUFS_RENDER_INDEX=true\n --render-try-index DUFS_RENDER_TRY_INDEX=true\n --render-spa DUFS_RENDER_SPA=true\n --assets DUFS_ASSETS=./assets\n --log-format DUFS_LOG_FORMAT=\"\"\n --log-file DUFS_LOG_FILE=./dufs.log\n --compress DUFS_COMPRESS=low\n --tls-cert DUFS_TLS_CERT=cert.pem\n --tls-key DUFS_TLS_KEY=key.pem\n```\n## Configuration File\n\nYou can specify and use the configuration file by selecting the option `--config `.\n\nThe following are the configuration items:\n\n```yaml\nserve-path: '.'\nbind: 0.0.0.0\nport: 5000\npath-prefix: /dufs\nhidden:\n - tmp\n - '*.log'\n - '*.lock'\nauth:\n - admin:admin@/:rw\n - user:pass@/src:rw,/share\n - '@/' # According to the YAML spec, quoting is required.\nallow-all: false\nallow-upload: true\nallow-delete: true\nallow-search: true\nallow-symlink: true\nallow-archive: true\nenable-cors: true\nrender-index: true\nrender-try-index: true\nrender-spa: true\nassets: ./assets/\nlog-format: '$remote_addr \"$request\" $status $http_user_agent'\nlog-file: ./dufs.log\ncompress: low\ntls-cert: tests/data/cert.pem\ntls-key: tests/data/key_pkcs1.pem\n```","has_starred","hub_user","immutable_tags_settings",{"_175":11,"_176":177},"enabled","rules",[178],".*","is_automated","permissions",{"_182":17,"_183":11,"_184":11},"read","write","admin","user","storage_size",187960283,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_23":24,"_131":-7,"_129":-7,"_130":-7,"_25":198,"_31":42,"_206":207,"_212":11},{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":199,"_85":86,"_87":30,"_88":89,"_90":91,"_92":93,"_94":95,"_96":46,"_97":86,"_98":55,"_99":17},[200,201,202,203,204,205],{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},{"_40":58,"_31":59,"_43":44,"_45":60,"_47":61,"_49":50,"_51":44,"_52":-5,"_53":62,"_54":55,"_56":-5},{"_40":64,"_31":65,"_43":44,"_45":66,"_47":67,"_49":50,"_51":44,"_52":-5,"_53":68,"_54":55,"_56":69},{"_40":71,"_31":72,"_43":44,"_45":73,"_47":74,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},{"_40":71,"_31":77,"_43":44,"_45":78,"_47":79,"_49":71,"_51":44,"_52":-5,"_53":75,"_54":55,"_56":-5},{"_40":71,"_31":81,"_43":44,"_45":82,"_47":83,"_49":71,"_51":44,"_52":-5,"_53":84,"_54":55,"_56":-5},"imageWithLayers",{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_103":208,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},[209,210,211],{"_31":106,"_53":34,"_107":108},{"_53":110,"_107":111,"_31":44},{"_53":110,"_107":113,"_31":44},"hasPermissionToViewRepoSettings","actionData","errors"]

sigoden/dufs:latest