proxmox-ip-changer/README.md
시골약사 41a5ca283f Initial commit: Proxmox IP Changer
 Proxmox 호스트 IP 자동 변경 스크립트
- IP 주소 자동 변경 기능
- 설정 파일 자동 백업
- IP 유효성 검증
- 컬러풀한 UI

🛠️ 기술 스택:
- Bash Shell Script
- Proxmox VE Compatible

🔧 주요 구성:
- change_proxmox_ip.sh: 메인 스크립트
- README.md: 사용 설명서

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-06 11:39:46 +09:00

133 lines
3.9 KiB
Markdown

# 🔧 Proxmox IP 자동 변경 스크립트
Proxmox 호스트의 IP 주소를 안전하고 쉽게 변경할 수 있는 자동화 스크립트입니다.
## 🚀 한 줄 설치 및 실행
```bash
bash -c "$(curl -fsSL https://git.0bin.in/thug0bin/proxmox-ip-changer/raw/branch/main/change_proxmox_ip.sh)"
```
## 📋 주요 기능
-**자동 백업**: 설정 파일 변경 전 자동 백업
-**IP 유효성 검증**: 입력된 IP 주소의 형식 자동 검증
-**현재 설정 표시**: 현재 네트워크 설정 확인
-**컬러풀한 출력**: 시각적으로 구분하기 쉬운 색상 표시
-**안전한 변경**: 변경 전 확인 절차
-**다양한 재부팅 옵션**: 즉시 재부팅, 네트워크만 재시작, 수동 재부팅 선택 가능
## 📌 요구사항
- Proxmox VE 6.x 이상
- Root 권한
- SSH 접속 가능한 환경
## 🛠️ 사용 방법
### 방법 1: 원격 실행 (권장)
```bash
# 직접 실행
bash -c "$(curl -fsSL https://git.0bin.in/thug0bin/proxmox-ip-changer/raw/branch/main/change_proxmox_ip.sh)"
```
### 방법 2: 다운로드 후 실행
```bash
# 스크립트 다운로드
curl -O https://git.0bin.in/thug0bin/proxmox-ip-changer/raw/branch/main/change_proxmox_ip.sh
# 실행 권한 부여
chmod +x change_proxmox_ip.sh
# 스크립트 실행
sudo ./change_proxmox_ip.sh
```
## 📝 스크립트 동작 과정
1. **권한 확인**: Root 권한 확인
2. **현재 설정 표시**:
- 활성 네트워크 인터페이스
- 현재 IP 주소 및 서브넷
- 게이트웨이
- 호스트명
3. **백업 생성**:
- `/etc/network/interfaces` 백업
- `/etc/hosts` 백업
4. **새 IP 정보 입력**:
- 새 IP 주소 (유효성 검증)
- 서브넷 마스크 (기본값 제공)
- 게이트웨이 (기본값 제공)
5. **변경 사항 확인**: 변경 전 최종 확인
6. **설정 파일 수정**:
- `/etc/network/interfaces` 수정
- `/etc/hosts` 수정
7. **재부팅 옵션 선택**:
- 옵션 1: 즉시 재부팅
- 옵션 2: 네트워크 서비스만 재시작
- 옵션 3: 나중에 수동으로 재부팅
## 🔒 안전 기능
- **자동 백업**: 모든 설정 파일은 변경 전 자동으로 백업됩니다
- 백업 파일 위치: `/etc/network/interfaces.backup.날짜시간`
- 백업 파일 위치: `/etc/hosts.backup.날짜시간`
- **IP 유효성 검증**: 잘못된 IP 주소 입력 방지
- **변경 전 확인**: 실제 변경 전 사용자 확인 필수
- **변경 내용 표시**: 변경된 설정 파일 내용 즉시 확인
## ⚠️ 주의사항
- SSH 연결로 작업 중일 경우, IP 변경 후 연결이 끊어집니다
- 새 IP 주소로 다시 연결해야 합니다
- 변경 전 현재 설정을 반드시 메모해두세요
- 물리적 접근이 가능한 상태에서 작업하는 것을 권장합니다
## 🔄 복구 방법
설정 실수로 인한 문제 발생 시:
```bash
# 백업 파일 확인
ls -la /etc/network/interfaces.backup.*
ls -la /etc/hosts.backup.*
# 백업 파일로 복구
cp /etc/network/interfaces.backup.날짜시간 /etc/network/interfaces
cp /etc/hosts.backup.날짜시간 /etc/hosts
# 네트워크 재시작
systemctl restart networking
```
## 📊 테스트 환경
- ✅ Proxmox VE 8.x
- ✅ Proxmox VE 7.x
- ✅ Proxmox VE 6.x
- ✅ Debian 11 (Bullseye)
- ✅ Debian 12 (Bookworm)
## 🤝 기여
이슈 발견이나 개선 사항이 있으시면 GitHub Issues를 통해 알려주세요.
## 📄 라이선스
MIT License
## 👤 작성자
- **시골약사** (thug0bin)
- Email: thug0bin@gmail.com
- GitHub: [https://git.0bin.in/thug0bin](https://git.0bin.in/thug0bin)
## 🔗 관련 프로젝트
- [Proxmox RDP Auto Setup](https://git.0bin.in/thug0bin/proxmox-rdp-autosetup)
---
**마지막 업데이트**: 2025년 9월
> 💡 **팁**: 이 스크립트는 Proxmox 클러스터 환경에서도 사용 가능하지만, 클러스터 설정은 별도로 업데이트해야 합니다.