headscale-tailscale-replacement/WINDOWS_QUICK_START.md

🪟 Windows 팜큐 네트워크 빠른 시작 가이드

Windows PC를 팜큐 네트워크에 30초만에 연결하는 방법입니다.

🎯 복사 붙여넣기 전용 명령어

📋 기본 설치 (가장 많이 사용) - 인코딩 문제 해결됨 ✅

복사할 명령어 (권장 - English 버전):

iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install-en.ps1'))

📋 강제 재설치 (기존 Tailscale이 있는 경우)

복사할 명령어 (권장 - English 버전):

$Force = $true; iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install-en.ps1'))

📋 한글 버전 (인코딩 문제 발생 가능)

한글이 깨져서 나올 수 있습니다 - 위 English 버전을 사용하세요:

# 기본 설치 (한글 깨짐 가능)
iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install.ps1'))

# 강제 재설치 (한글 깨짐 가능)  
$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분 기다리기 ⏰
• 완료 메시지 확인 ✅
• 팜큐 네트워크 사용 시작! 🎉

📺 실행 화면 예시

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-en.ps1'))

============================================
FARMQ Headscale Windows One-Click Installation
============================================

[*] Checking system requirements...
[+] System requirements check completed

[*] Checking Tailscale installation...
[i] Installing Tailscale for Windows...
[*] Downloading Tailscale...
[*] Installing Tailscale... (please wait)
[+] Tailscale installation completed

[*] Starting Tailscale service...
[+] Tailscale service is running.

[*] Registering with Headscale server...
[i] Headscale Server: https://head.0bin.in
[i] Pre-auth Key: 8b3df41d***************
[*] Executing registration command...
[+] Headscale registration successful!

[*] Configuring firewall settings...
[+] Firewall configuration completed

[*] Verifying network connection...
[+] Headscale network connection completed!
[i] Assigned IPv4: 100.64.0.15
[i] Assigned IPv6: fd7a:115c:a1e0::15

[*] Testing network connectivity...
[+] FARMQ network (100.64.0.0/10) connection successful!

============================================
FARMQ Headscale Windows Installation Complete!
============================================

Installation completed successfully!

System Information:
   Computer Name: PHARMACY-PC01
   Tailscale IP: 100.64.0.15
   OS: Windows 10.0
   Headscale Server: https://head.0bin.in

❓ 자주 묻는 질문 (FAQ)

Q: "실행 정책" 오류가 나와요

A: 다음 명령을 먼저 실행하세요:

Set-ExecutionPolicy Bypass -Scope Process -Force

Q: 관리자 권한이 없다고 나와요

A: PowerShell을 관리자로 다시 실행하세요:

• Windows 키 + X → Windows PowerShell(관리자)

Q: 이미 Tailscale이 설치되어 있어요

A: 강제 재설치 명령어를 사용하세요 (English 버전):

$Force = $true; iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install-en.ps1'))

Q: 한글이 깨져서 나와요

A: English 버전을 사용하세요 (인코딩 문제 해결됨):

# 기본 설치 (English 버전)
iex ((New-Object System.Net.WebClient).DownloadString('https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/farmq-install-en.ps1'))

Q: 설치 후 어떻게 확인하나요?

A: PowerShell에서 다음 명령으로 확인:

tailscale status
tailscale ip

🔧 유용한 명령어

설치 완료 후 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. 회사 네트워크 정책 확인

완전 삭제 후 재설치

# Tailscale 완전 제거
tailscale logout
# 제어판에서 Tailscale 제거
# 다시 설치 스크립트 실행

---

📞 지원

문제가 발생하면 다음 정보와 함께 연락주세요:

1. Windows 버전: winver 명령으로 확인
2. PowerShell 버전: $PSVersionTable 명령으로 확인
3. 오류 메시지: 스크린샷 또는 텍스트 복사
4. 컴퓨터 이름: $env:COMPUTERNAME 명령으로 확인

🎯 목표 달성: 복사 → 붙여넣기 → 30초 후 팜큐 네트워크 연결! 🚀