thug0bin/headscale-tailscale-replacement
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation for PowerShell encoding fix

Browse Source 
- 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>
This commit is contained in:
시골약사 2025-09-11 01:01:36 +09:00
parent b7c621f294
commit 176c6bb1c2
2 changed files with 64 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@ -164,16 +164,22 @@ curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/bran
Windows PC에서 **한 번의 복사 붙여넣기**로 팜큐 네트워크 연결: Windows PC에서 **한 번의 복사 붙여넣기**로 팜큐 네트워크 연결:
### 기본 설치 (권장) ### 기본 설치 (권장) - 인코딩 문제 해결됨
```powershell ```powershell
# 관리자 PowerShell에서 복사 붙여넣기 # 관리자 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.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 있는 경우 (강제 재등록) ### 기존 Tailscale 있는 경우 (강제 재등록)
```powershell ```powershell
# 기존 연결을 자동으로 해제하고 재등록 # 기존 연결을 자동으로 해제하고 재등록 (English version)
$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'))
```
### 한글 버전 (인코딩 문제 발생 가능)
```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'))
``` ```
### 실행 방법 ### 실행 방법

88
WINDOWS_QUICK_START.md
View File

@ -4,17 +4,28 @@ Windows PC를 팜큐 네트워크에 **30초만에** 연결하는 방법입니
## 🎯 복사 붙여넣기 전용 명령어 ## 🎯 복사 붙여넣기 전용 명령어
### 📋 기본 설치 (가장 많이 사용) ### 📋 기본 설치 (가장 많이 사용) - 인코딩 문제 해결됨 ✅
**복사할 명령어:** **복사할 명령어 (권장 - English 버전):**
```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')) 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이 있는 경우) ### 📋 강제 재설치 (기존 Tailscale이 있는 경우)
**복사할 명령어:** **복사할 명령어 (권장 - English 버전):**
```powershell ```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')) $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 ```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 클라이언트 확인 중... [*] Checking Tailscale installation...
📋 Windows용 Tailscale 설치 중... [i] Installing Tailscale for Windows...
🔧 Tailscale 다운로드 중... [*] Downloading Tailscale...
🔧 Tailscale 설치 중... (잠시 기다려주세요) [*] Installing Tailscale... (please wait)
✅ Tailscale 설치 완료 [+] Tailscale installation completed
🔧 Tailscale 서비스 시작 중... [*] Starting Tailscale service...
✅ Tailscale 서비스가 실행 중입니다. [+] Tailscale service is running.
🔧 Headscale 서버에 등록 중... [*] Registering with Headscale server...
📋 Headscale 서버: https://head.0bin.in [i] Headscale Server: https://head.0bin.in
📋 Pre-auth Key: 8b3df41d*************** [i] Pre-auth Key: 8b3df41d***************
🔧 등록 명령 실행 중... [*] Executing registration command...
✅ Headscale 등록 성공! [+] Headscale registration successful!
🔧 방화벽 설정 확인 중... [*] Configuring firewall settings...
✅ 방화벽 설정 완료 [+] Firewall configuration completed
🔧 연결 상태 확인 중... [*] Verifying network connection...
✅ Headscale 네트워크 연결 완료! [+] Headscale network connection completed!
📋 할당된 IPv4: 100.64.0.15 [i] Assigned IPv4: 100.64.0.15
📋 할당된 IPv6: fd7a:115c:a1e0::15 [i] Assigned IPv6: fd7a:115c:a1e0::15
🔧 네트워크 연결 테스트 중... [*] Testing network connectivity...
✅ 팜큐 네트워크(100.64.0.0/10) 연결 정상! [+] FARMQ network (100.64.0.0/10) connection successful!
============================================ ============================================
팜큐 Headscale Windows 설치 완료! FARMQ Headscale Windows Installation Complete!
============================================ ============================================
🎉 설치가 성공적으로 완료되었습니다! Installation completed successfully!
📋 시스템 정보: System Information:
컴퓨터명: PHARMACY-PC01 Computer Name: PHARMACY-PC01
Tailscale IP: 100.64.0.15 Tailscale IP: 100.64.0.15
OS: Windows 10.0 OS: Windows 10.0
Headscale 서버: https://head.0bin.in Headscale Server: https://head.0bin.in
``` ```
## ❓ 자주 묻는 질문 (FAQ) ## ❓ 자주 묻는 질문 (FAQ)
@ -98,9 +109,16 @@ Set-ExecutionPolicy Bypass -Scope Process -Force
- `Windows 키 + X` → `Windows PowerShell(관리자)` - `Windows 키 + X` → `Windows PowerShell(관리자)`
### Q: 이미 Tailscale이 설치되어 있어요 ### Q: 이미 Tailscale이 설치되어 있어요
**A: 강제 재설치 명령어를 사용하세요:** **A: 강제 재설치 명령어를 사용하세요 (English 버전):**
```powershell ```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: 설치 후 어떻게 확인하나요? ### Q: 설치 후 어떻게 확인하나요?