RDP 자동화 시스템 문서 및 설치 스크립트 개선
- install-rdp-api.sh: curl 원라이너 설치 지원 - requirements.txt 의존성 제거 (패키지 버전 스크립트 내장) - rdp-toggle-api.py Gitea에서 자동 다운로드 - 상세한 설치 완료 메시지 추가 - RDP/README.md: 완전히 재구성 - curl 원라이너 설치 가이드 추가 - API 엔드포인트 상세 설명 및 응답 예시 - React 프론트엔드 연동 예시 개선 - 문제 해결 섹션 추가 - 네트워크 설정 및 방화벽 가이드 - README.md: RDP 자동화 섹션 추가 - Proxmox RDP 초기 설정 스크립트 소개 - RDP Toggle API 설치 가이드 - API 사용 예시 추가 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Claude
parent
c6919abf1c
commit
4934b0a8f9
325
RDP/README.md
325
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 (
|
||||
<div>
|
||||
<p>현재 모드: {status?.current_mode}</p>
|
||||
<button onClick={() => toggleMode('rdp')}>RDP 모드</button>
|
||||
<button onClick={() => toggleMode('shell')}>Shell 모드</button>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
```
|
||||
|
||||
## 설치 위치
|
||||
### 웹 기반 컨트롤 패널
|
||||
|
||||
- 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
|
||||
|
||||
@ -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\"}'"
|
||||
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 ""
|
||||
45
README.md
45
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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user