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