Raphire/Win11Debloat 딥다이브
— reg import와 Remove-AppxPackage로 윈도우를 청소하는 파워셸 스크립트

1프로젝트 한 줄 요약

Win11Debloat은 "윈도우를 깨끗하게 다듬는 파워셸 자동화 스크립트"다. 새 윈도우를 설치하거나 새 노트북을 켜면 캔디크러시·틱톡·엑스박스·코파일럿 같은 앱이 잔뜩 깔려 있고, 사용 정보가 마이크로소프트로 전송되고, 시작 메뉴·검색창·잠금화면에 광고와 추천이 붙는다. Win11Debloat은 이런 것들을 미리 준비된 목록대로 한 번에 제거·차단한다. "블로트웨어(bloatware, 쓸데없이 미리 깔린 군더더기 프로그램)"를 걷어낸다는 뜻에서 디블로트(debloat)라고 부른다.

이름은 "Win11"이지만 윈도우 10과 11을 모두 지원한다. 기능마다 "이 윈도우 빌드에서만 적용"이라는 조건이 붙어 있어서, 같은 스크립트가 두 OS를 안전하게 다룬다(§4에서 자세히). 그리고 설치가 필요 없다 — 프로그램을 깔지 않고, 파워셸 창에 한 줄만 붙여넣으면 인터넷에서 스크립트를 받아 바로 실행한다.

# 설치 없이 실행하는 "한 줄" (공식 방법)
& ([scriptblock]::Create((irm "https://debloat.raphi.re/")))
# irm = Invoke-RestMethod. 위 주소에서 부트스트랩 스크립트를 받아
# 그 자리에서 실행한다. 관리자 권한이 없으면 스스로 UAC 창을 띄워 승격한다.

2왜 지금 주목받는가

Win11Debloat은 2020년부터 있던 오래된 프로젝트인데, 꾸준히 트렌딩에 오른다. 최근의 동력은 뚜렷하다 — 마이크로소프트가 코파일럿(Copilot)·리콜(Recall)·클릭 투 두(Click to Do) 같은 AI 기능을 윈도우에 강하게 밀어넣으면서, "끄고 싶은데 방법이 흩어져 있다"는 불만이 커졌다. Win11Debloat은 이 스위치들을 한곳에 모아 꺼 준다. (TrendShift의 굵은 숫자는 별 수가 아니라 사회적 언급 모멘텀이다.) 인기 이유를 네 갈래로 본다.

주목 포인트 1 — "AI 기능을 끄고 싶다"는 수요의 집결지

최신 윈도우는 코파일럿 버튼, 화면을 계속 스냅샷으로 저장하는 리콜, 노트패드·그림판·엣지에까지 들어간 AI를 기본으로 켜 둔다. Win11Debloat의 AI 카테고리는 이걸 한 번에 정리한다 — 코파일럿 제거, 리콜의 스냅샷 저장 금지(DisableAIDataAnalysis=1), AI 서비스 WSAIFabricSvc 자동 시작 차단, 엣지·그림판·노트패드 AI 끄기까지. "AI를 원치 않는 사용자"의 원스톱 창구가 됐다.

주목 포인트 2 — 무설치 "한 줄" 실행의 압도적 편의

가장 강력한 매력은 설치가 없다는 것이다. irm | iex 한 줄이면 인터넷에서 스크립트를 받아 즉시 실행된다. 최신 릴리스(2026.07.11)에서 이 부트스트랩 파일(Get.ps1) 하나만 33,331번 내려받아졌을 정도다. IT 관리자에게는 더 매력적이다 — 명령줄 파라미터로 "무엇을 지울지"를 정해 무인(unattended) 자동 실행이 가능하고, 회사 PC 여러 대에 동일 설정을 뿌릴 수 있다.

주목 포인트 3 — "되돌릴 수 있다"는 심리적 안전망

시스템을 건드리는 도구는 무섭다. Win11Debloat은 이 두려움을 세 겹 안전망으로 낮춘다: ① 변경 전 관련 레지스트리 값을 스냅샷으로 백업하고, ② 원하면 시스템 복원 지점을 만들고, ③ 거의 모든 변경에 대응하는 Undo/(되돌리기) .reg 파일을 갖췄다. "거의 모든 앱은 마이크로소프트 스토어에서 재설치되고, 거의 모든 변경은 복구 가능"이라는 문구가 README의 신뢰 포인트다.

주목 포인트 4 — 파괴적이지 않은 "안전 우선" 태도

비슷한 디블로트 도구 중에는 시스템을 과격하게 뜯어내 오작동을 일으키는 것도 많다. Win11Debloat은 기본 제거 목록을 보수적으로 짜고(스토어·터미널·엣지 같은 "위험" 앱은 기본에서 빼고 삭제 전 재확인), 도메인(회사 네트워크)에 가입된 PC엔 "그룹 정책이 되돌릴 수 있음"을 경고한다. "청소는 하되 OS를 망가뜨리지 않는다"는 균형이 장기 신뢰를 만들었다.

비슷한 선택지와의 비교

3기술 스택 전체 지도

Win11Debloat은 언어가 단 하나, PowerShell 5.1뿐이다. 그런데 그 파워셸이 다루는 "재료"는 다채롭다 — 설정을 담은 JSON, 레지스트리를 바꾸는 .reg 파일, 화면을 그리는 XAML(WPF), 그리고 윈도우 기능을 켜는 DISM까지. 스택을 네 계층으로 나눠 본다.

계층 1 — 실행 엔진: Windows PowerShell 5.1

전체가 파워셸 스크립트(.ps1)로 되어 있다. 앱 제거는 Get-AppxPackage/Remove-AppxPackage, 레지스트리는 reg import, 예약 작업은 Disable-ScheduledTask, 윈도우 기능은 Enable-WindowsOptionalFeature(DISM) 같은 내장 명령(cmdlet)을 조합한다. 진입점 Win11Debloat.ps1(581줄)은 얇은 지휘자 역할이고, 실제 일은 Scripts/ 폴더의 75개 모듈 .ps1이 나눠 맡는다(dot-sourcing으로 불러온다).

계층 2 — 설정 데이터: JSON 3종 (동작의 단일 진실원)

이 프로젝트의 핵심 재설계 포인트. "무엇을 지우고 무엇을 바꿀지"가 코드가 아니라 데이터(JSON)에 들어 있다. Config/ 폴더의 세 파일이 전부다.

계층 3 — 시스템 변경 수단: .reg 파일 + 예약작업 + DISM

실제로 윈도우를 바꾸는 손발이다. 세 종류가 있다.

계층 4 — 사용자 인터페이스: WPF(XAML) GUI + 텍스트(CLI) 메뉴

파워셸 스크립트지만 클릭하는 그래픽 창이 있다. Schemas/의 XAML 9개가 창 모양을 정의하고, Scripts/GUI/가 WPF로 이를 띄운다. GUI를 못 띄우는 환경이면 자동으로 텍스트 메뉴(CLI)로 폴백한다. 배포용 옵션(-User·-Sysprep 등)을 주면 아예 CLI로 강제된다.

4아키텍처 심화 분석

Win11Debloat의 진짜 배울 점은 "실행 흐름 설계"다. 사용자가 무엇을 고르든(GUI 클릭 / CLI 메뉴 / 순수 명령줄 플래그) 결국 같은 한 갈래의 적용 파이프라인으로 모이도록 짜여 있다. 큰 그림부터 보자.

4-1. 전체 실행 시퀀스 (한 줄 명령이 하는 일)

여기서 눈여겨볼 설계는 "세 입구, 한 출구"다. GUI를 클릭하든, CLI 메뉴에서 번호를 고르든, -DisableTelemetry처럼 플래그를 직접 주든 — 전부 AddParameter로 $script:Params라는 하나의 목록에 쌓인 뒤, 동일한 Invoke-AllChanges로 흘러간다. 입력 방식과 적용 로직을 분리한 덕에, 대화형·무인 실행이 같은 코드로 굴러간다.

4-2. 시작 가드 — "실행하기 전에 거절부터"

이 스크립트가 인상적인 이유는 일을 하기 전에 먼저 안전하지 않은 상황을 거른다는 점이다. 순서대로 검사한다.

4-3. 적용 파이프라인 (InvokeChanges.ps1)

Invoke-AllChanges는 4단계로 움직인다: ①백업 → ②복원지점 → ③적용 → ④되돌리기. 핵심은 ③의 Invoke-FeatureApply 로직이다 — 기능에 .reg 파일이 연결돼 있으면 ImportRegistryFile로 넣고, 그 뒤 후속 부수효과를 switch로 처리한다.

# 기능 적용의 뼈대 (개념 재구성)
function Invoke-FeatureApply($featureId) {
    $f = $script:Features[$featureId]        # Features.json에서 조회
    if ($f.RegistryKey) {
        ImportRegistryFile $f.RegistryKey    # reg import 실행
    }
    switch ($featureId) {                     # .reg만으론 안 되는 후속 작업
        "DisableBing"   { RemoveApps @("Microsoft.BingSearch") }
        "DisableCopilot"{ RemoveApps @("Microsoft.Copilot","XP9CXNGPPJ97XX") }
        "DisableTelemetry"{ Disable-TelemetryScheduledTasks }   # 예약작업 8개 끄기
    }
}

즉 "레지스트리 한 방 + 필요하면 앱 제거·서비스 차단을 덤으로" 하는 구조다. 반대로 .reg가 없는 기능(앱 제거, 위젯 제거, 샌드박스/WSL 켜기, 시작 메뉴 비우기 등)은 순수 커스텀 로직으로 돈다.

4-4. 앱 제거의 실제 메커니즘

앱마다 제거 방식이 Apps.json에 적혀 있어(Appx 또는 WinGet), 그에 맞춰 처리한다. 범위(scope)도 셋으로 나뉜다.

# Appx 앱 제거 — 범위에 따라 분기 (개념 재구성)
switch ($scope) {
  "AllUsers" {
     Get-AppxPackage -Name $p -AllUsers | Remove-AppxPackage -AllUsers
     # 프로비저닝 패키지도 제거 → 미래 새 사용자에게 재설치 안 됨
     Get-AppxProvisionedPackage -Online | ... | Remove-ProvisionedAppxPackage -Online
  }
  "CurrentUser" { Get-AppxPackage $p | Remove-AppxPackage }
  default       { # 특정 사용자: 이름을 SID로 변환해 -User 로 지정 }
}

4-5. 오프라인 하이브 편집 — Sysprep / 다른 사용자 모드

가장 고급 기술. 보통 레지스트리 변경은 "지금 로그인한 나"에게만 적용된다. 그런데 -Sysprep 모드는 아직 만들어지지도 않은 "미래의 모든 새 사용자"에게 설정을 미리 적용한다. 어떻게? 기본 사용자 프로필의 레지스트리 파일(NTUSER.DAT)을 통째로 마운트해서 거기에 값을 쓴다.

# 오프라인 하이브 마운트 → 편집 → 언마운트 (개념)
reg load  "HKU\Default"  "C:\Users\Default\NTUSER.DAT"   # 기본 프로필 하이브 장착
reg import "Regfiles\Sysprep\Disable_Telemetry.reg"            # HKEY_CURRENT_USER 대신
                                                          # hkey_users\default 로 쓰는 버전
reg unload "HKU\Default"                                    # finally 블록에서 반드시 해제

이래서 Regfiles/Sysprep/에 같은 .reg가 하나 더 있는 것이다 — 경로만 HKEY_CURRENT_USER → hkey_users\default로 바꾼 쌍둥이 버전. 새 사용자를 만들면 이 기본 프로필을 복사해 오므로, 설정이 그대로 상속된다. 기업 이미징에서 쓰는 진짜 기법을 개인용 스크립트에 담은 것이다.

4-6. 되돌리기와 멱등성 — 두 번 돌려도 안전

Win11Debloat은 같은 설정을 여러 번 적용해도 문제없게(멱등, idempotent) 설계됐다. GetCurrentTweakState.ps1이 각 기능의 .reg를 읽어 지금 레지스트리 상태와 비교해, 이미 적용됐는지 알려 준다(GUI가 현재 상태를 체크로 표시). 되돌리기(Undo/) .reg는 두 방식으로 원복한다.

# 되돌리기 .reg의 두 가지 문법
# 방법 A — 반대 값을 다시 씀
[HKEY_CURRENT_USER\...\DataCollection]
"AllowTelemetry"=dword:00000001      # 0(끔) → 1(켬)으로 복구

# 방법 B — 값을 통째로 삭제 ("=-" 문법)
[HKEY_CURRENT_USER\...\InputPersonalization]
"RestrictImplicitInkCollection"=-    # 이 값 자체를 지움 = 기본으로

.reg에서 "이름"=-는 "그 값을 삭제하라"는 뜻이다. 원래 없던 값을 넣었던 경우엔 이렇게 지워야 완전한 원상복구가 된다. 되돌리기까지 데이터(.reg)로 선언해 둔 점이 이 저장소의 성숙함을 보여 준다.

5디렉토리 · 파일 구조 해부

Win11Debloat의 폴더 구조 자체가 "코드는 코드끼리, 설정은 설정끼리, 리소스는 리소스끼리"라는 관심사 분리를 보여 준다. 예전의 단일 파일 시절과 가장 크게 달라진 부분이다.

6학습 포인트

Win11Debloat은 "블로트 제거 도구"라는 겉모습 너머, 윈도우를 프로그램으로 관리하는 거의 모든 기법의 종합 선물세트다. 시스템 관리·데브옵스·자동화에 관심 있다면 실전 예제로 손색이 없다.

배울 것 1 — 데이터 주도 설계 (정책과 메커니즘의 분리)

가장 큰 교훈. "무엇을 할지(정책)"를 코드가 아닌 JSON 데이터로 빼내면, 기능 추가가 코드 수정이 아니라 데이터 한 줄 추가가 된다. Features.json 한 곳이 CLI 요약·GUI 체크박스·적용 루프 세 곳에 동시에 쓰인다는 점을 보라 — 한 벌의 메타데이터가 여러 표현을 만든다. 이 사고방식은 어떤 언어·프로젝트에도 옮겨 쓸 수 있다.

배울 것 2 — 파워셸로 하는 윈도우 관리 cmdlet

Get-AppxPackage/Remove-AppxPackage(앱), Disable-ScheduledTask(예약작업), Enable-WindowsOptionalFeature(DISM/윈도우 기능), Checkpoint-Computer(복원지점), reg import(레지스트리)까지 — 실무에서 쓰는 관리 명령이 한 저장소에 실전 형태로 모여 있다. 각 명령이 어떤 상황에서 어떻게 쓰이는지 문맥과 함께 배운다.

배울 것 3 — 레지스트리와 .reg 파일 다루기

Regfiles/를 읽으면 다크모드·텔레메트리·컨텍스트 메뉴 같은 설정이 실제로 어떤 레지스트리 키에 사는지 구체적으로 알 수 있다. 예를 들어 다크 모드는 ...\Themes\Personalize의 AppsUseLightTheme=0, 윈도우10식 우클릭 메뉴는 특정 CLSID의 기본값을 빈 문자열로 비우는 트릭이다. "이름"=- 삭제 문법까지 배우면 .reg를 자유롭게 쓸 수 있다.

배울 것 4 — 오프라인 하이브 & 기본 프로필 (기업 이미징 기법)

reg load/reg unload로 NTUSER.DAT를 마운트해 로그인하지 않은 사용자의 레지스트리를 편집하는 기법은, 윈도우를 대량 배포하는 IT 관리자가 실제로 쓰는 고급 기술이다. Win11Debloat의 -Sysprep 경로를 따라가면 "기본 프로필을 손봐 모든 새 계정에 상속"시키는 원리를 손에 잡히게 익힌다.

배울 것 5 — 대화형 + 무인 실행을 한 코드로

-Silent 하나로 모든 프롬프트를 끄고, -Config/-RunSavedSettings로 설정을 재생하는 설계는 "사람이 클릭하는 도구"와 "스크립트가 자동으로 돌리는 도구"를 동시에 만족시킨다. GUI 클릭·CLI 메뉴·명령줄 플래그가 모두 하나의 파라미터 목록으로 합류하는 구조(§4-1)는, 자동화 도구를 설계할 때 두고두고 참고할 패턴이다.

배울 것 6 — 방어적 프로그래밍 & 우아한 실패

실행 전 가드(PS7 거부·SYSTEM 차단·도메인 경고), reg import 실패 시 순수 파워셸 레지스트리 작성기로 폴백, GUI 못 뜨면 CLI로 폴백, winget 없으면 경고 후 계속 — "실패할 수 있는 모든 지점에 대비책"이 깔려 있다. Base64로 셸 특수문자를 무력화하는 보안 디테일까지, "믿을 수 없는 환경에서 안전하게 도는 스크립트"의 교본이다.

7시스템 · 실행 요구사항

요구사항은 가볍지만, 파워셸 버전에 결정적인 함정이 있다.

세 가지 실행 방법

대표 명령줄 파라미터 (약 114개 중 핵심)

앱 제거 목록의 3단계 안전 등급 (Apps.json, 141개)

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크