static-web-server
SHA-256一款轻量、高性能的静态文件服务器，基于 Rust 开发，单二进制无依赖，支持 HTTP/2、压缩、安全头等现代特性。
スマートダウンロード
Download 版をダウンロード
v2.42.0 · 3.5 MB
极速静态文件服务，单文件部署，资源占用极低。
主な機能
- 单二进制文件，仅 4MB，无需任何依赖，即下即用
- 基于 Rust 异步运行时，性能极强且内存安全
- 支持 HTTP/1、HTTP/2 和 TLS，开箱即用
- 可选 Gzip、Brotli、Zstd 压缩，按需开启
- 自动守护目录列表，支持排序和 JSON 输出
できないこと
- •SWS 专注于静态文件服务，不适用于需要后端动态内容生成的场景（如 PHP、Node.js 等）,日志功能较简洁，高级日志格式或远程日志需自行扩展,默认不启用 TLS，如需 HTTPS 需要自行提供证书并配置 `--tls-cert` `--tls-key` 参数,Windows 服务功能需要使用 `--windows-service` 参数，且需以管理员权限运行
使用例
- 快速搭建个人或公司静态网站，如博客、文档站、产品页
- 作为单页应用（SPA）的开发或生产服务器，配合 404 回退
- 用于微服务架构中提供静态资源文件，如图片、CSS/JS 包
- 在 Docker、Kubernetes 中作为极简的静态文件服务镜像
- 作为 API 文档或离线手册的本地浏览器服务器
詳細説明
Static Web Server (SWS) 是一款基于 Rust 编写的跨平台、高性能静态文件服务器。它专为服务静态网页和资产而设计，底层使用 Hyper 和 Tokio 异步运行时，实现了极致的处理速度与低资源占用。SWS 打包为一个仅 4MB 的静态二进制文件（基于 Musl libc），无需任何外部依赖，可轻松部署在任何 Linux 发行版或 Docker 容器中。支持 HTTP/2 与 TLS、Gzip/Brotli/Zstd 压缩、Cache-Control 缓存控制、CORS 跨域、目录列表、虚拟主机、URL 重写、基本认证、健康检查端点、Prometheus 指标等功能。配置方式灵活多样，可通过命令行参数、环境变量或 TOML 文件进行设置。SWS 非常适合用于搭建静态网站、单页应用（SPA）、API 文档或作为轻量级开发服务器。
トラブルシューティング & FAQ (2)
トラブル対応なぜStatic Web Serverはサブディレクトリ内のindex.htmlファイルのCache-Controlヘッダーを無視するのですか？
これはバージョン2.40.1における既知の回帰であり、'**/*.html'のようなグロブパターンを使用する高度なヘッダールールがディレクトリインデックスファイル（例えば、'/about'としてリクエストされる'/about/index.html'）に適用されない問題です。このバグはPR #613で修正されています。最新の開発用Dockerイメージ（例：'joseluisq/static-web-server:devel'）を使用するか、リリース後に修正を含むバージョンにアップグレードしてください。
トラブル対応Alpine/BusyBox上でstatic-web-serverインストーラを実行したときに発生する'cp: unrecognized option: x'エラーを修正する方法
このエラーは、BusyBoxのcpが-xフラグをサポートしていないために発生します。インストーラスクリプト（PRs #610および#611）で修正されました。https://get.static-web-server.net から最新のインストーラを使用してください。このインストーラではcpをinstallコマンドに置き換え、sudoの要件を削除しています。Dockerの場合は、キャッシュなしでイメージを再ビルドするか、更新されたスクリプトをプルしてください。すぐにアップグレードできない場合は、サポートされていないフラグを使用せずに、手動でバイナリをターゲットパスにコピーしてください。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
从 GitHub Releases 下载对应平台的二进制文件（或使用 Docker 镜像 joseluisq/static-web-server）
解压后，直接运行：`./static-web-server --port 8080 --root ./my-site`
浏览器打开 http://localhost:8080 即可看到站点内容
- 从 GitHub Releases 下载对应平台的二进制文件（或使用 Docker 镜像 joseluisq/static-web-server）
- 解压后，直接运行：`./static-web-server --port 8080 --root ./my-site`
- 浏览器打开 http://localhost:8080 即可看到站点内容
SHA-256 チェックサム確認済み
GitHub 公式 Release ページから抽出されたチェックサム
SHA256 チェックサム
ed32ff29cdcafb37b5cc4efa89147918bc837fbe308a2a6c438c8b9047b71956このチェックサムは GitHub Release ページから抽出されたものです。ダウンロード後にファイルの整合性を確認してください。
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
直接删除下载的二进制文件或 Docker 镜像即可，无任何残留。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生？以下のFAQを確認
2 FAQs