Repolode
TheWaWaR

TheWaWaR/simple-http-server

一个用 Rust 编写的简易静态文件服务器,支持目录浏览、文件上传、Basic 认证和可选 HTTPS。

Star
3,461
Fork
218
未关闭 Issue
45
最近提交
2个月前

这是什么?

Simple HTTP Server 是一个命令行工具,只需一条命令就能通过 HTTP 提供本地文件夹的访问。它支持带面包屑导航的目录列表,可自动渲染 index.html 页面,并支持 Range 请求以便部分下载。对选定的文件扩展名,可以启用 gzip 和 deflate 压缩。

在开发或小型部署场景中,它还提供文件上传(受 CSRF 令牌保护)、HTTP Basic 认证、CORS,以及 COOP/COEP 响应头等选项。--try-file 参数可为不存在的路径返回回退文件,适合单页应用。--base-url 参数则便于部署在去除路径前缀的反向代理之后。

服务器基于 axum 和 tokio 构建。通过 tls 特性可使用 PKCS#12 证书(.p12 或 .pfx)启用 HTTPS,该特性默认关闭以减小二进制体积。它支持 Windows、macOS 和 Linux,可通过 cargo install 安装。

核心功能

  • 01带面包屑导航的目录列表,可按名称、修改时间或大小排序
  • 02可选的 index.html 渲染,并通过 --try-file 实现 SPA 回退
  • 03带 CSRF 防护和可配置大小限制的文件上传
  • 04支持 HTTP Basic 认证、CORS 以及 COOP/COEP 响应头
  • 05支持 Range 请求、ETag/Last-Modified 缓存及 gzip/deflate 压缩
  • 06通过 tls 特性可选启用 PKCS#12 HTTPS

适用场景

  • 在局域网内或与同事快速共享本地文件夹
  • 提供单页应用的构建产物,并回退到 index.html
  • 使用本地 PKCS#12 证书测试需要 HTTPS 的前端代码
  • 在带路径前缀的反向代理后运行小型上传服务

标签

常见问题

simple-http-server 是什么?
一个用 Rust 编写的简易静态文件服务器,支持目录浏览、文件上传、Basic 认证和可选 HTTPS。 Simple HTTP Server 是一个命令行工具,只需一条命令就能通过 HTTP 提供本地文件夹的访问。它支持带面包屑导航的目录列表,可自动渲染 index.html 页面,并支持 Range 请求以便部分下载。对选定的文件扩展名,可以启用 gzip 和 deflate 压缩。
simple-http-server 可以免费使用吗?用的什么许可证?
simple-http-server 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
simple-http-server 还在维护吗?
半年内有更新。simple-http-server 最近一次提交是在 2026年8月27日。
simple-http-server 适合用来做什么?
在局域网内或与同事快速共享本地文件夹 提供单页应用的构建产物,并回退到 index.html 使用本地 PKCS#12 证书测试需要 HTTPS 的前端代码 在带路径前缀的反向代理后运行小型上传服务
在哪里获取 simple-http-server?
源代码和安装说明在 GitHub 上:https://github.com/TheWaWaR/simple-http-server

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目