static-web-server
SHA-256Rust로 개발된 가볍고 고성능인 정적 파일 서버로, 의존성 없는 단일 바이너리이며 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` 매개변수를 사용해야 하고 관리자 권한으로 실행해야 합니다
사용 사례
- 개인 또는 회사 정적 웹사이트(블로그, 문서 사이트, 제품 페이지 등) 빠르게 구축
- 404 폴백을 지원하는 싱글 페이지 애플리케이션(SPA)의 개발 또는 프로덕션 서버로 사용
- 마이크로서비스 아키텍처에서 이미지, 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 문서 구축 또는 경량 개발 서버로 활용하기에 매우 적합합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
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 확인
4 FAQs