headscale-tailscale-replace.../WINDOWS_QUICK_START.md
시골약사 09cdb088af Add Windows installation section to README and create quick start guide
- 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>
2025-09-11 00:55:31 +09:00

5.0 KiB

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

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

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

📋 기본 설치 (가장 많이 사용)

복사할 명령어:

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이 있는 경우)

복사할 명령어:

$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 키 + XWindows 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.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: 다음 명령을 먼저 실행하세요:

Set-ExecutionPolicy Bypass -Scope Process -Force

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

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

  • Windows 키 + XWindows PowerShell(관리자)

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

A: 강제 재설치 명령어를 사용하세요:

$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에서 다음 명령으로 확인:

tailscale status
tailscale ip

🔧 유용한 명령어

설치 완료 후 PowerShell에서 사용할 수 있는 명령어들:

# 연결 상태 확인
tailscale status

# 내 IP 주소 확인  
tailscale ip

# 다른 컴퓨터와 연결 테스트
tailscale ping 100.64.0.1

# 네트워크에서 나가기
tailscale logout

🏥 팜큐 관리 페이지 접속

설치 완료 후 브라우저에서 접속:

🆘 문제 해결

연결이 안될 때

  1. Windows 방화벽 확인
  2. 백신 프로그램 예외 설정
  3. 회사 네트워크 정책 확인

완전 삭제 후 재설치

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

📞 지원

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

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

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