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
查看。