디렉터리 목록, 업로드, Basic Auth, 선택적 HTTPS를 지원하는 Rust 기반 간단한 정적 파일 서버입니다.
svenstaro/miniserve
선택적 인증, 업로드, TLS를 지원하며 HTTP로 파일과 디렉터리를 즉시 제공하는 단일 바이너리 Rust CLI입니다.
- 스타
- 7,922
- 포크
- 401
- 열린 이슈
- 93
- 마지막 커밋
- 24일 전
어떤 프로젝트인가요?
miniserve는 제대로 된 웹 서버를 설정하지 않고도 HTTP로 파일을 공유할 수 있는 작은 명령줄 도구입니다. 디렉터리나 단일 파일을 지정하면 탐색 가능한 목록과 함께 제공하거나, 대신 지정한 인덱스 파일을 제공합니다. Linux, macOS, Windows용 단일 독립 실행형 바이너리로 배포되며 Cargo, Homebrew, Docker, Podman으로도 설치할 수 있습니다.
기본적인 파일 제공 외에도 즉석에서 필요한 기능을 지원합니다. 사용자 이름/비밀번호 인증(일반 문자열 또는 SHA-256/SHA-512 해시), 파일 및 폴더 업로드, 디렉터리 생성, 활성화 시 파일 삭제, 폴더를 tar, tar.gz 또는 zip으로 즉석 압축해 다운로드하는 기능이 있습니다. TLS 연결, 사용자 지정 응답 헤더, 대체 경로 설정을 통한 SPA 제공, 읽기 전용 WebDAV 엔드포인트도 지원합니다.
Rust와 Actix 웹 프레임워크로 만들어졌습니다. 프로젝트는 Python 내장 HTTP 서버나 netcat 같은 간편한 대안보다 MIME 타입을 더 잘 처리하고 Windows에서 설정하기 쉽다는 점을 내세웁니다.
핵심 기능
- 01탐색 가능한 목록과 선택적 사용자 지정 인덱스 파일을 제공하며, 디렉터리나 단일 파일을 서비스합니다.
- 02SHA-256 및 SHA-512 해시 비밀번호를 포함한 사용자 이름/비밀번호 인증을 지원합니다.
- 03지정한 경로로 제한해 파일 업로드, 디렉터리 생성, 선택적 파일 삭제를 지원합니다.
- 04폴더를 tar, tar.gz 또는 zip 아카이브로 즉석에서 생성해 다운로드할 수 있습니다.
- 05TLS, 사용자 지정 응답 헤더, SPA 대체 경로 설정, 읽기 전용 WebDAV를 지원합니다.
- 06검색 필터링, QR 코드 표시, 라이트/다크 테마, 셸 자동 완성을 제공합니다.
활용 사례
- 같은 네트워크에 있는 사람과 대용량 ISO 파일이나 폴더를 빠르게 공유합니다.
- 테스트를 위해 정적 사이트나 싱글 페이지 앱 빌드를 로컬에서 제공합니다.
- 브라우저를 통해 휴대폰에서 노트북으로 사진을 업로드할 수 있게 합니다.
- 홈 서버에서 비밀번호로 보호된 파일 공유를 실행하거나 systemd를 통해 데몬으로 구동합니다.
빠른 시작
- 1
miniserve 바이너리를 받습니다(README에 Crates.io 및 Docker Hub 링크가 있습니다).
- 2
디렉터리를 제공합니다.
miniserve linux-distro-collection/
사용 전 알아둘 점
- ZIP 아카이브는 메모리에서 생성되므로 디렉터리가 크면 메모리 부족 오류가 발생할 수 있습니다.
- TLS는 지원되는 아키텍처에서만 사용할 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- miniserve은(는) 무엇인가요?
- 선택적 인증, 업로드, TLS를 지원하며 HTTP로 파일과 디렉터리를 즉시 제공하는 단일 바이너리 Rust CLI입니다. miniserve는 제대로 된 웹 서버를 설정하지 않고도 HTTP로 파일을 공유할 수 있는 작은 명령줄 도구입니다. 디렉터리나 단일 파일을 지정하면 탐색 가능한 목록과 함께 제공하거나, 대신 지정한 인덱스 파일을 제공합니다. Linux, macOS, Windows용 단일 독립 실행형 바이너리로 배포되며 Cargo, Homebrew, Docker, Podman으로도 설치할 수 있습니다.
- miniserve은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- miniserve은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- miniserve은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. miniserve의 마지막 커밋은 2026년 10월 1일입니다.
- miniserve은(는) 어디에 사용할 수 있나요?
- 같은 네트워크에 있는 사람과 대용량 ISO 파일이나 폴더를 빠르게 공유합니다. 테스트를 위해 정적 사이트나 싱글 페이지 앱 빌드를 로컬에서 제공합니다. 브라우저를 통해 휴대폰에서 노트북으로 사진을 업로드할 수 있게 합니다. 홈 서버에서 비밀번호로 보호된 파일 공유를 실행하거나 systemd를 통해 데몬으로 구동합니다.
- miniserve는 어떻게 설치하나요?
- miniserve 바이너리를 받습니다(README에 Crates.io 및 Docker Hub 링크가 있습니다). 디렉터리를 제공합니다.: miniserve linux-distro-collection/
- miniserve은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/svenstaro/miniserve
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
WSGI 기반으로 Python으로 작성된 범용 확장형 WebDAV 서버로, 독립 실행하거나 다른 WSGI 앱에 임베드할 수 있습니다.
정적 파일 제공, 업로드, 검색, 접근 제어, WebDAV를 지원하는 개성 있는 Rust 커맨드라인 파일 서버입니다.
OpenSSL CLI의 간편한 대안으로 인증서와 TLS 연결을 검사·평가·생성·변환할 수 있는 단일 Rust 바이너리입니다.
자주 찾는 디렉터리를 학습해 몇 번의 키 입력으로 이동하는 더 똑똑한 cd 명령어