프로젝트 소개
Dockur Windows는 Docker/Podman 컨테이너 이미지로, 컨테이너 안에서 Windows를 실행할 수 있게 해줍니다. 선택한 Windows 버전의 다운로드와 설치를 자동화한 뒤, 포트 8006의 웹 뷰어와 Microsoft Remote Desktop(RDP)을 통해 접속할 수 있게 합니다.
주요 기능:
- Docker 컨테이너 안에서 Windows 실행
- 자동 다운로드 및 무인 설치
- Windows 95부터 Windows 11까지, Windows Server 2003-2025, 그리고 Tiny11, ReactOS 같은 일부 커뮤니티 변형판을 포함한 최신 및 레거시 Windows 릴리스 지원
- KVM 가속을 통한 거의 네이티브에 가까운 성능
- 사용자 지정 가능한 CPU, 메모리, 스토리지 할당
- 메모리 벌루닝을 통한 동적 메모리 할당
- USB 패스스루 및 호스트 폴더 공유
- NAT, user-mode, macvlan, macvtap 네트워킹 지원
- 브라우저로의 선택적 오디오 스트리밍
- 설치 중 Active Directory 도메인 가입 가능
- 설치 후 사용자 지정 명령 또는 install.bat 스크립트 실행 가능
요구 사항:
- KVM을 지원하는 Linux 호스트의 Docker 또는 Podman
- 중첩 가상화가 활성화된 Windows 11의 Docker Desktop 또는 Podman Desktop
- 최소 2GB의 사용 가능한 RAM
- 최소 32GB의 여유 디스크 공간
Linux, macOS, Windows 10의 Docker Desktop은 컨테이너에 KVM 접근을 제공하지 않으므로 지원되지 않습니다.
기본 Docker Compose 사용법:
```yaml
services:
windows:
image: dockurr/windows
container_name: windows
environment:
VERSION: "11"
devices:
- /dev/kvm
- /dev/net/tun
cap_add:
- NET_ADMIN
ports:
- 8006:8006
- 3389:3389/tcp
- 3389:3389/udp
volumes:
- ./windows:/storage
restart: always
stop_grace_period: 2m
```
컨테이너를 시작한 뒤 브라우저에서 http://127.0.0.1:8006/ 을 열고 자동 설치가 끝날 때까지 기다립니다. 기본 RDP 자격 증명은 사용자 이름 `Docker`, 비밀번호 `admin`이며, `USERNAME` 및 `PASSWORD` 환경 변수로 사용자 지정할 수 있습니다.
일반적인 환경 변수는 다음과 같습니다:
- `VERSION` — Windows 버전을 선택합니다. 예: `11`, `10`, `2022`, 또는 사용자 지정 ISO URL
- `LANGUAGE` — 설치 언어를 선택합니다
- `RAM_SIZE` 및 `CPU_CORES` — 할당된 리소스를 조정합니다
- `DISK_SIZE` — 기본 64GB 디스크 크기를 변경합니다
- `DISK2_SIZE` / `DISK3_SIZE` — 추가 디스크를 추가합니다
- `AUDIO` — 브라우저 오디오 스트리밍을 활성화합니다
- `DOMAIN` 및 `DOMAIN_OU` — 자동 Active Directory 도메인 가입
- `DHCP` — Windows가 라우터에서 직접 IP를 요청하도록 합니다
- `ARGUMENTS` — 추가 QEMU 인수를 전달합니다. 예: USB 장치 패스스루용
스토리지는 `/storage`에 바인드 마운트하여 변경할 수 있습니다. `/shared`에 바인드된 폴더는 Windows 데스크톱에 `Shared`로, 그리고 드라이브 `Z:`로 나타납니다. 지원되지 않는 이미지를 설치하려면 ISO를 `/custom.iso`에 마운트하거나, `VERSION`을 통해 URL을 제공할 수 있습니다.
이 프로젝트는 macvlan 네트워킹이 Docker 호스트에서 컨테이너 IP에 접근하는 것을 막는다는 점, 그리고 USB 대용량 저장 장치는 첫 실행 중 연결을 끊어 두어야 실수로 포맷되는 것을 피할 수 있다는 점을 언급합니다.
이 프로젝트는 오픈 소스 코드만 포함하며 Windows 자체를 배포하지 않습니다. 코드에서 발견되는 제품 키는 Microsoft가 체험 목적으로 공개한 일반 설치 키이며 유효한 정품 인증 라이선스가 아닙니다. 사용자는 유효한 Windows 라이선스를 보유할 책임이 있습니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.