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>
This commit is contained in:
parent
ea11f92070
commit
09cdb088af
29
README.md
29
README.md
@ -159,3 +159,32 @@ curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/bran
|
|||||||
- 방화벽 자동 설정 + 연결 검증
|
- 방화벽 자동 설정 + 연결 검증
|
||||||
|
|
||||||
**30초 만에 팜큐 네트워크 연결 완료!** 🎉
|
**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 방화벽** 자동 설정
|
||||||
|
- ✅ **네트워크 연결 테스트** 및 확인
|
||||||
165
WINDOWS_QUICK_START.md
Normal file
165
WINDOWS_QUICK_START.md
Normal file
@ -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초 후 팜큐 네트워크 연결!** 🚀
|
||||||
Loading…
Reference in New Issue
Block a user