miniserve 文件服务器

Posted by eye on 07-19,2023

miniserve

以下是关于 miniserve 的简介和快速教程整理:


简介

miniserve 是一个轻量、跨平台的命令行 HTTP 文件服务器,无需复杂配置,只需下载二进制文件即可快速共享本地文件。适用于临时文件分享、局域网传输或简单测试场景,比搭建完整 Web 服务器更便捷。

特点

  • 单文件可执行,无依赖。
  • 支持跨平台(Linux/macOS/Windows)。
  • 提供目录列表、文件上传(可选)、二维码生成等功能。
  • 支持 HTTPS、Basic Auth、主题定制等。

快速教程

1. 安装

方式一:直接下载二进制
GitHub Releases 选择对应系统的二进制文件,解压后运行。

方式二:通过包管理器

  • macOS(Homebrew):
    brew install miniserve
    
  • Linux(Cargo):
    cargo install miniserve
    

2. 基本使用

启动服务

miniserve /path/to/share

默认监听 0.0.0.0:8080,浏览器访问 http://localhost:8080 即可查看文件列表。

常用参数

  • -p 端口号:指定端口(如 -p 3000)。
  • -a 用户名:密码:启用 Basic Auth(如 -a admin:123)。
  • --upload:允许文件上传。
  • --qr:显示二维码方便手机访问。
  • --random-route:生成随机路径防止泄露。

示例

miniserve -p 9000 --upload --qr /tmp/files

3. 高级功能

  • HTTPS 支持:通过 --tls-cert--tls-key 指定证书和密钥。
  • 主题定制:使用 --theme 参数选择不同颜色主题。
  • 隐藏文件:默认忽略隐藏文件,可通过 --show-hidden 显示。

4. 停止服务

Ctrl+C 终止进程即可关闭服务。


适用场景

  • 快速分享文件夹给同事。
  • 本地开发时临时测试文件下载。
  • 跨设备传输文件(配合二维码扫码)。

更多选项可通过 miniserve --help 查看。