[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-5561":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},5561,"miniserve","svenstaro\u002Fminiserve","svenstaro","🌟 For when you really just want to serve some files over HTTP right now!","",null,"Rust",7649,382,47,76,0,3,14,61,15,38.75,"MIT License",false,"master",[26,27,28,29,30,31,32],"cli","command-line","command-line-tool","http-server","serve","server","static-files","2026-06-12 02:01:12","\u003Cp align=\"center\">\n  \u003Cimg src=\"data\u002Flogo.svg\" alt=\"miniserve - a CLI tool to serve files and dirs over HTTP\">\u003Cbr>\n\u003C\u002Fp>\n\n# miniserve - a CLI tool to serve files and dirs over HTTP\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Fworkflows\u002FCI\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Factions)\n[![Docker Hub](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fsvenstaro\u002Fminiserve)](https:\u002F\u002Fcloud.docker.com\u002Frepository\u002Fdocker\u002Fsvenstaro\u002Fminiserve\u002F)\n[![Crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fminiserve.svg)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fminiserve)\n[![license](http:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Fblob\u002Fmaster\u002FLICENSE)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsvenstaro\u002Fminiserve.svg)](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Fstargazers)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Fsvenstaro\u002Fminiserve\u002Ftotal.svg)](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Freleases)\n[![Lines of Code](https:\u002F\u002Ftokei.rs\u002Fb1\u002Fgithub\u002Fsvenstaro\u002Fminiserve)](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve)\n\n**For when you really just want to serve some files over HTTP right now!**\n\n**miniserve** is a small, self-contained cross-platform CLI tool that allows you to just grab the binary and serve some file(s) via HTTP.\nSometimes this is just a more practical and quick way than doing things properly.\n\n## Screenshot\n\n![Screenshot](screenshot.png)\n\n## How to use\n\n### Serve a directory:\n\n    miniserve linux-distro-collection\u002F\n\n### Serve a single file:\n\n    miniserve linux-distro.iso\n\n### Set a custom index file to serve instead of a file listing:\n\n    miniserve --index test.html\n\n### Serve an SPA (Single Page Application) so that non-existent paths are forwarded to the SPA's router instead\n\n    miniserve --spa --index index.html\n\n### Require username\u002Fpassword:\n\n    miniserve --auth joe:123 unreleased-linux-distros\u002F\n\n### Require username\u002Fpassword as hash:\n\n    pw=$(echo -n \"123\" | sha256sum | cut -f 1 -d ' ')\n    miniserve --auth joe:sha256:$pw unreleased-linux-distros\u002F\n\n### Require username\u002Fpassword from file (separate logins with new lines):\n\n    miniserve --auth-file auth.txt unreleased-linux-distros\u002F\n\n### Generate random 6-hexdigit URL:\n\n    miniserve -i 192.168.0.1 --random-route \u002Ftmp\n    # Serving path \u002Fprivate\u002Ftmp at http:\u002F\u002F192.168.0.1\u002Fc789b6\n\n### Bind to multiple interfaces:\n\n    miniserve -i 192.168.0.1 -i 10.13.37.10 -i ::1 \u002Ftmp\u002Fmyshare\n\n### Insert custom headers\n\n    miniserve --header \"Cache-Control:no-cache\" --header \"X-Custom-Header:custom-value\" -p 8080 \u002Ftmp\u002Fmyshare\n    # Check headers in another terminal\n    curl -I http:\u002F\u002Flocalhost:8080\n\nIf a header is already set or previously inserted, it will not be overwritten.\n\n### Start with TLS:\n\n    miniserve --tls-cert my.cert --tls-key my.key \u002Ftmp\u002Fmyshare\n    # Fullchain TLS and HTTP Strict Transport Security (HSTS)\n    miniserve --tls-cert fullchain.pem --tls-key my.key --header \"Strict-Transport-Security: max-age=31536000; includeSubDomains; preload\" \u002Ftmp\u002Fmyshare\n\nIf the parameter value has spaces, be sure to wrap it in quotes.\n(To achieve an A+ rating at https:\u002F\u002Fwww.ssllabs.com\u002Fssltest\u002F, enabling both fullchain TLS and HSTS is necessary.)\n\n### Upload a file using `curl`:\n\n    # in one terminal\n    miniserve -u -- .\n    # in another terminal\n    curl -F \"path=@$FILE\" http:\u002F\u002Flocalhost:8080\u002Fupload\\?path\\=\u002F\n\n(where `$FILE` is the path to the file. This uses miniserve's default port of 8080)\n\nNote that for uploading, we have to use `--` to disambiguate the argument to `-u`.\nThis is because `-u` can also take a path (or multiple). If a path argument to `-u` is given,\nuploading will only be possible to the provided paths as opposed to every path.\n\nAnother effect of this is that you can't just combine flags like this `-uv` when `-u` is used. In\nthis example, you'd need to use `-u -v`.\n\n### Create a directory using `curl`:\n\n    # in one terminal\n    miniserve --upload-files --mkdir .\n    # in another terminal\n    curl -F \"mkdir=$DIR_NAME\" http:\u002F\u002Flocalhost:8080\u002Fupload\\?path=\\\u002F\n\n(where `$DIR_NAME` is the name of the directory. This uses miniserve's default port of 8080.)\n\n### Use the raw renderer for use with simple viewers\n\nYou can pass `?raw=true` with requests where you only require minimal HTML output for CLI-based browsers such as `lynx` or `w3m`.\nThis is enabled by default without any extra flags:\n\n    miniserve .\n    curl http:\u002F\u002Flocalhost:8080?raw=true\n\nYou can enable a convenient copy-pastable footer for `wget` using `--show-wget-footer`:\n\n    miniserve --show-wget-footer .\n\nAfterwards, check the bottom of any rendered page.\nIt'll have a neat `wget` command you can easily copy-paste to recursively grab the current directory.\n\n### Use query parameter to do a simple filter\n\nYou can pass a `?search=\u003Ckeyword>` query parameter to only show files and directories whose name contains the `\u003Ckeyword>`, for example:\n\n    miniserve .\n    # Then visit http:\u002F\u002F127.0.0.1:8080\u002Fsrc\u002F?search=file\n\nThis filter feature is case insensitive.\n\n### Take pictures and upload them from smartphones:\n\n    miniserve -u -m image -q\n\nThis uses the `--media-type` option, which sends a hint for the expected media type to the browser.\nSome mobile browsers like Firefox on Android will offer to open the camera app when seeing this.\n\n## Features\n\n- Easy to use\n- Just works: Correct MIME types handling out of the box\n- Single binary drop-in with no extra dependencies required\n- Authentication support with username and password (and hashed password)\n- Mega fast and highly parallel (thanks to [Rust](https:\u002F\u002Fwww.rust-lang.org\u002F) and [Actix](https:\u002F\u002Factix.rs\u002F))\n- Search\u002Ffilter by file or directory name\n- Folder download (compressed on the fly as `.tar.gz` or `.zip`)\n- File uploading\n- Directory creation\n- Pretty themes (with light and dark theme support)\n- Scan QR code for quick access\n- Shell completions\n- Sane and secure defaults\n- TLS (for supported architectures)\n- Supports README.md rendering like on GitHub\n- Range requests\n- WebDAV support\n- Healthcheck route (at `\u002F__miniserve_internal\u002Fhealthcheck`)\n\n## Usage\n\n```\nFor when you really just want to serve some files over HTTP right now!\n\nUsage: miniserve [OPTIONS] [PATH]\n\nArguments:\n  [PATH]\n          Which path to serve\n\n          [env: MINISERVE_PATH=]\n\nOptions:\n  -v, --verbose\n          Be verbose, includes emitting access logs\n\n          [env: MINISERVE_VERBOSE=]\n\n      --temp-directory \u003CTEMP_UPLOAD_DIRECTORY>\n          The path to where file uploads will be written to before being moved to their correct location. It's wise to make sure that this\n          directory will be written to disk and not into memory.\n\n          This value will only be used **IF** file uploading is enabled. If this option is not set, the operating system default temporary\n          directory will be used.\n\n          [env: MINISERVER_TEMP_UPLOAD_DIRECTORY=]\n\n      --index \u003CINDEX>\n          The name of a directory index file to serve, like \"index.html\"\n\n          Normally, when miniserve serves a directory, it creates a listing for that directory. However, if a directory contains this file,\n          miniserve will serve that file instead.\n\n          [env: MINISERVE_INDEX=]\n\n      --spa\n          Activate SPA (Single Page Application) mode\n\n          This will cause the file given by --index to be served for all non-existing file paths. In effect, this will serve the index file\n          whenever a 404 would otherwise occur in order to allow the SPA router to handle the request instead.\n\n          [env: MINISERVE_SPA=]\n\n      --quiet\n          Reduce output and silence warnings\n\n          [env: MINISERVE_QUIET=]\n\n      --pretty-urls\n          Activate Pretty URLs mode\n\n          This will cause the server to serve the equivalent `.html` file indicated by the path.\n\n          `\u002Fabout` will try to find `about.html` and serve it.\n\n          [env: MINISERVE_PRETTY_URLS=]\n\n  -p, --port \u003CPORT>\n          Port to use\n\n          [env: MINISERVE_PORT=]\n          [default: 8080]\n\n  -i, --interfaces \u003CINTERFACES>\n          Interface to listen on\n\n          [env: MINISERVE_INTERFACE=]\n\n      --workers \u003CWORKERS>\n          Number of server workers\n\n          [env: MINISERVE_WORKERS=]\n          [default: 4]\n\n  -a, --auth \u003CAUTH>\n          Set authentication\n\n          Currently supported formats:\n          username:password, username:sha256:hash, username:sha512:hash\n          (e.g. joe:123, joe:sha256:a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3)\n\n          [env: MINISERVE_AUTH=]\n\n      --auth-file \u003CAUTH_FILE>\n          Read authentication values from a file\n\n          Example file content:\n\n          joe:123\n          bob:sha256:a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3\n          bill:\n\n          [env: MINISERVE_AUTH_FILE=]\n\n      --route-prefix \u003CROUTE_PREFIX>\n          Use a specific route prefix\n\n          [env: MINISERVE_ROUTE_PREFIX=]\n\n      --random-route\n          Generate a random 6-hexdigit route\n\n          [env: MINISERVE_RANDOM_ROUTE=]\n\n  -P, --no-symlinks\n          Hide symlinks in listing and prevent them from being followed\n\n          [env: MINISERVE_NO_SYMLINKS=]\n\n  -H, --hidden\n          Show hidden files\n\n          [env: MINISERVE_HIDDEN=]\n\n  -S, --default-sorting-method \u003CDEFAULT_SORTING_METHOD>\n          Default sorting method for file list\n\n          Possible values:\n          - name: Sort by name\n          - size: Sort by size\n          - date: Sort by last modification date (natural sort: follows alphanumerical order)\n\n          [env: MINISERVE_DEFAULT_SORTING_METHOD=]\n          [default: name]\n\n  -O, --default-sorting-order \u003CDEFAULT_SORTING_ORDER>\n          Default sorting order for file list\n\n          Possible values:\n          - asc:  Ascending order\n          - desc: Descending order\n\n          [env: MINISERVE_DEFAULT_SORTING_ORDER=]\n          [default: desc]\n\n  -c, --color-scheme \u003CCOLOR_SCHEME>\n          Default color scheme\n\n          [env: MINISERVE_COLOR_SCHEME=]\n          [default: squirrel]\n          [possible values: squirrel, archlinux, ayu-dark, zenburn, monokai]\n\n  -d, --color-scheme-dark \u003CCOLOR_SCHEME_DARK>\n          Default color scheme\n\n          [env: MINISERVE_COLOR_SCHEME_DARK=]\n          [default: archlinux]\n          [possible values: squirrel, archlinux, ayu-dark, zenburn, monokai]\n\n  -q, --qrcode\n          Enable QR code display\n\n          [env: MINISERVE_QRCODE=]\n\n  -u, --upload-files [\u003CALLOWED_UPLOAD_DIR>]\n          Enable file uploading (and optionally specify for which directory)\n\n          The provided path is not a physical file system path. Instead, it's relative to the serve dir. For instance, if the serve dir is\n          '\u002Fhome\u002Fhello', set this to '\u002Fupload' to allow uploading to '\u002Fhome\u002Fhello\u002Fupload'. When specified via environment variable, a path\n          always needs to be specified.\n\n          [env: MINISERVE_ALLOWED_UPLOAD_DIR=]\n\n      --web-upload-files-concurrency \u003CWEB_UPLOAD_CONCURRENCY>\n          Configure amount of concurrent uploads when visiting the website. Must have upload-files option enabled for this setting to matter.\n\n          For example, a value of 4 would mean that the web browser will only upload 4 files at a time to the web server when using the web\n          browser interface.\n\n          When the value is kept at 0, it attempts to resolve all the uploads at once in the web browser.\n\n          NOTE: Web pages have a limit of how many active HTTP connections that they can make at one time, so even though you might set a\n          concurrency limit of 100, the browser might only make progress on the max amount of connections it allows the web page to have open.\n\n          [env: MINISERVE_WEB_UPLOAD_CONCURRENCY=]\n          [default: 0]\n\n      --chmod \u003CCHMOD>\n          Set unix file permissions of uploaded files\n\n          This takes an octal number, for example 0600. By default 0666 & ~umask is used to simulate the system's default behavior.\n\n          [env: MINISERVE_CHMOD=]\n\n      --directory-size\n          Enable recursive directory size calculation\n\n          This is disabled by default because it is a potentially fairly IO intensive operation.\n\n          [env: MINISERVE_DIRECTORY_SIZE=]\n\n  -U, --mkdir\n          Enable creating directories\n\n          [env: MINISERVE_MKDIR_ENABLED=]\n\n      --pastebin\n          Enable creating pastebin 'pastes'\n\n          'pastes' are plaintext files created in the current directory. Creation requires file uploads be enabled.\n\n          [env: MINISERVE_PASTEBIN_ENABLED=]\n\n  -m, --media-type \u003CMEDIA_TYPE>\n          Specify uploadable media types\n\n          [env: MINISERVE_MEDIA_TYPE=]\n          [possible values: image, audio, video]\n\n  -M, --raw-media-type \u003CMEDIA_TYPE_RAW>\n          Directly specify the uploadable media type expression\n\n          [env: MINISERVE_RAW_MEDIA_TYPE=]\n\n  -o, --on-duplicate-files \u003CON_DUPLICATE_FILES>\n          What to do if existing files with same name is present during file upload\n\n          If you enable renaming files, the renaming will occur by adding a numerical suffix to the filename before the final extension. For\n          example file.txt will be uploaded as file-1.txt, the number will be increased until an available filename is found.\n\n          [env: MINISERVE_ON_DUPLICATE_FILES=]\n          [default: error]\n          [possible values: error, overwrite, rename]\n\n  -R, --rm-files [\u003CALLOWED_RM_DIR>]\n          Enable file and directory deletion (and optionally specify for which directory)\n\n          [env: MINISERVE_ALLOWED_RM_DIR=]\n\n  -r, --enable-tar\n          Enable uncompressed tar archive generation\n\n          [env: MINISERVE_ENABLE_TAR=]\n\n  -g, --enable-tar-gz\n          Enable gz-compressed tar archive generation\n\n          [env: MINISERVE_ENABLE_TAR_GZ=]\n\n  -z, --enable-zip\n          Enable zip archive generation\n\n          WARNING: Zipping large directories can result in out-of-memory exception because zip generation is done in memory and cannot be sent\n          on the fly\n\n          [env: MINISERVE_ENABLE_ZIP=]\n\n  -C, --compress-response\n          Compress response\n\n          WARNING: Enabling this option may slow down transfers due to CPU overhead, so it is disabled by default.\n\n          Only enable this option if you know that your users have slow connections or if you want to minimize your server's bandwidth usage.\n\n          [env: MINISERVE_COMPRESS_RESPONSE=]\n\n  -D, --dirs-first\n          List directories first\n\n          [env: MINISERVE_DIRS_FIRST=]\n\n  -t, --title \u003CTITLE>\n          Shown instead of host in page title and heading\n\n          [env: MINISERVE_TITLE=]\n\n      --header \u003CHEADER>\n          Inserts custom headers into the responses. Specify each header as a 'Header:Value' pair. This parameter can be used multiple times\n          to add multiple headers.\n\n          Example: --header \"Header1:Value1\" --header \"Header2:Value2\" (If a header is already set or previously inserted, it will not be\n          overwritten.)\n\n          [env: MINISERVE_HEADER=]\n\n  -l, --show-symlink-info\n          Visualize symlinks in directory listing\n\n          [env: MINISERVE_SHOW_SYMLINK_INFO=]\n\n  -F, --hide-version-footer\n          Hide version footer\n\n          [env: MINISERVE_HIDE_VERSION_FOOTER=]\n\n      --hide-theme-selector\n          Hide theme selector\n\n          [env: MINISERVE_HIDE_THEME_SELECTOR=]\n\n  -W, --show-wget-footer\n          If enabled, display a wget command to recursively download the current directory\n\n          [env: MINISERVE_SHOW_WGET_FOOTER=]\n\n      --print-completions \u003Cshell>\n          Generate completion file for a shell\n\n          [possible values: bash, elvish, fish, powershell, zsh]\n\n      --print-manpage\n          Generate man page\n\n      --tls-cert \u003CTLS_CERT>\n          TLS certificate to use\n\n          [env: MINISERVE_TLS_CERT=]\n\n      --tls-key \u003CTLS_KEY>\n          TLS private key to use\n\n          [env: MINISERVE_TLS_KEY=]\n\n      --readme\n          Enable README.md rendering in directories\n\n          [env: MINISERVE_README=]\n\n  -I, --disable-indexing\n          Disable indexing\n\n          This will prevent directory listings from being generated and return an error instead.\n\n          [env: MINISERVE_DISABLE_INDEXING=]\n\n      --enable-webdav\n          Enable read-only WebDAV support (PROPFIND requests)\n\n          [env: MINISERVE_ENABLE_WEBDAV=]\n\n      --size-display \u003CSIZE_DISPLAY>\n          Show served file size in exact bytes\n\n          [env: MINISERVE_SIZE_DISPLAY=]\n          [default: human]\n          [possible values: human, exact]\n\n      --file-external-url \u003CFILE_EXTERNAL_URL>\n          Optional external URL (e.g., 'http:\u002F\u002Fexternal.example.com:8081') prepended to file links in listings.\n\n          Allows serving files from a different URL than the browsing instance. Useful for setups like: one authenticated instance for\n          browsing, linking files (via this option) to a second, non-indexed (-I) instance for direct downloads. This obscures the full file\n          list on the download server, while users can still copy direct file URLs for sharing. The external URL is put verbatim in front of\n          the relative location of the file, including the protocol. The user should take care this results in a valid URL, no further checks\n          are being done.\n\n          [env: MINISERVE_FILE_EXTERNAL_URL=]\n\n      --log-color \u003CLOG_COLOR>\n          Set the color style of the log output\n\n          \"auto\" (default) enables colors only when the output is a terminal. \"always\" always enables colors. \"never\" always disables colors.\n\n          [env: MINISERVE_LOG_COLOR=]\n          [default: auto]\n          [possible values: auto, always, never]\n\n  -h, --help\n          Print help (see a summary with '-h')\n\n  -V, --version\n          Print version\n```\n\n## How to install\n\n\u003Ca href=\"https:\u002F\u002Frepology.org\u002Fproject\u002Fminiserve\u002Fversions\">\u003Cimg align=\"right\" src=\"https:\u002F\u002Frepology.org\u002Fbadge\u002Fvertical-allrepos\u002Fminiserve.svg\" alt=\"Packaging status\">\u003C\u002Fa>\n\n**On Linux**: Download `miniserve-linux` from [the releases page](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Freleases) and run\n\n    chmod +x miniserve-linux\n    .\u002Fminiserve-linux\n\nAlternatively, if you are on **Arch Linux**, you can do\n\n    pacman -S miniserve\n\nOn [Termux](https:\u002F\u002Ftermux.com\u002F)\n\n    pkg install miniserve\n\n**On OSX**: Download `miniserve-osx` from [the releases page](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Freleases) and run\n\n    chmod +x miniserve-osx\n    .\u002Fminiserve-osx\n\nAlternatively install with [Homebrew](https:\u002F\u002Fbrew.sh\u002F):\n\n    brew install miniserve\n    miniserve\n\n**On Windows**: Download `miniserve-win.exe` from [the releases page](https:\u002F\u002Fgithub.com\u002Fsvenstaro\u002Fminiserve\u002Freleases) and run\n\n    miniserve-win.exe\n\nAlternatively install with [Scoop](https:\u002F\u002Fscoop.sh\u002F):\n\n    scoop install miniserve\n\n**With Cargo**: Make sure you have a recent version of Rust. Then you can run\n\n    cargo install --locked miniserve\n    miniserve\n\n**With Docker:** Make sure the Docker daemon is running and then run\n\n    docker run -v \u002Ftmp:\u002Ftmp -p 8080:8080 --rm -it docker.io\u002Fsvenstaro\u002Fminiserve \u002Ftmp\n\n**With Podman:** Just run\n\n    podman run -v \u002Ftmp:\u002Ftmp -p 8080:8080 --rm -it docker.io\u002Fsvenstaro\u002Fminiserve \u002Ftmp\n\n**With Helm:** See [this third-party Helm chart](https:\u002F\u002Fcodeberg.org\u002Fwrenix\u002Fhelm-charts\u002Fsrc\u002Fbranch\u002Fmain\u002Fminiserve) by @wrenix.\n\n## Shell completions\n\nIf you'd like to make use of the built-in shell completion support, you need to run `miniserve\n--print-completions \u003Cyour-shell>` and put the completions in the correct place for your shell. A\nfew examples with common paths are provided below:\n\n    # For bash\n    miniserve --print-completions bash > ~\u002F.local\u002Fshare\u002Fbash-completion\u002Fcompletions\u002Fminiserve\n    # For zsh\n    miniserve --print-completions zsh > \u002Fusr\u002Flocal\u002Fshare\u002Fzsh\u002Fsite-functions\u002F_miniserve\n    # For fish\n    miniserve --print-completions fish > ~\u002F.config\u002Ffish\u002Fcompletions\u002Fminiserve.fish\n\n## systemd\n\nA hardened systemd-compatible unit file can be found in `packaging\u002Fminiserve@.service`. You could\ninstall this to `\u002Fetc\u002Fsystemd\u002Fsystem\u002Fminiserve@.service` and start and enable `miniserve` as a\ndaemon on a specific serve path `\u002Fmy\u002Fserve\u002Fpath` like this:\n\n    systemctl enable --now miniserve@-my-serve-path\n\nKeep in mind that you'll have to use `systemd-escape` to properly escape a path for this usage.\n\nIn case you want to customize the particular flags that miniserve launches with, you can use\n\n    systemctl edit miniserve@-my-serve-path\n\nand set the `[Service]` part in the resulting `override.conf` file. For instance:\n\n    [Service]\n    ExecStart=\n    ExecStart=\u002Fusr\u002Fbin\u002Fminiserve --enable-tar --enable-zip --no-symlinks --verbose -i ::1 -p 1234 --title hello --color-scheme monokai --color-scheme-dark monokai -- %I\n\nMake sure to leave the `%I` at the very end in place or the wrong path might be served.\nAlternatively, you can configure the service via environment variables:\n\n    [Service]\n    Environment=MINISERVE_ENABLE_TAR=true\n    Environment=MINISERVE_ENABLE_ZIP=true\n    Environment=\"MINISERVE_TITLE=hello world\"\n    ...\n\nYou might additionally have to override `IPAddressAllow` and `IPAddressDeny` if you plan on making\nminiserve directly available on a public interface.\n\n## Binding behavior\n\nFor convenience reasons, miniserve will try to bind on all interfaces by default (if no `-i` is provided).\nIt will also do that if explicitly provided with `-i 0.0.0.0` or `-i ::`.\nIn all of the aforementioned cases, it will bind on both IPv4 and IPv6.\nIf provided with an explicit non-default interface, it will ONLY bind to that interface.\nYou can provide `-i` multiple times to bind to multiple interfaces at the same time.\n\n## Why use this over alternatives?\n\n- darkhttpd: Not easily available on Windows and it's not as easy as download-and-go.\n- Python built-in webserver: Need to have Python installed, it's low performance, and also doesn't do correct MIME type handling in some cases.\n- netcat: Not as convenient to use and sending directories is [somewhat involved](https:\u002F\u002Fnakkaya.com\u002F2009\u002F04\u002F15\u002Fusing-netcat-for-file-transfers\u002F).\n\n## Releasing\n\nThis is mostly a note for me on how to release this thing:\n\n- Make sure [CHANGELOG.md](.\u002FCHANGELOG.md) is up to date.\n- `cargo release \u003Cversion>`\n- `cargo release --execute \u003Cversion>`\n- Releases will automatically be deployed by GitHub Actions.\n- Update Arch package.\n","miniserve 是一个轻量级的命令行工具，用于通过 HTTP 协议快速分享文件和目录。它采用 Rust 语言编写，具有跨平台特性，支持 Windows、macOS 和 Linux 系统。核心功能包括但不限于单文件或整个目录共享、自定义索引文件设置、SPA（单页应用）支持、基本认证保护以及 TLS 加密传输等。此外，用户还可以为服务添加自定义 HTTP 头信息以满足特定需求。此工具非常适合需要临时快速搭建简易 HTTP 服务器的场景，如开发测试环境下的资源分享、小范围内的文件分发等。",2,"2026-06-11 03:03:59","top_language"]