From 176c6bb1c2f60e8d18db8a5242a4b977cf9a3d3a 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 01:01:36 +0900
Subject: [PATCH] Update documentation for PowerShell encoding fix
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Update README.md with English PowerShell commands
- Update WINDOWS_QUICK_START.md with encoding issue solution
- Add FAQ section for Korean character encoding problems
- Recommend farmq-install-en.ps1 to prevent character display issues

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md              | 16 +++++---
 WINDOWS_QUICK_START.md | 88 +++++++++++++++++++++++++-----------------
 2 files changed, 64 insertions(+), 40 deletions(-)

diff --git a/README.md b/README.md
index df7e0ab..b732c93 100644
--- a/README.md
+++ b/README.md
@@ -164,16 +164,22 @@ curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/bran
 
 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'))
+# 관리자 PowerShell에서 복사 붙여넣기 (English version - 한글 깨짐 해결)
+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 있는 경우 (강제 재등록)  
 ```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'))
+# 기존 연결을 자동으로 해제하고 재등록 (English version)
+$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'))
+```
+
+### 한글 버전 (인코딩 문제 발생 가능)
+```powershell
+# 한글이 깨져 보일 수 있음 - 위 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'))
 ```
 
 ### 실행 방법
diff --git a/WINDOWS_QUICK_START.md b/WINDOWS_QUICK_START.md
index 04c29b5..3a7d45b 100644
--- a/WINDOWS_QUICK_START.md
+++ b/WINDOWS_QUICK_START.md
@@ -4,17 +4,28 @@ Windows PC를 팜큐 네트워크에 **30초만에** 연결하는 방법입니
 
 ## 🎯 복사 붙여넣기 전용 명령어
 
-### 📋 기본 설치 (가장 많이 사용)
+### 📋 기본 설치 (가장 많이 사용) - 인코딩 문제 해결됨 ✅
 
-**복사할 명령어:**
+**복사할 명령어 (권장 - English 버전):**
 ```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'))
+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 버전):**
 ```powershell
+$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 버전을 사용하세요:**
+```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'))
+
+# 강제 재설치 (한글 깨짐 가능)  
 $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'))
 ```
 
@@ -37,52 +48,52 @@ $ForceInstall = $true; iex ((New-Object System.Net.WebClient).DownloadString('ht
 ## 📺 실행 화면 예시
 
 ```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'))
+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 원클릭 설치
+FARMQ Headscale Windows One-Click Installation
 ============================================
 
-🔧 시스템 요구사항 확인 중...
-✅ 시스템 요구사항 확인 완료
+[*] Checking system requirements...
+[+] System requirements check completed
 
-🔧 Tailscale 클라이언트 확인 중...
-📋 Windows용 Tailscale 설치 중...
-🔧 Tailscale 다운로드 중...
-🔧 Tailscale 설치 중... (잠시 기다려주세요)
-✅ Tailscale 설치 완료
+[*] Checking Tailscale installation...
+[i] Installing Tailscale for Windows...
+[*] Downloading Tailscale...
+[*] Installing Tailscale... (please wait)
+[+] Tailscale installation completed
 
-🔧 Tailscale 서비스 시작 중...
-✅ Tailscale 서비스가 실행 중입니다.
+[*] Starting Tailscale service...
+[+] Tailscale service is running.
 
-🔧 Headscale 서버에 등록 중...
-📋 Headscale 서버: https://head.0bin.in
-📋 Pre-auth Key: 8b3df41d***************
-🔧 등록 명령 실행 중...
-✅ Headscale 등록 성공!
+[*] 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
 
-🔧 연결 상태 확인 중...
-✅ Headscale 네트워크 연결 완료!
-📋 할당된 IPv4: 100.64.0.15
-📋 할당된 IPv6: fd7a:115c:a1e0::15
+[*] Verifying network connection...
+[+] Headscale network connection completed!
+[i] Assigned IPv4: 100.64.0.15
+[i] Assigned IPv6: fd7a:115c:a1e0::15
 
-🔧 네트워크 연결 테스트 중...
-✅ 팜큐 네트워크(100.64.0.0/10) 연결 정상!
+[*] Testing network connectivity...
+[+] FARMQ network (100.64.0.0/10) connection successful!
 
 ============================================
-팜큐 Headscale Windows 설치 완료!
+FARMQ Headscale Windows Installation Complete!
 ============================================
 
-🎉 설치가 성공적으로 완료되었습니다!
+Installation completed successfully!
 
-📋 시스템 정보:
-   컴퓨터명: PHARMACY-PC01
+System Information:
+   Computer Name: PHARMACY-PC01
    Tailscale IP: 100.64.0.15
    OS: Windows 10.0
-   Headscale 서버: https://head.0bin.in
+   Headscale Server: https://head.0bin.in
 ```
 
 ## ❓ 자주 묻는 질문 (FAQ)
@@ -98,9 +109,16 @@ Set-ExecutionPolicy Bypass -Scope Process -Force
 - `Windows 키 + X` → `Windows PowerShell(관리자)`
 
 ### Q: 이미 Tailscale이 설치되어 있어요
-**A: 강제 재설치 명령어를 사용하세요:**
+**A: 강제 재설치 명령어를 사용하세요 (English 버전):**
 ```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'))
+$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 버전을 사용하세요 (인코딩 문제 해결됨):**
+```powershell
+# 기본 설치 (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: 설치 후 어떻게 확인하나요?