Repolode
TheWaWaR

TheWaWaR/simple-http-server

디렉터리 목록, 업로드, Basic Auth, 선택적 HTTPS를 지원하는 Rust 기반 간단한 정적 파일 서버입니다.

스타
3,461
포크
218
열린 이슈
45
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Simple HTTP Server는 명령 하나로 로컬 폴더를 HTTP로 제공하는 CLI 도구입니다. 경로 탐색을 위한 브레드크럼이 포함된 디렉터리 목록을 표시하고, index.html 페이지를 자동으로 제공하며, 부분 다운로드를 위한 range 요청을 지원합니다. 선택한 파일 확장자에 대해 gzip 및 deflate 압축을 활성화할 수 있습니다.

개발 및 소규모 배포 환경을 위해 CSRF 토큰으로 보호되는 파일 업로드, HTTP Basic Auth, CORS, COOP/COEP 헤더 등의 옵션을 제공합니다. --try-file 옵션은 경로를 찾을 수 없을 때 대체 파일을 제공하므로 단일 페이지 애플리케이션에 적합합니다. --base-url 옵션을 사용하면 경로 접두사를 제거하는 리버스 프록시 뒤에서 실행할 수 있습니다.

이 서버는 axum과 tokio를 기반으로 합니다. PKCS#12 인증서(.p12 또는 .pfx)를 사용하는 HTTPS는 tls feature를 통해 제공되며, 바이너리 크기를 줄이기 위해 기본적으로 비활성화되어 있습니다. Windows, macOS, Linux에서 실행되며 cargo install로 설치할 수 있습니다.

핵심 기능

  • 01브레드크럼 탐색 및 이름, 수정 시간, 크기순 정렬을 지원하는 디렉터리 목록
  • 02선택적 index.html 렌더링 및 --try-file을 통한 SPA 대체 파일 제공
  • 03CSRF 보호와 설정 가능한 크기 제한을 지원하는 파일 업로드
  • 04HTTP Basic Auth, CORS, COOP/COEP 헤더
  • 05range 요청, ETag/Last-Modified 캐싱, gzip/deflate 압축
  • 06tls feature를 통한 선택적 PKCS#12 HTTPS

활용 사례

  • LAN에서 또는 팀원과 로컬 폴더를 빠르게 공유
  • index.html을 대체 파일로 제공하는 단일 페이지 애플리케이션 빌드 서빙
  • 로컬 PKCS#12 인증서로 HTTPS가 필요한 프런트엔드 코드 테스트
  • 경로 접두사가 있는 리버스 프록시 뒤에서 소규모 업로드 엔드포인트 실행

빠른 시작

  1. 1

    Cargo로 기본 빌드를 설치합니다

    cargo install simple-http-server
  2. 2

    인덱스 렌더링을 활성화한 상태로 폴더를 제공합니다

    simple-http-server -i public

사용 전 알아둘 점

  • HTTPS를 사용하려면 선택 사항인 tls 기능이 필요하며, PKCS#12 인증서만 지원합니다. PEM 파일은 직접 사용할 수 없습니다.

토픽

자주 묻는 질문

simple-http-server은(는) 무엇인가요?
디렉터리 목록, 업로드, Basic Auth, 선택적 HTTPS를 지원하는 Rust 기반 간단한 정적 파일 서버입니다. Simple HTTP Server는 명령 하나로 로컬 폴더를 HTTP로 제공하는 CLI 도구입니다. 경로 탐색을 위한 브레드크럼이 포함된 디렉터리 목록을 표시하고, index.html 페이지를 자동으로 제공하며, 부분 다운로드를 위한 range 요청을 지원합니다. 선택한 파일 확장자에 대해 gzip 및 deflate 압축을 활성화할 수 있습니다.
simple-http-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
simple-http-server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
simple-http-server은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. simple-http-server의 마지막 커밋은 2026년 8월 27일입니다.
simple-http-server은(는) 어디에 사용할 수 있나요?
LAN에서 또는 팀원과 로컬 폴더를 빠르게 공유 index.html을 대체 파일로 제공하는 단일 페이지 애플리케이션 빌드 서빙 로컬 PKCS#12 인증서로 HTTPS가 필요한 프런트엔드 코드 테스트 경로 접두사가 있는 리버스 프록시 뒤에서 소규모 업로드 엔드포인트 실행
simple-http-server는 어떻게 설치하나요?
Cargo로 기본 빌드를 설치합니다: cargo install simple-http-server 인덱스 렌더링을 활성화한 상태로 폴더를 제공합니다: simple-http-server -i public
simple-http-server은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/TheWaWaR/simple-http-server

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트