ESLockDecryptor

ESLockDecryptor는 ES 파일 탐색기(ES File Explorer)가 암호화한 파일(.eslock 확장자)을 복구하고 복호화하도록 설계된 명령줄 도구입니다. 개별 파일과 전체 디렉터리를 모두 처리할 수 있습니다.

[!WARNING] 법적 용도로만 사용하십시오! 이 소프트웨어는 교육 목적, 보안 연구, 합법적인 디지털 포렌식 용도로 설계되었습니다. 사용자가 자신의 데이터를 복구하거나 공인된 전문가가 아티팩트/증거를 분석하는 데 도움을 주기 위한 것입니다.

저자는 이 도구의 불법 사용에 대해 책임을 지지 않습니다. 사전 상호 동의 없이 대상을 공격하는 데 이 소프트웨어를 사용하는 것은 불법입니다. 모든 관련 지방, 주, 연방 법률을 준수할 책임은 최종 사용자에게 있습니다. 개발자는 이 프로그램으로 인해 발생한 오용이나 피해에 대해 어떠한 책임도 지지 않습니다.

기능

일괄 처리: .eslock 파일이 포함된 전체 디렉터리를 복호화합니다.
단일 파일 모드: 특정 파일을 복호화합니다.
자동 감지: 입력/출력 경로를 지정하지 않으면 자동으로 감지합니다.
빠르고 가벼움: 간단한 CLI 인터페이스, 여러 파일의 병렬 복호화를 지원합니다.
휴리스틱 모드: 표준 방법으로 파일을 복호화할 수 없는 경우 휴리스틱 분석을 사용할 수 있습니다.
원시 복호화 모드: 파일이 심하게 손상된 경우 기본 매개변수를 사용하여 파일을 부분적으로 복구할 수 있습니다.

다운로드 및 지원 플랫폼

최신 사전 빌드 바이너리는 Releases 페이지에서 다운로드할 수 있습니다.

.NET 런타임 설치는 필요하지 않습니다.

지원 플랫폼:

Windows: x64, x86, Arm64
Linux: x64, Arm64 (Ubuntu, Fedora, Kali에서 테스트됨; Debian, Arch, Mint, openSUSE 및 기타 glibc 기반 배포판과 호환)
macOS: Arm64 (Apple Silicon), x64 (Intel)

실행 방법 (중요)

이 도구는 명령줄 인터페이스(CLI) 도구입니다. 터미널(명령 프롬프트, PowerShell, Bash)에서 실행해야 합니다.

더블클릭으로 실행하지 마십시오:

Windows: 프로세스가 끝나면 터미널 창이 즉시 닫혀 성공/오류 로그를 볼 수 없습니다.
Linux: 프로세스가 백그라운드에서 실행되어 시각적 피드백이 없으므로 복호화가 끝났는지 알기 어렵습니다.

올바른 방법:

터미널을 엽니다.
도구가 있는 폴더로 이동합니다(cd path/to/tool).
아래와 같이 명령어를 실행합니다.

사용법

ESLockDecryptor [<input> [<output>]] [options]

디렉터리 동작

모든 디렉터리는 재귀적으로 처리됩니다. 출력 디렉터리는 입력 디렉터리와 동일한 구조를 갖습니다.

<output> 인수를 생략하면(시나리오 1 및 2), 유틸리티는 현재 작업 위치에 다음 형식의 새 디렉터리를 자동으로 생성합니다: decrypted-[timestamp] (예: decrypted-20260214-231500)

기본 시나리오

1. 자동 모드 (현재 폴더)

요구 사항: ESLockDecryptor 실행 파일을 암호화된 .eslock 파일이 있는 폴더 안에 직접 배치합니다.

./ESLockDecryptor

도구가 현재 디렉터리를 스캔하고 복호화된 파일을 새 타임스탬프 폴더에 저장합니다. 결과 위치: ./decrypted-[timestamp]

2. 특정 입력 (자동 출력)

암호화된 파일이 포함된 디렉터리의 경로를 지정합니다. 출력 폴더(decrypted-[timestamp])는 지정된 디렉터리 옆에 생성됩니다.

./ESLockDecryptor "path/to/encrypted_directory"

결과 위치: path/to/decrypted-[timestamp]

파일을 지정하면 출력 디렉터리는 파일 옆에 생성됩니다.

./ESLockDecryptor "path/to/file.eslock"

결과 위치: path/to/decrypted-[timestamp]

3. 명시적 입력 및 출력

파일을 가져올 위치와 복호화된 버전을 저장할 위치를 정확히 지정합니다.

./ESLockDecryptor "encrypted/path" "decrypted/path"

출력 디렉터리가 없으면 생성됩니다.

옵션

주요 플래그:

--verbose 또는 -v. 상세 로그를 출력합니다.
--overwrite. 출력 디렉터리에 파일이 이미 있으면 덮어씁니다.
--read-only. 메타데이터만 읽고 출력합니다(복호화하지 않음).

파일이 손상된 경우 추가 플래그를 사용할 수 있습니다:

--ignore-crc. 체크섬 검증에 실패해도 계속 진행합니다.
--password <password> 또는 -p <password>. 제공된 암호로 복호화하고 메타데이터의 키를 무시합니다.
--key <key> 또는 -k <key>. 제공된 키로 복호화하고 메타데이터의 키를 무시합니다.
--heuristic. 휴리스틱 메타데이터 검색 및 구문 분석을 수행합니다.
--raw-decrypt <auto|full|partial[:size]>. 메타데이터를 무시하고 제공된 키 또는 암호로 파일을 복호화합니다.

자세한 내용은 ESLockDecryptor 사용 방법을 참조하십시오.

소스에서 빌드

직접 애플리케이션을 빌드하려면 .NET 10 SDK가 설치되어 있어야 합니다.

리포지토리를 클론합니다:

git clone https://github.com/Piotr-Kniaz/ESLockDecryptor.git
cd ESLockDecryptor

프로젝트를 빌드합니다:
```
dotnet build --configuration Release
```

이슈 및 기여

기여는 언제나 환영합니다! 버그를 발견했거나, 기능 요청이 있거나, 코드를 개선하고 싶다면 자유롭게 도와주세요.