diff --git a/RDP/README.md b/RDP/README.md
index b8e4462..4ef51d7 100644
--- a/RDP/README.md
+++ b/RDP/README.md
@@ -1,95 +1,304 @@
-# RDP Toggle API
+# Proxmox RDP 자동화 시스템
-Proxmox VE 호스트에서 RDP/Shell 모드를 API로 전환할 수 있는 시스템
+Proxmox VE 호스트에서 **RDP 초기 설정** 및 **RDP/Shell 모드 API 전환**을 지원하는 통합 솔루션
## 개요
-외부에서 API 호출을 통해 Proxmox 호스트의 물리적 화면을 Shell 모드와 RDP 모드로 전환할 수 있습니다.
-프론트엔드에서 토글 버튼으로 화면 모드를 실시간으로 제어할 수 있습니다.
+이 시스템은 두 가지 주요 기능을 제공합니다:
-## 구성 파일
+1. **Proxmox RDP 초기 설정** - 부팅 시 자동으로 원격 Windows PC에 RDP 연결
+2. **RDP Toggle API** - 외부에서 API 호출로 RDP/Shell 모드 실시간 전환
-- **rdp-toggle-api.py** - FastAPI 기반 REST API 서버
-- **install-rdp-api.sh** - 자동 설치 스크립트 (venv 환경)
-- **requirements.txt** - Python 패키지 의존성
-- **RDP_TOGGLE_API.md** - API 상세 문서
-- **rdp-toggle-web.html** - 웹 기반 컨트롤 패널
-- **proxmox-auto-rdp-setup.sh** - Proxmox RDP 초기 설정 스크립트
-- **proxmox_auto_rdp_setup_korean.md** - 초기 설정 가이드
+프론트엔드 또는 curl 명령으로 Proxmox 물리 화면을 Shell ↔ RDP 모드로 즉시 전환 가능합니다.
-## 빠른 시작
+---
+
+## 🚀 빠른 설치
+
+### 1️⃣ Proxmox RDP 초기 설정 (자동 부팅 연결)
+
+Proxmox 호스트가 부팅 시 자동으로 RDP 연결하도록 설정:
```bash
-# 1. 설치
-chmod +x install-rdp-api.sh
-./install-rdp-api.sh
+curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/proxmox-auto-rdp-setup.sh | bash
+```
-# 2. 서비스 확인
+**설치 내용:**
+- ✅ X Window + Openbox 윈도우 매니저
+- ✅ FreeRDP3 클라이언트 설치
+- ✅ 자동 로그인 및 X 시작 설정
+- ✅ RDP 서버 연결 정보 구성
+- ✅ 풀스크린 RDP 자동 실행
+
+### 2️⃣ RDP Toggle API 설치 (원격 제어)
+
+API를 통해 RDP/Shell 모드를 원격으로 전환:
+
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/install-rdp-api.sh | bash
+```
+
+**설치 내용:**
+- ✅ FastAPI 기반 REST API 서버
+- ✅ Python venv 환경 구성
+- ✅ systemd 서비스 자동 시작
+- ✅ 포트 8090에서 API 실행
+
+---
+
+## 📖 사용 방법
+
+### RDP Toggle API 사용
+
+#### 서비스 확인
+```bash
systemctl status rdp-toggle-api
-
-# 3. API 테스트
-curl http://localhost:8090/status
```
-## API 엔드포인트
-
-### GET /status
-현재 상태 확인
+#### API 테스트
```bash
+# 현재 상태 확인
curl http://localhost:8090/status
-```
-### POST /toggle
-모드 전환
-```bash
-# RDP 모드
+# RDP 모드로 전환
curl -X POST http://localhost:8090/toggle \
-H 'Content-Type: application/json' \
-d '{"mode":"rdp"}'
-# Shell 모드
+# Shell 모드로 전환
curl -X POST http://localhost:8090/toggle \
-H 'Content-Type: application/json' \
-d '{"mode":"shell"}'
```
-## 리액트 연동 예시
+---
+
+## 📡 API 엔드포인트
+
+### GET /status
+현재 RDP/Shell 모드 상태 확인
+```bash
+curl http://localhost:8090/status
+```
+
+**응답 예시:**
+```json
+{
+ "current_mode": "shell",
+ "rdp_active": false,
+ "last_changed": "2025-11-17T10:30:00",
+ "config": {
+ "rdp_server": "192.168.0.229",
+ "rdp_username": "user",
+ "local_user": "rdpuser"
+ }
+}
+```
+
+### POST /toggle
+RDP/Shell 모드 전환
+```bash
+# RDP 모드 활성화
+curl -X POST http://localhost:8090/toggle \
+ -H 'Content-Type: application/json' \
+ -d '{"mode":"rdp"}'
+
+# Shell 모드로 전환
+curl -X POST http://localhost:8090/toggle \
+ -H 'Content-Type: application/json' \
+ -d '{"mode":"shell"}'
+```
+
+### GET /config
+현재 RDP 연결 설정 조회
+```bash
+curl http://localhost:8090/config
+```
+
+### PUT /config
+RDP 연결 설정 업데이트
+```bash
+curl -X PUT http://localhost:8090/config \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "rdp_server": "new-server.example.com:3389",
+ "rdp_username": "newuser",
+ "rdp_password": "newpassword"
+ }'
+```
+
+---
+
+## 🔗 프론트엔드 연동
+
+### React 예시
```jsx
-const [status, setStatus] = useState(null);
-const API_URL = 'http://your-proxmox-ip:8090';
+import { useState, useEffect } from 'react';
-// 상태 확인
-const fetchStatus = async () => {
- const res = await fetch(`${API_URL}/status`);
- const data = await res.json();
- setStatus(data);
-};
+const RDPToggle = () => {
+ const [status, setStatus] = useState(null);
+ const API_URL = 'http://your-proxmox-ip:8090';
-// 모드 전환
-const toggleMode = async (mode) => {
- await fetch(`${API_URL}/toggle`, {
- method: 'POST',
- headers: { 'Content-Type': 'application/json' },
- body: JSON.stringify({ mode })
- });
+ // 상태 확인
+ const fetchStatus = async () => {
+ const res = await fetch(`${API_URL}/status`);
+ const data = await res.json();
+ setStatus(data);
+ };
+
+ // 모드 전환
+ const toggleMode = async (mode) => {
+ await fetch(`${API_URL}/toggle`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ mode })
+ });
+ fetchStatus(); // 상태 갱신
+ };
+
+ useEffect(() => {
+ fetchStatus();
+ }, []);
+
+ return (
+
+
현재 모드: {status?.current_mode}
+
+
+
+ );
};
```
-## 설치 위치
+### 웹 기반 컨트롤 패널
-- API 서버: `/opt/rdp-toggle-api/`
-- Python 가상환경: `/opt/rdp-toggle-api/venv/`
-- systemd 서비스: `/etc/systemd/system/rdp-toggle-api.service`
+간단한 HTML 기반 컨트롤 패널도 제공됩니다:
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/rdp-toggle-web.html -o rdp-control.html
+```
-## 기능
+브라우저에서 `rdp-control.html` 파일을 열어 사용하세요.
-- ✅ RDP ↔ Shell 모드 전환
-- ✅ 실시간 상태 모니터링
-- ✅ CORS 지원 (외부 접근 가능)
-- ✅ venv 환경 (패키지 충돌 방지)
-- ✅ systemd 서비스 (자동 시작)
+---
-## 포트
+## 📂 구성 파일
-기본 포트: **8090**
+### 설치 위치
+- **API 서버**: `/opt/rdp-toggle-api/`
+- **Python 가상환경**: `/opt/rdp-toggle-api/venv/`
+- **systemd 서비스**: `/etc/systemd/system/rdp-toggle-api.service`
+
+### 구성 파일 목록
+- `rdp-toggle-api.py` - FastAPI 기반 REST API 서버
+- `install-rdp-api.sh` - 자동 설치 스크립트 (curl 실행 가능)
+- `proxmox-auto-rdp-setup.sh` - Proxmox RDP 초기 설정 스크립트
+- `rdp-toggle-web.html` - 웹 기반 컨트롤 패널
+- `requirements.txt` - Python 패키지 의존성
+
+---
+
+## ✨ 주요 기능
+
+- ✅ **RDP ↔ Shell 모드 즉시 전환**
+- ✅ **실시간 상태 모니터링** (프로세스 확인)
+- ✅ **CORS 지원** (외부 프론트엔드 접근 가능)
+- ✅ **Python venv 환경** (시스템 패키지 충돌 방지)
+- ✅ **systemd 서비스** (자동 시작, 재시작)
+- ✅ **설정 동적 변경** (API로 RDP 서버 정보 변경)
+- ✅ **curl 원라이너 설치** (웹에서 바로 복사해서 실행)
+
+---
+
+## 🔧 서비스 관리
+
+```bash
+# 서비스 상태 확인
+systemctl status rdp-toggle-api
+
+# 서비스 재시작
+systemctl restart rdp-toggle-api
+
+# 서비스 중지
+systemctl stop rdp-toggle-api
+
+# 서비스 시작
+systemctl start rdp-toggle-api
+
+# 로그 확인
+journalctl -u rdp-toggle-api -f
+```
+
+---
+
+## 🌐 네트워크 설정
+
+- **기본 포트**: `8090`
+- **바인드 주소**: `0.0.0.0` (모든 인터페이스)
+- **CORS**: 모든 origin 허용 (`allow_origins=["*"]`)
+
+외부에서 접근하려면 방화벽에서 포트 8090을 허용하세요:
+```bash
+# UFW 사용 시
+ufw allow 8090/tcp
+
+# iptables 사용 시
+iptables -A INPUT -p tcp --dport 8090 -j ACCEPT
+```
+
+---
+
+## 📚 참고 문서
+
+- [RDP_TOGGLE_API.md](RDP_TOGGLE_API.md) - API 상세 문서
+- [proxmox_auto_rdp_setup_korean.md](proxmox_auto_rdp_setup_korean.md) - RDP 초기 설정 가이드
+
+---
+
+## 🐛 문제 해결
+
+### API 서버가 시작되지 않는 경우
+```bash
+# 로그 확인
+journalctl -u rdp-toggle-api -n 50
+
+# Python 가상환경 재설치
+rm -rf /opt/rdp-toggle-api/venv
+python3 -m venv /opt/rdp-toggle-api/venv
+/opt/rdp-toggle-api/venv/bin/pip install fastapi uvicorn python-multipart pydantic
+systemctl restart rdp-toggle-api
+```
+
+### RDP 모드 전환이 작동하지 않는 경우
+```bash
+# RDP 초기 설정이 완료되었는지 확인
+ls -la /home/rdpuser/.xinitrc
+cat /etc/systemd/system/getty@tty1.service.d/override.conf
+
+# FreeRDP3 설치 확인
+which xfreerdp3
+```
+
+### 포트 8090이 이미 사용 중인 경우
+```bash
+# 포트 사용 확인
+ss -tulpn | grep 8090
+
+# API 서비스 파일에서 포트 변경
+nano /opt/rdp-toggle-api/rdp-toggle-api.py
+# 마지막 줄: uvicorn.run(app, host="0.0.0.0", port=8090)
+# 포트 번호를 원하는 값으로 변경 후 저장
+
+systemctl restart rdp-toggle-api
+```
+
+---
+
+## 📄 라이선스
+
+MIT License
+
+---
+
+**작성자**: thug0bin
+**리포지토리**: https://git.0bin.in/thug0bin/pve9-repo-fix
diff --git a/RDP/install-rdp-api.sh b/RDP/install-rdp-api.sh
index 0f6d55f..645e199 100755
--- a/RDP/install-rdp-api.sh
+++ b/RDP/install-rdp-api.sh
@@ -1,6 +1,7 @@
#!/bin/bash
# RDP Toggle API 설치 스크립트
+# curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/install-rdp-api.sh | bash
set -e
@@ -9,10 +10,12 @@ echo "RDP Toggle API 설치 시작..."
# 설치 디렉토리 설정
INSTALL_DIR="/opt/rdp-toggle-api"
VENV_DIR="$INSTALL_DIR/venv"
+GITEA_BASE_URL="https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP"
# Python 및 venv 설치
+echo "Python 및 필수 패키지 설치 중..."
apt update
-apt install -y python3 python3-venv python3-pip
+apt install -y python3 python3-venv python3-pip curl
# 설치 디렉토리 생성
mkdir -p "$INSTALL_DIR"
@@ -22,15 +25,17 @@ echo "가상환경 생성 중..."
python3 -m venv "$VENV_DIR"
# 가상환경에서 패키지 설치
-echo "패키지 설치 중..."
+echo "Python 패키지 설치 중..."
"$VENV_DIR/bin/pip" install --upgrade pip
-"$VENV_DIR/bin/pip" install -r requirements.txt
+"$VENV_DIR/bin/pip" install fastapi==0.115.5 uvicorn==0.32.1 python-multipart==0.0.20 pydantic==2.10.3
-# API 파일 복사
-cp rdp-toggle-api.py "$INSTALL_DIR/"
+# API 파일 다운로드
+echo "API 서버 파일 다운로드 중..."
+curl -fsSL "$GITEA_BASE_URL/rdp-toggle-api.py" -o "$INSTALL_DIR/rdp-toggle-api.py"
chmod +x "$INSTALL_DIR/rdp-toggle-api.py"
# systemd 서비스 생성
+echo "systemd 서비스 생성 중..."
cat > /etc/systemd/system/rdp-toggle-api.service << EOF
[Unit]
Description=RDP Toggle API Service
@@ -49,14 +54,38 @@ WantedBy=multi-user.target
EOF
# 서비스 활성화 및 시작
+echo "서비스 활성화 및 시작 중..."
systemctl daemon-reload
systemctl enable rdp-toggle-api.service
systemctl start rdp-toggle-api.service
-echo "RDP Toggle API 설치 완료!"
-echo "API 서버가 포트 8090에서 실행 중입니다."
+# 잠시 대기 후 상태 확인
+sleep 2
+
echo ""
-echo "사용 방법:"
-echo " 상태 확인: curl http://localhost:8090/status"
-echo " RDP 모드: curl -X POST http://localhost:8090/toggle -H 'Content-Type: application/json' -d '{\"mode\":\"rdp\"}'"
-echo " Shell 모드: curl -X POST http://localhost:8090/toggle -H 'Content-Type: application/json' -d '{\"mode\":\"shell\"}'"
\ No newline at end of file
+echo "=========================================="
+echo "RDP Toggle API 설치 완료!"
+echo "=========================================="
+echo ""
+echo "📍 API 서버: http://$(hostname -I | awk '{print $1}'):8090"
+echo "📁 설치 위치: $INSTALL_DIR"
+echo ""
+echo "✅ 사용 방법:"
+echo " 상태 확인:"
+echo " curl http://localhost:8090/status"
+echo ""
+echo " RDP 모드 활성화:"
+echo " curl -X POST http://localhost:8090/toggle \\"
+echo " -H 'Content-Type: application/json' \\"
+echo " -d '{\"mode\":\"rdp\"}'"
+echo ""
+echo " Shell 모드 전환:"
+echo " curl -X POST http://localhost:8090/toggle \\"
+echo " -H 'Content-Type: application/json' \\"
+echo " -d '{\"mode\":\"shell\"}'"
+echo ""
+echo "🔧 서비스 관리:"
+echo " systemctl status rdp-toggle-api"
+echo " systemctl restart rdp-toggle-api"
+echo " systemctl stop rdp-toggle-api"
+echo ""
\ No newline at end of file
diff --git a/README.md b/README.md
index f799f9d..9178bd9 100644
--- a/README.md
+++ b/README.md
@@ -277,6 +277,51 @@ chmod +x pve-host-changer.sh
- 클러스터 구성 시 신중하게 진행 필요
- 변경 후 시스템 재부팅 권장
+## 🖥️ Proxmox RDP 자동화
+
+**Proxmox 호스트에서 RDP 자동 연결 및 원격 제어**:
+
+### RDP 초기 설정 (부팅 시 자동 연결)
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/proxmox-auto-rdp-setup.sh | bash
+```
+
+**기능:**
+- ✅ 부팅 시 자동으로 RDP 서버에 연결
+- ✅ 풀스크린 RDP 세션
+- ✅ X Window + Openbox 자동 설정
+- ✅ FreeRDP3 클라이언트 설치
+
+### RDP Toggle API 설치 (원격 모드 전환)
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/RDP/install-rdp-api.sh | bash
+```
+
+**기능:**
+- ✅ **REST API로 RDP/Shell 모드 전환**
+- ✅ FastAPI 기반 서버 (포트 8090)
+- ✅ 프론트엔드 통합 가능 (CORS 지원)
+- ✅ 실시간 상태 모니터링
+- ✅ 설정 동적 변경 (API로 RDP 서버 정보 변경)
+
+### API 사용 예시
+```bash
+# 현재 상태 확인
+curl http://localhost:8090/status
+
+# RDP 모드로 전환
+curl -X POST http://localhost:8090/toggle \
+ -H 'Content-Type: application/json' \
+ -d '{"mode":"rdp"}'
+
+# Shell 모드로 전환
+curl -X POST http://localhost:8090/toggle \
+ -H 'Content-Type: application/json' \
+ -d '{"mode":"shell"}'
+```
+
+📖 **자세한 가이드**: [RDP/README.md](RDP/README.md)
+
## 라이선스
MIT License