miniserve
用单一命令通过 HTTP 临时共享文件或目录的轻量服务器，支持认证、TLS、上传、二维码、压缩下载和范围请求。
miniserve 的适用场景
miniserve 是自包含的跨平台 HTTP 文件服务器，可快速共享单个文件或目录，并提供认证、搜索、压缩下载、二维码、范围请求、TLS、上传和目录创建等功能。它适合受控网络中的临时传输和演示，不等同于经过完整加固的长期公网存储服务。
最重要的是限制暴露范围
启动命令决定共享路径、监听接口和端口。直接共享用户目录或项目根目录可能暴露密钥、备份、源码和隐藏文件。可靠做法是新建专用目录、只复制允许分发的文件、先绑定本机，并用另一客户端验证无法越界访问。
上传与公网访问会显著增加风险
启用上传或目录创建后，访问者可以写入磁盘，带来覆盖、恶意文件和容量耗尽风险。公网环境还需 TLS、强认证、最小防火墙规则、反向代理、日志和更新策略。随机路径不是访问控制，简单密码加明文 HTTP 也不能保护内容。
维护记录
本页于 2026-08-06 根据 miniserve 的默认 8080 端口、文件与目录共享、认证、TLS、上传、二维码和监听接口说明复核。归档文件为 v0.35.0 Windows x64 MSVC 单一程序。
保存到自己的网盘
打开网盘后可直接获取，也可以先保存到自己的网盘，方便换设备继续使用。
夸克网盘（无需提取码）
推荐将「miniserve」保存到该网盘
百度网盘
将「miniserve」保存到该网盘
miniserve Windows 局域网文件共享教程
miniserve 会把本地文件暴露为网络服务。首次仅绑定本机并共享测试目录，确认访问范围后才考虑局域网；不要把临时分享命令直接用于公网长期托管。
安装前准备
- 新建一个只包含可公开测试文件的专用目录，不要直接共享用户目录、桌面或项目根目录。
- 了解 Windows 防火墙、监听地址和局域网边界，确认路由器没有自动端口映射。
- 如果需要上传或公网访问，先设计认证、TLS、容量限制、日志、备份和终止服务流程。
安装步骤
- 01
放置并核对程序
将单一 EXE 放入固定工具目录，通过帮助信息确认版本、默认端口和监听参数，首次运行前完成安全扫描。
- 02
准备最小共享目录
创建独立测试目录，只复制一份无敏感内容的示例文件，并检查隐藏文件、符号链接和继承权限。
- 03
保持防火墙收紧
第一次启动不创建公网入站规则，仅允许本机验证；后续如需局域网访问，再按具体端口和网络配置最小规则。
快速上手
- 01
只在本机启动
指定测试目录并明确绑定回环地址，使用默认或自定义端口启动；检查终端显示的服务路径和访问地址。
- 02
核对下载边界
在浏览器中尝试列表、单文件下载和不存在路径，确认父目录、隐藏文件及非共享内容无法访问。
- 03
按需增加保护
局域网分享时再设置强认证和限定监听接口；需要 TLS 或上传时先阅读全部相关参数，并在隔离目录测试写入权限。
使用建议
- 随机路由只降低地址被偶然发现的概率，不能替代认证、TLS 和防火墙。
- 上传和目录创建会带来覆盖、磁盘占满和恶意内容风险，除非确有需要不要启用。
- 分享完成后立即停止进程并移除临时防火墙规则，检查上传目录和访问日志。
故障排查与卸载方法
本机能访问，其他设备不能访问怎么办？
检查监听接口是否仅为回环地址、Windows 网络类型和防火墙端口；只在可信局域网扩大监听，不要用关闭整个防火墙来排查。
浏览器提示认证或 TLS 错误怎么办？
检查用户名密码格式、证书与私钥是否匹配、访问主机名是否在证书范围内；在修复前不要忽略警告传输敏感文件。
- 停止服务并清理规则先终止所有 miniserve 进程，删除专用防火墙规则和临时上传内容，再从 PATH 中移除程序目录并删除 EXE。
常见问题
miniserve 默认端口是多少？
默认端口是 8080。首次测试应只在本机打开无敏感内容的目录，并确认实际监听接口；不要因为页面能打开就直接映射到公网。
开启用户名密码后就适合公网使用吗？
仍不一定。明文 HTTP 会暴露凭据和文件内容，简单密码也易被猜测。公网使用还需要 TLS、强认证、最小共享目录、防火墙、日志和持续维护，通常应放在成熟反向代理之后。
miniserve 会允许访问父目录吗？
服务范围由启动时选择的文件或目录决定，但上传、目录创建、符号链接和配置都会改变风险。启动前应使用专门的最小目录，并检查其中没有密钥、备份或隐藏文件。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。