시골약사
3ab509492f
✨ 주요 기능: - Proxmox VE 호스트 부팅 시 자동 RDP 연결 - 완전 자동화된 설정 스크립트 - 강화된 입력 검증 및 에러 처리 - 네트워크 연결 테스트 - 자동 백업 및 복구 기능 - 사용자 친화적 컬러 출력 🛠️ 기술 스택: - Bash Shell Script - systemd (자동 로그인) - X Window System + Openbox - FreeRDP3 (RDP 클라이언트) 🔧 주요 구성: - proxmox-auto-rdp-setup.sh: 메인 설치 스크립트 - proxmox_auto_rdp_setup_korean.md: 상세 한글 문서 - README.md: 프로젝트 개요 및 사용법 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
94 lines
2.8 KiB
Markdown
94 lines
2.8 KiB
Markdown
# 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> |