diff --git a/README.md b/README.md index b9cfb98..df7e0ab 100644 --- a/README.md +++ b/README.md @@ -158,4 +158,33 @@ curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/bran - 자동 Tailscale 설치 + Headscale 등록 - 방화벽 자동 설정 + 연결 검증 -**30초 만에 팜큐 네트워크 연결 완료!** 🎉 \ No newline at end of file +**30초 만에 팜큐 네트워크 연결 완료!** 🎉 + +## 🪟 Windows 원클릭 등록 + +Windows PC에서 **한 번의 복사 붙여넣기**로 팜큐 네트워크 연결: + +### 기본 설치 (권장) +```powershell +# 관리자 PowerShell에서 복사 붙여넣기 +iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) +``` + +### 기존 Tailscale 있는 경우 (강제 재등록) +```powershell +# 기존 연결을 자동으로 해제하고 재등록 +$ForceInstall = $true; iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) +``` + +### 실행 방법 +1. **Windows 키 + X** → **"Windows PowerShell(관리자)"** 클릭 +2. 위 명령어 **복사 → 붙여넣기 → Enter** +3. 자동 설치 진행 (2-3분) +4. 팜큐 네트워크 연결 완료! 🎉 + +### Windows 자동 처리 기능 +- ✅ **Tailscale 자동 다운로드** 및 설치 +- ✅ **관리자 권한** 자동 확인 +- ✅ **기존 연결 스마트 처리** (Linux와 동일) +- ✅ **Windows Defender 방화벽** 자동 설정 +- ✅ **네트워크 연결 테스트** 및 확인 \ No newline at end of file diff --git a/WINDOWS_QUICK_START.md b/WINDOWS_QUICK_START.md new file mode 100644 index 0000000..04c29b5 --- /dev/null +++ b/WINDOWS_QUICK_START.md @@ -0,0 +1,165 @@ +# 🪟 Windows 팜큐 네트워크 빠른 시작 가이드 + +Windows PC를 팜큐 네트워크에 **30초만에** 연결하는 방법입니다. + +## 🎯 복사 붙여넣기 전용 명령어 + +### 📋 기본 설치 (가장 많이 사용) + +**복사할 명령어:** +```powershell +iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) +``` + +### 📋 강제 재설치 (기존 Tailscale이 있는 경우) + +**복사할 명령어:** +```powershell +$ForceInstall = $true; iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) +``` + +## 🚀 실행 방법 (3단계) + +### 1단계: 관리자 PowerShell 열기 +- **Windows 10/11**: `Windows 키 + X` → `Windows PowerShell(관리자)` 클릭 +- **또는**: 시작 메뉴 → `PowerShell` 검색 → 우클릭 → `관리자로 실행` + +### 2단계: 명령어 붙여넣기 +- 위의 **기본 설치 명령어**를 복사 +- PowerShell에 붙여넣기 (우클릭 또는 `Ctrl+V`) +- `Enter` 키 누르기 + +### 3단계: 자동 설치 완료 대기 +- 2-3분 기다리기 ⏰ +- 완료 메시지 확인 ✅ +- 팜큐 네트워크 사용 시작! 🎉 + +## 📺 실행 화면 예시 + +```powershell +PS C:\WINDOWS\system32> iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) + +============================================ +팜큐(FARMQ) Headscale Windows 원클릭 설치 +============================================ + +🔧 시스템 요구사항 확인 중... +✅ 시스템 요구사항 확인 완료 + +🔧 Tailscale 클라이언트 확인 중... +📋 Windows용 Tailscale 설치 중... +🔧 Tailscale 다운로드 중... +🔧 Tailscale 설치 중... (잠시 기다려주세요) +✅ Tailscale 설치 완료 + +🔧 Tailscale 서비스 시작 중... +✅ Tailscale 서비스가 실행 중입니다. + +🔧 Headscale 서버에 등록 중... +📋 Headscale 서버: https://head.0bin.in +📋 Pre-auth Key: 8b3df41d*************** +🔧 등록 명령 실행 중... +✅ Headscale 등록 성공! + +🔧 방화벽 설정 확인 중... +✅ 방화벽 설정 완료 + +🔧 연결 상태 확인 중... +✅ Headscale 네트워크 연결 완료! +📋 할당된 IPv4: 100.64.0.15 +📋 할당된 IPv6: fd7a:115c:a1e0::15 + +🔧 네트워크 연결 테스트 중... +✅ 팜큐 네트워크(100.64.0.0/10) 연결 정상! + +============================================ +팜큐 Headscale Windows 설치 완료! +============================================ + +🎉 설치가 성공적으로 완료되었습니다! + +📋 시스템 정보: + 컴퓨터명: PHARMACY-PC01 + Tailscale IP: 100.64.0.15 + OS: Windows 10.0 + Headscale 서버: https://head.0bin.in +``` + +## ❓ 자주 묻는 질문 (FAQ) + +### Q: "실행 정책" 오류가 나와요 +**A: 다음 명령을 먼저 실행하세요:** +```powershell +Set-ExecutionPolicy Bypass -Scope Process -Force +``` + +### Q: 관리자 권한이 없다고 나와요 +**A: PowerShell을 관리자로 다시 실행하세요:** +- `Windows 키 + X` → `Windows PowerShell(관리자)` + +### Q: 이미 Tailscale이 설치되어 있어요 +**A: 강제 재설치 명령어를 사용하세요:** +```powershell +$ForceInstall = $true; iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1')) +``` + +### Q: 설치 후 어떻게 확인하나요? +**A: PowerShell에서 다음 명령으로 확인:** +```powershell +tailscale status +tailscale ip +``` + +## 🔧 유용한 명령어 + +설치 완료 후 PowerShell에서 사용할 수 있는 명령어들: + +```powershell +# 연결 상태 확인 +tailscale status + +# 내 IP 주소 확인 +tailscale ip + +# 다른 컴퓨터와 연결 테스트 +tailscale ping 100.64.0.1 + +# 네트워크에서 나가기 +tailscale logout +``` + +## 🏥 팜큐 관리 페이지 접속 + +설치 완료 후 브라우저에서 접속: + +- **메인 관리 페이지**: http://192.168.0.151:5002 +- **VM 관리**: http://192.168.0.151:5002/vms +- **약국 관리**: http://192.168.0.151:5002/pharmacy + +## 🆘 문제 해결 + +### 연결이 안될 때 +1. **Windows 방화벽** 확인 +2. **백신 프로그램** 예외 설정 +3. **회사 네트워크 정책** 확인 + +### 완전 삭제 후 재설치 +```powershell +# Tailscale 완전 제거 +tailscale logout +# 제어판에서 Tailscale 제거 +# 다시 설치 스크립트 실행 +``` + +--- + +## 📞 지원 + +문제가 발생하면 다음 정보와 함께 연락주세요: + +1. **Windows 버전**: `winver` 명령으로 확인 +2. **PowerShell 버전**: `$PSVersionTable` 명령으로 확인 +3. **오류 메시지**: 스크린샷 또는 텍스트 복사 +4. **컴퓨터 이름**: `$env:COMPUTERNAME` 명령으로 확인 + +**🎯 목표 달성: 복사 → 붙여넣기 → 30초 후 팜큐 네트워크 연결!** 🚀 \ No newline at end of file