Proxmox Auto RDP Setup Script

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

🚀 한 줄 설치

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를 참고하세요.

🤝 기여

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

📄 라이선스

MIT License

---

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

🤖 Generated with Claude Code

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