From 09cdb088af034d14eb9bba7c37245e7521d8c1c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=8B=9C=EA=B3=A8=EC=95=BD=EC=82=AC?= <thug0bin@gmail.com>
Date: Thu, 11 Sep 2025 00:55:31 +0900
Subject: [PATCH] Add Windows installation section to README and create quick
 start guide
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add Windows PowerShell one-click installation to main README
- Create comprehensive Windows quick start guide (WINDOWS_QUICK_START.md)
- Provide copy-paste friendly commands for easy execution
- Include step-by-step instructions with screenshots example
- Add FAQ section for common PowerShell execution issues
- Include troubleshooting guide for Windows-specific problems
- Add useful post-installation commands reference

Features:
- Copy-paste optimized command formatting
- Clear 3-step installation process
- Administrator PowerShell access instructions
- Force reinstall option for existing Tailscale installations
- Windows Defender firewall handling
- Network connectivity verification

🚀 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md              |  31 +++++++-
 WINDOWS_QUICK_START.md | 165 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 195 insertions(+), 1 deletion(-)
 create mode 100644 WINDOWS_QUICK_START.md

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