Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
USBvalve — USB 활동을 실시간으로 노출 | Kitploit
도구/GitHubGitHub/cecio/usbvalve
Embedded Systems SecurityDynamic Analysis (Sandboxing)ForensicsMalware AnalysisHardware Security
GitHubcecio/usbvalve

USBvalve

USB 활동을 실시간으로 노출

저장소 보기
1.3k436319일 전Kitploit 검토 완료
공유
<h1><img width="300" alt="logo, landscape, dark text, transparent background" src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_logo_scaled.png"></a></h1>

> [!NOTE]
> **USBvalve 버전 1.0.0**
>
> 애플리케이션이 완전히 재작성되었습니다:
> - Arduino IDE 환경에서 벗어나 이제 코드는 [Pi Pico SDK](https://github.com/raspberrypi/pico-sdk)용으로 작성되었습니다
> - 외부 라이브러리에 대한 의존성이 크게 줄었습니다
> - Low Speed 장치(ATTiny85, EvilCrow 등)에 대한 USB 호스트 지원이 더욱 견고해졌습니다
> -  하드웨어와 기능은 거의 변경되지 않았습니다. 자세한 내용은 아래 [참고 사항](https://github.com/cecio/USBvalve#notes-about-bootsel-and-version--100)을 확인하세요

### *USB 활동을 즉석에서 노출시키세요*

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/versions.png" alt="The two models" width="30%" height="30%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_PIWATCH.png" alt="The Watch" width="26%" height="26%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/version1_2.png" alt="1.2" width="26%" height="26%" />
</p>

저처럼, 여러분도 *알 수 없는* 장치에 USB 드라이브를 꽂아달라는 요청을 받은 적이 있을 것입니다... 그리고 그다음엔 의문이 들죠:

내 불쌍한 동글에 무슨 일이 일어난 걸까, 이면에서? 내 파일을 훔쳐가는 걸까? 암호화하는 걸까? 아니면 *그저* 악성코드를 설치하는 걸까? **USBvalve**를 사용하면 이를 몇 초 만에 알아낼 수 있습니다: 매우 저렴한 기성 하드웨어를 기반으로 제작되어, 어떤 USB 파일 시스템 활동이든 빠르게 테스트하고 너무 늦기 전에 무슨 일이 일어나고 있는지 파악할 수 있습니다!

**USBvalve**를 사용하면 드라이브에 무슨 일이 일어나는지 즉각적인 피드백을 받을 수 있습니다. 화면은 장치에 구축된 *가짜* 파일 시스템이 접근, 읽기 또는 쓰기되는지를 보여줍니다:

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/selftest.png" alt="Selftest" width="15%" height="15%" />
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/readme.png" alt="Readme" width="15%" height="15%" />
</p>

그리고 버전 `0.8.0`부터는 USB 호스트로 사용하여 *BADUSB* 장치를 탐지할 수도 있습니다:

<p float="left">
<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/hid.png" alt="HID" width="15%" height="15%" />
</p>

다음은 시리얼 포트에서 사용할 수 있는 *BADUSB* 디버거의 예시입니다:

<p float="left">
<a href="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ" target="_blank"><img src="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ.svg" width="65%" height="65%" /></a>
</p>

영상이 더 좋다면, 제 [Insomni'hack 발표](https://www.youtube.com/watch?v=jy1filtQY4w)도 확인해 보세요.

## USBvalve Watch

버전 `0.15.0`부터 새로운 *Pi Pico Watch* 버전이 지원됩니다. 새 버전을 컴파일하려면 코드 시작 부분의 `#define PIWATCH` 줄의 주석을 해제해야 합니다. 하드웨어는 RP2040 기반의 1.28인치 TFT 디스플레이 및 시계 보드입니다. 더 많은 정보는 [여기](https://www.raspberrypi.com/news/how-to-build-your-own-raspberry-pi-watch/)에서 확인할 수 있습니다.
이는 [Waveshare RP2040-LCD-1.28](https://www.waveshare.com/wiki/RP2040-LCD-1.28)과도 완전히 호환됩니다.

## 저장소 구조

`docs`: 프로젝트에 관한 문서로, 모든 기능을 살펴볼 수 있는 프레젠테이션이 포함되어 있습니다

`firmware`: Raspberry Pi Pico용 사전 빌드된 펌웨어입니다. 이들을 그대로 사용하여 보드에 플래시할 수 있습니다. 32줄 또는 64줄 OLED용, Pico 1 또는 Pico2용, Pi Pico Watch용 등 여러 가지 버전이 있습니다

`PCB`: 커스텀 PCB를 인쇄하고 싶다면 Gerber 파일입니다. 필수는 아니며, 자체 제작하거나 브레드보드에 구성할 수 있습니다

`src` 및 `data`: 소스로, 펌웨어를 직접 수정하고 빌드하려는 경우 사용합니다

`utils`: 커스텀 FS를 빌드하는 데 사용할 수 있는 몇 가지 유틸리티입니다

`pictures`: 이 문서에서 사용된 이미지와 리소스입니다

`STL`: 인클로저용 STL 파일입니다. `1.1` 및 `1.2` 폴더에는 완전한 인클로저가 있습니다([WhistleMaster](https://github.com/WhistleMaster)에게 감사드립니다). `1.2_64` 및 `1.2_64_simple` 폴더에는 128x64 화면용 인클로저가 있습니다([rtmq0227](https://github.com/rtmq0227)에게 감사드립니다). LCD를 보호할 더 가벼운 것을 원한다면 `USBvalve_sliding_cover.stl`을 사용할 수 있습니다.

## USBvalve 빌드하기

### 부품 목록

직접 제작하려면 다음이 필요합니다:

- Raspberry Pi Pico 1 또는 2 (또는 다른 RP2040 기반 보드)
- I2C OLED 화면 128x64 또는 128x32 (**SSD1306**)
- (선택 사항) **USBvalve** PCB 또는 브레드보드
- (선택 사항) 화면을 보드로부터 절연하기 위한 3D 프린트 스페이서 (https://www.thingiverse.com/thing:4748043), 대신 전기 테이프 조각을 사용해도 됩니다

### BOOTSEL 및 버전 >= 1.0.0에 관한 참고 사항

`0.x.x` 버전에서는 BOOTSEL이 장치를 리셋하거나 HID 이벤트 수를 출력하는 데 사용되었습니다(2초 이상 누름).
BOOTSEL의 폴링이 *BADUSB* 탐지에 몇 가지 문제를 일으켰기 때문에 버전 `1.0.0`에서 제거되었고, 다음과 같은 두 가지 옵션으로 대체되었습니다:
- `GP0`와 `GND` 사이에 버튼을 납땜하여(패드 1과 3, 예시는 아래 사진 참조) 동일한 기능을 사용
- 시리얼 모니터에서 `r`(리셋) 및 `h`(HID 이벤트) 명령 사용

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/reset_button.jpg" width="35%" height="35%" />

`PCB`에는 패드 1과 3에 버튼 장착을 용이하게 하기 위한 구멍이 있는 보드 버전 `1.3`도 있습니다. 하지만 보시다시피 이전 버전을 사용해도 됩니다.

*BADUSB* 기능을 사용하지 않거나, 탐지 범위가 줄어들더라도 BOOTSEL 사용을 유지하고 싶다면, *bootsel*이 활성화된 펌웨어도 제공하고 있습니다(폴더 및 릴리스 참조).


### 빌드 지침

> [Tz1rf](https://github.com/Tz1rf) 덕분에 두 개의 훌륭한 영상도 있습니다: 하나는 [빌드](https://youtu.be/7ymk8hD7-Hc) 과정을 단계별로 설명하고, 다른 하나는 [펌웨어 업로드](https://youtu.be/Tp8xvrlqxUY) 및 도구 사용 방법을 보여줍니다.

거의 모든 작업은 소프트웨어에 의해 보드에서 직접 수행되므로, 출력을 위한 OLED 연결만 구성하면 됩니다.

펌웨어 버전 0.8.0부터 **USBvalve**는 HID 장치(*BADUSB* 탐지에 사용)를 감지할 수 있습니다. 이를 위해서는 호스트로 동작하는 추가 USB 포트가 필요합니다. 이에 관심이 없다면 [docs 폴더의 이전 지침](https://github.com/cecio/USBvalve/blob/main/docs/BUILDING-1.1.md)을 사용하고 PCB 버전 `1.1`을 사용할 수 있습니다. 그렇지 않다면 PCB 버전 `1.2`로 진행하세요(USB-A 또는 USB-B용 버전이 있으며, 폴더 참조).

#### USBvalve PCB 사용 시

<p float="left">
  <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_front.png" width="25%" height="25%" />
  <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_back.png" width="24%" height="24%" /> 
</p>


- `USBH` 영역에 USB 암포트를 납땜합니다. 이는 버전 `A`용이지만, 원한다면 USB `Micro-B`용 버전도 있습니다
- 앞면의 실크 스크린 위에 Raspberry Pi Pico를 배치합니다
- 모든 PIN을 납땜할 필요는 없습니다. 다음만 하면 됩니다:
  - D4 및 D5 (왼쪽)
  - D14 및 D15 (왼쪽)
  - GND (오른쪽, 위에서 세 번째 핀)
  - GND (오른쪽, 아래에서 세 번째 핀)
  - 3v3_OUT (오른쪽)
  - VBUS (오른쪽)
  - 하단의 3개 DEBUG 핀: SWCLK, GND 및 SWDIO
- Raspberry에 닿을 수 있는 OLED 부분에 3D 프린터 스페이서 또는 테이프 조각을 배치합니다
- 4 PIN 공간에 OLED를 (헤더와 함께) 납땜합니다

일부 OLED는 GND와 VCC PIN이 바뀌어 있으므로, 두 버전 모두와 호환되도록 PCB를 제작했습니다:

예를 들어 OLED의 PIN1에 GND, PIN2에 VCC가 있는 경우:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_oled.png" width="35%" height="35%" />

PCB 뒷면의 이 두 패드에 납땜 덩어리를 올려야 합니다:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads.png" width="15%" height="15%" />

그렇지 않으면 반대로 다른 PAD에 납땜을 해야 합니다:

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads_2.png" width="15%" height="15%" />

#### USBvalve PCB 없이

<img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/pico-pinout.svg" alt="Pico Pi" width="85%" height="85%" />

브레드보드나 단순 배선을 사용하는 경우, OLED 화면과 호스트 USB 포트에 적절한 PIN을 연결하기만 하면 됩니다.

매핑은 다음과 같습니다:

- Pi의 PIN6 --> OLED SDA
- Pi의 PIN7 --> OLED SCL 
- Pi의 PIN19 --> USB 호스트의 D+
- Pi의 PIN20 --> USB 호스트의 D-
- Pi의 PIN23 (GND) --> USB 호스트의 GND
- Pi의 PIN38 (GND) --> OLED GND
- Pi의 PIN36 (3V3OUT) --> OLED VCC
- Pi의 PIN40 (VBUS) --> USB 호스트의 VCC

DEBUG 기능을 사용하려면 보드 하단의 3개 SWD PIN에 헤더를 배치할 수도 있습니다.

#### USBpipe PCB 사용 시

> [!CAUTION]
> 이 PCB는 숙련된 전자 제작자를 위한 것입니다
> **감당할 수 있다고 확신하지 않는다면 사용하지 마세요!**

> [!NOTE]
> R7과 R8은 실제로 아무것에도 연결되어 있지 않습니다. 회로 디버깅 목적으로 추가되었습니다.
> 따라서 BOM에 나타나지 않습니다

<img src="https://assets.kitploit.com/production/public/readmes/48341/248d33e236b13cc7c59905288ca1e06ae7a0ff36a3b7e99d2f66c4b27e5ab2bf.jpg" alt="USBpipe PCB" width="15%" height="15%"/>

<img src="https://assets.kitploit.com/production/public/readmes/48341/0159e8d6a4d68b6edcad459a6ebfcdce0f5787f2bca0ea5f06c6b3538baf75a2.jpg" alt="USBpipe" width="15%" height="15%"/>

[USBpipe](https://github.com/LiPolymer/smartUSBPipe)는 이 프로젝트를 위한 전용 PCB입니다.

필요한 모든 것은 `./PCB/USBpipe/` 폴더에서 찾을 수 있습니다.

<img src="https://assets.kitploit.com/production/public/readmes/48341/39c4a838734e4710cfe68529931961f387b1723654d5a4d3b1243d05925aa765.png" alt="Front" width="20%" height="20%"/>

<img src="https://assets.kitploit.com/production/public/readmes/48341/b34c6e01b06808aa0c21f17086d864b4b02fe4b4b453374d2840ae914aa524d6.png" alt="Back" width="20%" height="20%"/>

### 펌웨어 플래시

펌웨어를 플래시하려면 다음 단계를 따르세요:

- *BOOTSEL* 버튼(보드의 큰 흰색 버튼)을 누른 상태에서 USB 케이블로 Raspberry Pi Pico를 연결합니다
- 버튼을 놓습니다
- 시스템에 `RPI-RP2`라는 새 드라이브가 나타납니다(Linux 환경에서는 수동으로 마운트해야 할 수 있습니다)
- 사용한 OLED에 따라 적절한 펌웨어 파일(`uf2` 확장자)을 폴더에 복사합니다
- 마운트된 폴더가 사라질 때까지 몇 초 기다립니다

완료되었습니다!

### 안티 디텍션

그럴 일이 있을지는 모르겠지만, *USBvalve를 인식하는* 악성코드에 의한 탐지를 피하기 위해 펌웨어를 커스터마이즈하고 싶을 수 있습니다 :-)

수정하고 싶을 만한 대부분의 변수를 `usb_config.h`의 이 섹션에 모아두었습니다([재빌드는 아래 Dockerfile 참조](https://github.com/cecio/USBvalve#dockerfile))

```C
// USB anti-detection settings
//
// Set USB IDs strings and numbers, to avoid possible detections.
// Remember that you can cusotmize FAKE_DISK_BLOCK_NUM as well
// for the same reason. Also DISK_LABEL in ramdisk.h can be changed.
//
// You can see here for inspiration: https://the-sz.com/products/usbid/
//
#define USB_VENDORID       0xCAFE
#define USB_PRODUCTID      0x1337
#define USB_DESCRIPTOR     "DataStore"
#define USB_MANUF          "USB Acme"
#define USB_SERIAL         "123456789A"
#define USB_VENDORID_STR   "Acme"            // Up to 8 chars
#define USB_PRODUCTID_STR  "DataStore"       // Up to 16 chars
#define USB_VERSION_STR    "1.0"             // Up to 4 chars
```


### 펌웨어 빌드하기

물론 직접 펌웨어를 빌드할 수도 있습니다. 빌드하려면 *Raspberry Pi Pico SDK*와 이 저장소가 필요합니다.

기본 재컴파일 지침:
```
export PICO_SDK_PATH=</path/to/pico-sdk>

git clone --recursive https://github.com/cecio/USBvalve.git
cd USBvalve
mkdir build && cd build
cmake -DPICO_BOARD=pico ..   # or pico2 for standard build
make -j$(nproc)
# Output: build/src/USBvalve.uf2
```

새로운 가짜 파일 시스템을 다시 만들고 싶다면, 새로 빌드하기 위한 몇 가지 유틸리티를 넣어둔 `utils` 폴더를 살펴보세요.

#### Dockerfile

펌웨어를 커스터마이즈한 후 직접 빌드하고 싶다면, 완전한 빌드 환경을 구성하고 펌웨어를 컴파일하는 `Dockerfile`을 제공합니다.

빌드하려면 메인 `USBvalve` 폴더에서 다음 명령을 입력하세요:

```
# To Build:
#       docker build -t usbvalve-sdk -f Dockerfile.sdk .
#
# To Run (default: pico, SSD1306 OLED 128x32):
#       docker run --rm -v $PWD:/mnt usbvalve-sdk
#
# Options (via environment variables):
#       BOARD=pico|pico2          Board target (default: pico)
#       OLED_HEIGHT=32|64         OLED display height (default: 32)
#       PIWATCH=1                 Use GC9A01 round TFT instead of SSD1306
#       USE_BOOTSEL=1             Enable BOOTSEL button (disrupts Low Speed USB)
#
# Examples:
#       docker run --rm -e BOARD=pico2 -v $PWD:/mnt usbvalve-sdk
#       docker run --rm -e PIWATCH=1 -v $PWD:/mnt usbvalve-sdk
#       docker run --rm -e BOARD=pico2 -e OLED_HEIGHT=64 -v $PWD:/mnt usbvalve-sdk
```

펌웨어는 `USBvalve_out` 폴더에 `uf2` 확장자로 생성됩니다.

### 기여

아이디어나 개선 사항이 있다면, 이슈를 열어 함께 프로젝트를 개선할 수 있도록 해주세요! 감사합니다!

### 지원

질문이 있거나 지원이 필요하면 여기에서 `Issue`를 열거나 Twitter/X [@red5heep](https://twitter.com/red5heep)로 연락해 주세요.

### 커뮤니티 버전

커뮤니티에서 다른 보드 지원이나 기타 수정 사항을 구현한 몇 가지 포크를 만들었습니다. **USBvalve** 개발에 기여해 주신 **모든 분들께 감사드립니다**.
아래는 비공식/불완전/지원되지 않는 목록입니다:
- [USBvalve-tbfa-Mod](https://github.com/TryBreakFixAgain/USBvalve-tbfa-Mod)

## 안전 경고

> [!WARNING]
> **USBvalve**와 *USB 킬러 장치*에 관한 많은 질문을 받았습니다. **USBvalve**는 이러한 장치를 테스트하기 위해 만들어진 것이 아니며, 어떤 종류의 절연이나 보호 기능도 없습니다. 따라서 이러한 장치를 다루고 있다고 의심된다면 다른 것으로 테스트하세요. **USBvalve**로 테스트하지 마세요. 그렇지 않으면 장치, 자신 또는 주변 물체가 손상될 수 있습니다.
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →