From 522d39d3dfe9bddf170183a943196d2a190b607a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=8B=9C=EA=B3=A8=EC=95=BD=EC=82=AC?= Date: Thu, 11 Sep 2025 00:33:04 +0900 Subject: [PATCH] Add comprehensive quick installation guide and update server URLs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Complete installation guide with examples and troubleshooting - Update Headscale server URL to https://head.0bin.in - Add support information and network configuration details - Include colored terminal output examples πŸš€ Generated with Claude Code Co-Authored-By: Claude --- QUICK_INSTALL_GUIDE.md | 224 +++++++++++++++++++++++++++++++++++++++++ quick-install.sh | 2 +- 2 files changed, 225 insertions(+), 1 deletion(-) create mode 100644 QUICK_INSTALL_GUIDE.md diff --git a/QUICK_INSTALL_GUIDE.md b/QUICK_INSTALL_GUIDE.md new file mode 100644 index 0000000..a02bc27 --- /dev/null +++ b/QUICK_INSTALL_GUIDE.md @@ -0,0 +1,224 @@ +# πŸš€ 팜큐 Headscale 원클릭 μ„€μΉ˜ κ°€μ΄λ“œ + +μƒˆλ‘œμš΄ λ¦¬λˆ…μŠ€ μ„œλ²„λ₯Ό 팜큐 λ„€νŠΈμ›Œν¬μ— **ν•œ 번의 λͺ…λ Ή**으둜 λ“±λ‘ν•˜λŠ” λ°©λ²•μž…λ‹ˆλ‹€. + +## 🎯 원클릭 μ„€μΉ˜ λͺ…λ Ήμ–΄ + +### 방법 1: curl μ‚¬μš© (ꢌμž₯) +```bash +curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/quick-install.sh | sudo bash +``` + +### 방법 2: wget μ‚¬μš© +```bash +wget -qO- https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/quick-install.sh | sudo bash +``` + +### 방법 3: 슀크립트 λ‹€μš΄λ‘œλ“œ ν›„ μ‹€ν–‰ +```bash +wget https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/feature/working-headscale-setup/quick-install.sh +chmod +x quick-install.sh +sudo ./quick-install.sh +``` + +## ✨ μžλ™μœΌλ‘œ μˆ˜ν–‰λ˜λŠ” μž‘μ—… + +### 1. πŸ” μ‹œμŠ€ν…œ 뢄석 +- 운영체제 μžλ™ 감지 (Ubuntu, Debian, CentOS, RHEL, Rocky, Fedora, Arch) +- μ‹œμŠ€ν…œ μš”κ΅¬μ‚¬ν•­ 확인 +- λ„€νŠΈμ›Œν¬ μ—°κ²° μƒνƒœ 점검 + +### 2. πŸ“¦ Tailscale μ„€μΉ˜ +- **Ubuntu/Debian**: APT 리포지토리 μΆ”κ°€ 및 μ„€μΉ˜ +- **CentOS/RHEL/Rocky**: YUM/DNF 리포지토리 μΆ”κ°€ 및 μ„€μΉ˜ +- **Fedora**: DNF νŒ¨ν‚€μ§€ κ΄€λ¦¬μžλ‘œ μ„€μΉ˜ +- **Arch Linux**: Pacman으둜 μ„€μΉ˜ +- **기타 배포판**: Universal Binary 직접 λ‹€μš΄λ‘œλ“œ + +### 3. πŸ”§ μ„œλΉ„μŠ€ μ„€μ • +- systemd μ„œλΉ„μŠ€ μžλ™ 등둝 +- tailscaled 데λͺ¬ μ‹œμž‘ 및 ν™œμ„±ν™” +- μ„œλΉ„μŠ€ μƒνƒœ 확인 및 였λ₯˜ 처리 + +### 4. 🌐 Headscale 등둝 +- Pre-auth Keyλ₯Ό μ‚¬μš©ν•œ μžλ™ 등둝 +- 팜큐 Headscale μ„œλ²„ (`https://head.0bin.in`)에 μ—°κ²° +- DNS 및 λΌμš°νŒ… μ„€μ • μžλ™ 적용 + +### 5. πŸ”’ λ°©ν™”λ²½ μ„€μ • +- UFW (Ubuntu/Debian) μžλ™ μ„€μ • +- firewalld (CentOS/RHEL/Fedora) μžλ™ μ„€μ • +- Tailscale 포트 (41641/UDP) μžλ™ ν—ˆμš© + +### 6. βœ… μ—°κ²° 검증 +- IP μ£Όμ†Œ ν• λ‹Ή 확인 +- λ„€νŠΈμ›Œν¬ μ—°κ²° ν…ŒμŠ€νŠΈ +- λ‹€λ₯Έ λ…Έλ“œμ™€μ˜ 톡신 확인 + +## πŸ–₯️ μ§€μ›ν•˜λŠ” 운영체제 + +| OS | 버전 | μ„€μΉ˜ 방법 | μƒνƒœ | +|---|---|---|---| +| **Ubuntu** | 18.04+ | APT Repository | βœ… | +| **Debian** | 10+ | APT Repository | βœ… | +| **CentOS** | 7, 8, 9 | YUM/DNF Repository | βœ… | +| **RHEL** | 7, 8, 9 | YUM/DNF Repository | βœ… | +| **Rocky Linux** | 8, 9 | DNF Repository | βœ… | +| **AlmaLinux** | 8, 9 | DNF Repository | βœ… | +| **Fedora** | 35+ | DNF Package | βœ… | +| **Arch Linux** | Rolling | Pacman Package | βœ… | +| **기타 배포판** | - | Universal Binary | ⚠️ | + +## πŸ“‹ μ„€μΉ˜ μ˜ˆμ‹œ 좜λ ₯ + +```bash +$ curl -fsSL https://git.0bin.in/.../quick-install.sh | sudo bash + +============================================ +팜큐(FARMQ) Headscale 원클릭 μ„€μΉ˜ +============================================ + +πŸ“‹ κ°μ§€λœ OS: ubuntu 22.04 (jammy) + +πŸ”§ μ‹œμŠ€ν…œ μš”κ΅¬μ‚¬ν•­ 확인 쀑... +βœ… μ‹œμŠ€ν…œ μš”κ΅¬μ‚¬ν•­ 확인 μ™„λ£Œ + +πŸ”§ Tailscale ν΄λΌμ΄μ–ΈνŠΈ μ„€μΉ˜ 쀑... +πŸ“‹ Ubuntu/Debian용 Tailscale μ„€μΉ˜ 쀑... +βœ… Tailscale μ„€μΉ˜ μ™„λ£Œ +πŸ“‹ μ„€μΉ˜λœ 버전: 1.52.1 + +πŸ”§ Tailscale μ„œλΉ„μŠ€ μ‹œμž‘ 쀑... +βœ… Tailscaled μ„œλΉ„μŠ€κ°€ μ‹€ν–‰ μ€‘μž…λ‹ˆλ‹€. + +πŸ”§ Headscale μ„œλ²„μ— 등둝 쀑... +πŸ“‹ Headscale μ„œλ²„: https://head.0bin.in +πŸ“‹ Pre-auth Key: 8b3df41d*************** +πŸ”§ 등둝 λͺ…λ Ή μ‹€ν–‰ 쀑... +βœ… Headscale 등둝 성곡! + +πŸ”§ λ°©ν™”λ²½ μ„€μ • 확인 쀑... +πŸ“‹ UFW λ°©ν™”λ²½ 감지됨 +πŸ“‹ Tailscale νŠΈλž˜ν”½ ν—ˆμš© 쀑... +βœ… λ°©ν™”λ²½ μ„€μ • μ™„λ£Œ + +πŸ”§ μ—°κ²° μƒνƒœ 확인 쀑... +βœ… Headscale λ„€νŠΈμ›Œν¬ μ—°κ²° μ™„λ£Œ! +πŸ“‹ ν• λ‹Ήλœ IPv4: 100.64.0.5 +πŸ“‹ ν• λ‹Ήλœ IPv6: fd7a:115c:a1e0::5 + +πŸ”§ λ„€νŠΈμ›Œν¬ μ—°κ²° ν…ŒμŠ€νŠΈ 쀑... +βœ… 팜큐 λ„€νŠΈμ›Œν¬(100.64.0.0/10) μ—°κ²° 정상! + +============================================ +팜큐 Headscale μ„€μΉ˜ μ™„λ£Œ! +============================================ + +πŸŽ‰ μ„€μΉ˜κ°€ μ„±κ³΅μ μœΌλ‘œ μ™„λ£Œλ˜μ—ˆμŠ΅λ‹ˆλ‹€! + +πŸ“‹ μ‹œμŠ€ν…œ 정보: + 호슀트λͺ…: pharmacy-server-01 + Tailscale IP: 100.64.0.5 + OS: ubuntu 22.04 + Headscale μ„œλ²„: https://head.0bin.in + +πŸ”§ μœ μš©ν•œ λͺ…λ Ήμ–΄: + tailscale status # μ—°κ²° μƒνƒœ 확인 + tailscale ip # ν• λ‹Ήλœ IP 확인 + tailscale ping # λ‹€λ₯Έ λ…Έλ“œμ™€ μ—°κ²° ν…ŒμŠ€νŠΈ + tailscale logout # λ„€νŠΈμ›Œν¬μ—μ„œ ν•΄μ œ + +🌐 팜큐 κ΄€λ¦¬μž νŽ˜μ΄μ§€: + http://192.168.0.151:5002 + http://192.168.0.151:5002/vms (VM 관리) + +============================================ +μ„€μΉ˜ μ™„λ£Œ - 팜큐 λ„€νŠΈμ›Œν¬λ₯Ό μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€! +============================================ +``` + +## πŸ”§ μ„€μΉ˜ ν›„ 확인 λͺ…λ Ήμ–΄ + +### μ—°κ²° μƒνƒœ 확인 +```bash +tailscale status +``` + +### ν• λ‹Ήλœ IP μ£Όμ†Œ 확인 +```bash +tailscale ip +``` + +### λ„€νŠΈμ›Œν¬ ν…ŒμŠ€νŠΈ +```bash +# λ‹€λ₯Έ λ…Έλ“œλ‘œ ping ν…ŒμŠ€νŠΈ +tailscale ping 100.64.0.1 + +# λ˜λŠ” λ…Έλ“œλͺ…μœΌλ‘œ ν…ŒμŠ€νŠΈ +tailscale ping desktop-emjd1dc +``` + +### μ„œλΉ„μŠ€ μƒνƒœ 확인 +```bash +systemctl status tailscaled +journalctl -u tailscaled -f # μ‹€μ‹œκ°„ 둜그 +``` + +## 🚨 λ¬Έμ œν•΄κ²° + +### 1. μ„€μΉ˜ 쀑 κΆŒν•œ 였λ₯˜ +```bash +# 해결방법: sudo κΆŒν•œμœΌλ‘œ μ‹€ν–‰ +sudo curl -fsSL https://git.0bin.in/.../quick-install.sh | sudo bash +``` + +### 2. λ„€νŠΈμ›Œν¬ μ—°κ²° μ‹€νŒ¨ +```bash +# λ°©ν™”λ²½ μƒνƒœ 확인 +sudo ufw status +sudo firewall-cmd --list-all + +# μˆ˜λ™ 포트 ν—ˆμš© +sudo ufw allow 41641/udp +sudo firewall-cmd --add-port=41641/udp --permanent +``` + +### 3. Pre-auth Key 만료 +```bash +# μƒˆλ‘œμš΄ ν‚€ 생성이 ν•„μš”ν•œ 경우 +# Headscale μ„œλ²„μ—μ„œ μ‹€ν–‰: +docker exec headscale headscale preauthkeys create --user 1 --expiration 7d --reusable +``` + +### 4. μˆ˜λ™ 등둝 ν•„μš”μ‹œ +```bash +# μžλ™ 등둝 μ‹€νŒ¨ μ‹œ μˆ˜λ™ μ‹€ν–‰ +tailscale up --login-server="https://head.0bin.in" --authkey="YOUR_KEY_HERE" +``` + +## πŸ“Š ν˜„μž¬ λ„€νŠΈμ›Œν¬ 정보 + +- **Headscale μ„œλ²„**: https://head.0bin.in +- **Flask 관리 νŽ˜μ΄μ§€**: http://192.168.0.151:5002 +- **λ„€νŠΈμ›Œν¬ λŒ€μ—­**: 100.64.0.0/10 +- **Pre-auth Key μœ νš¨κΈ°κ°„**: 7일 (μž¬μ‚¬μš© κ°€λŠ₯) + +## πŸ”„ κΈ°μ‘΄ μ„œλ²„ μ—…λ°μ΄νŠΈ + +이미 λ“±λ‘λœ μ„œλ²„μ—μ„œ 슀크립트λ₯Ό λ‹€μ‹œ μ‹€ν–‰ν•˜λ©΄: +1. κΈ°μ‘΄ μ—°κ²° 감지 +2. μ‚¬μš©μž 확인 ν›„ μž¬λ“±λ‘ μ˜΅μ…˜ 제곡 +3. λ˜λŠ” κΈ°μ‘΄ μ—°κ²° μœ μ§€ + +## πŸ“ž 지원 + +λ¬Έμ œκ°€ λ°œμƒν•˜λ©΄ λ‹€μŒ 정보와 ν•¨κ»˜ μ—°λ½μ£Όμ„Έμš”: + +1. **OS 정보**: `cat /etc/os-release` +2. **Tailscale 버전**: `tailscale version` +3. **였λ₯˜ 둜그**: `journalctl -u tailscaled --no-pager` +4. **λ„€νŠΈμ›Œν¬ μƒνƒœ**: `tailscale status` + +--- + +**🎯 λͺ©ν‘œ**: μƒˆλ‘œμš΄ μ„œλ²„λ₯Ό 30초 λ§Œμ— 팜큐 λ„€νŠΈμ›Œν¬μ— μ—°κ²°! \ No newline at end of file diff --git a/quick-install.sh b/quick-install.sh index 14e8d97..72f8a8c 100755 --- a/quick-install.sh +++ b/quick-install.sh @@ -9,7 +9,7 @@ set -e # ================================ # μ„€μ • (ν•„μš”μ‹œ μˆ˜μ •) # ================================ -HEADSCALE_SERVER="http://192.168.0.151:8070" # Headscale μ„œλ²„ μ£Όμ†Œ +HEADSCALE_SERVER="https://head.0bin.in" # Headscale μ„œλ²„ μ£Όμ†Œ PREAUTH_KEY="8b3df41d37cb158ea39f41fc32c9af46e761de817ad06038" # 7일간 μž¬μ‚¬μš© κ°€λŠ₯ν•œ ν‚€ FARMQ_NETWORK="100.64.0.0/10" # 팜큐 λ„€νŠΈμ›Œν¬ λŒ€μ—­