# Proxmox Auto RDP Setup Script

Proxmox VE 호스트가 부팅 시 자동으로 RDP 연결하도록 설정하는 자동화 스크립트입니다.

## 🚀 한 줄 설치

```bash
bash -c "$(curl -fsSL https://git.0bin.in/thug0bin/proxmox-rdp-autosetup/raw/branch/main/proxmox-auto-rdp-setup.sh)"
```

## 📋 기능

- **완전 자동화**: 사용자 입력 후 모든 설정 자동 수행
- **강화된 검증**: 입력값 검증 및 네트워크 연결 테스트
- **에러 처리**: 단계별 실패 처리 및 재시도 로직
- **백업**: 기존 설정 자동 백업
- **사용자 친화적**: 컬러 출력 및 진행 상황 표시

## 🎯 지원 환경

- **OS**: Proxmox VE 8.x 이상 (Debian 기반)
- **권한**: root 권한 필요
- **네트워크**: 인터넷 연결 필요

## 📖 동작 원리

1. **부팅 완료** → systemd가 tty1에서 rdpuser 자동 로그인
2. **로그인** → .bash_profile이 tty1에서 startx 실행
3. **X 시작** → .xinitrc가 실행됨
4. **Openbox 실행** → 윈도우 매니저 시작
5. **FreeRDP3 실행** → 풀스크린 RDP 연결
6. **RDP 종료시** → X 세션도 함께 종료

## 🔧 설치 과정

스크립트 실행 시 다음 정보를 입력하세요:

- **RDP 서버 주소** (예: example.com:3389)
- **RDP 사용자명**
- **RDP 패스워드**
- **로컬 사용자명** (기본값: rdpuser)

## 📝 설정 파일

스크립트가 자동 생성하는 주요 설정 파일들:

- `/etc/systemd/system/getty@tty1.service.d/override.conf` - 자동 로그인
- `/home/[사용자]/.bash_profile` - X 자동 시작
- `/home/[사용자]/.xinitrc` - RDP 연결 실행
- `/home/[사용자]/.config/openbox/rc.xml` - 풀스크린 최적화

## 🛡️ 보안 고려사항

- RDP 패스워드가 설정 파일에 평문으로 저장됩니다
- 운영 환경에서는 보안 강화 조치 필요
- 시스템 접근을 위해 Ctrl+Alt+F2로 다른 터미널 사용 가능

## 🔄 문제 해결

### 자주 발생하는 문제들

1. **RDP 연결 실패**
   - 서버 주소와 포트 확인
   - 방화벽 설정 확인
   - 인증 정보 확인

2. **화면 깜빡임**
   - X 서버 로그 확인: `cat /home/rdpuser/.local/share/xorg/Xorg.0.log`
   - systemd 로그 확인: `journalctl -u getty@tty1.service -f`

3. **설정 초기화**
   - 백업에서 복원: `/root/proxmox-rdp-backup-[날짜시간]/`

## 📚 상세 문서

더 자세한 설정 과정과 문제 해결 방법은 [proxmox_auto_rdp_setup_korean.md](./proxmox_auto_rdp_setup_korean.md)를 참고하세요.

## 🤝 기여

이슈나 개선 사항이 있다면 언제든 제보해주세요!

## 📄 라이선스

MIT License

---

**개발**: 시골약사 & Claude Code Assistant  
**생성일**: 2025-08-24  
**최종 업데이트**: v1.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>