Hfs

가상 파일 시스템 및 파일 관리

가상 파일 시스템을 사용하면 실제 디스크의 폴더나 파일을 이동하거나 복사하지 않고도 웹 인터페이스상에서 원하는 대로 구성하여 공유할 수 있습니다. 파일 이름 변경, 이동, 삭제도 가능하며, 하나의 파일조차도 다른 이름으로 공유할 수 있습니다.

실시간 모니터링 및 대역폭 제어

현재 접속 중인 사용자 및 전송 상황을 실시간으로 확인할 수 있는 관리 페이지가 제공됩니다. 또한 대역폭 제한 기능을 통해 전체 또는 개별 IP별로 전송 속도를 조절하여 네트워크 과부하를 방지할 수 있습니다.

플러그인 및 확장성

안티 브루트포스, 썸네일 생성, LDAP 인증, 테마 변경 등 다양한 플러그인을 설치하여 기능을 확장할 수 있습니다. 또한 HTML, CSS, JavaScript를 사용해 인터페이스 및 백엔드 동작을 커스터마이징할 수 있습니다.

보안 및 접근 제어

HTTPS 지원을 통해 안전한 연결이 가능하며, 인증서 생성을 쉽게 할 수 있습니다. 계정을 생성하여 특정 폴더나 파일에 대한 접근 권한을 제한할 수 있으며, 필요 시 지리적 방화벽(Geo-firewall)을 설정해 특정 국가에서의 접근을 차단할 수 있습니다.

기타 기능

폴더를 ZIP 아카이브로 즉시 다운로드할 수 있으며, resumable(이어받기) 업로드 및 다운로드를 지원합니다. 내장된 미디어 플레이어를 통해 일부 파일을 브라우저에서 바로 재생할 수 있고, 동적 DNS 업데이터 기능을 통해 변동하는 공인 IP에서도 안정적인 접속이 가능합니다.

다운로드 및 설치 방법

공식 GitHub 저장소의 Releases 페이지에서 Windows용 ZIP 파일을 다운로드합니다. 다운로드 후 압축을 해제하고, 추출된 폴더 안에서 hfs 실행 파일을 더블클릭하여 프로그램을 시작합니다. 실행 시 자동으로 웹 브라우저가 열리며, localhost 주소에서 관리 패널에 접근할 수 있습니다.

첫 실행 시 별도의 로그인 없이 관리 패널에 접근할 수 있으나, 보안을 위해 관리 패널에서 localhost_admin false 설정을 비활성화하거나 콘솔에서 create-admin <PASSWORD> 명령을 입력하여 관리자 계정을 생성하는 것이 권장됩니다.

기본 사용법

프로그램을 실행하면 자동으로 관리 웹 인터페이스가 브라우저에 표시됩니다. 여기서 ‘가상 파일 시스템’ 탭을 통해 공유하고 싶은 폴더나 디스크 드라이브를 추가할 수 있습니다. 추가 후에는 다른 기기에서 브라우저를 열어 http://[컴퓨터의 로컬 IP]:포트 주소로 접속하면 공유된 파일 목록을 확인하고 다운로드하거나 업로드할 수 있습니다.

콘솔 창에서는 다음과 같은 명령을 사용할 수 있습니다:

• create-admin <PASSWORD>: 관리자 계정 생성
• config localhost_admin false: localhost에서의 무단 관리 패널 접근 비활성화
• echo "create-admin: PASSWORD" > config.yaml: 편집기 없이 관리자 계정 파일 생성

이런 경우에 유용합니다

집에서 사용하는 PC를 임시 파일 서버로 활용하고 싶은 경우, HFS를 설치하면 복잡한 설정 없이도 가족이나 친구와 대용량 파일을 빠르게 공유할 수 있습니다. 클라우드 서비스에 업로드하는 시간을 절약하고, 원본 파일을 그대로 유지하면서 웹 브라우저만으로 접근 가능하므로, USB나 외장 하드디스크를 매번 연결하는 번거로움을 줄일 수 있습니다.

소규모 팀이나 프로젝트 내에서 내부 파일 공유가 필요한 경우, 가상 파일 시스템을 통해 필요한 폴더만 선택해 공유함으로써 보안을 유지하면서도 간편하게 협업 환경을 구축할 수 있습니다. 플러그인을 통해 LDAP 인증이나 테마 적용 등을 추가하면 기업 환경에서도 활용 가능성을 높일 수 있습니다.

지원 환경·시스템 요구사항

HFS는 Windows 10 및 Windows Server 2019 이상의 64비트 시스템에서 공식적으로 지원됩니다. 또한 Linux, macOS, FreeBSD, Android 등 다양한 플랫폼에서도 실행 가능하지만, 스토어 등록 대상인 Windows 사용자를 기준으로 설명합니다. Node.js 18~24 버전이 설치되어 있다면 npx hfs@latest 명령으로 바이너리 없이도 실행할 수 있습니다.

최신 버전·업데이트

현재 최신 안정 버전은 3.2.2이며, 이는 GitHub 저장소의 Releases 페이지에서 확인할 수 있습니다. 업데이트는 새로운 ZIP 파일을 다운로드하여 기존 파일을 교체하는 방식으로 진행되며, 설정 및 데이터 디렉터리는 %HOME%.vfs 폴더에 저장되므로 업데이트 시 해당 폴더를 유지하면 구성을 유지할 수 있습니다.

제한 사항·확인 사항

버전 2.x 시리즈는 보안 취약점이 발견되어 더 이상 사용이 권장되지 않으며, 현재 공식적으로 유지보수 및 패치가 제공되지 않습니다. 따라서 반드시 버전 3.x 이상을 사용해야 합니다. 또한 Windows에서 실행 시 일부 백신 소프트웨어가 오탐지를 할 수 있으므로, 공식 위키의 Antivirus 문서를 참조하여 예외 처리 방법을 확인하는 것이 좋습니다.