From 46b1580e52a03f4b87dc5948c89c41baa38d97a5 Mon Sep 17 00:00:00 2001
From: PharmQ Admin <admin@pharmq.kr>
Date: Mon, 22 Sep 2025 11:22:57 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Add=20comprehensive=20README=20f?=
 =?UTF-8?q?or=20live=20production?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

✅ 사용자 친화적인 설치 가이드 추가
- 한 줄 curl 설치 명령어
- 다운로드 후 설치 방법
- 스크립트 파일 직접 링크

🔗 Gitea 웹 인터페이스 최적화
- 클릭 가능한 파일 링크
- 명확한 서비스 주소 정리
- 네트워크 정보 및 관리 도구 설명

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

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 67 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b732c93..7220f50 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,71 @@
-# 🚀 Headscale + Headplane Docker Setup
+# 🏥 PharmQ Headscale Network - Live Production
 
-Tailscale을 완전히 대체하는 자체 호스팅 솔루션
+pharmq.kr 도메인을 사용하는 Headscale VPN 네트워크 구축 완료
+
+## 🚀 클라이언트 자동 등록
+
+### 한 줄 설치 (권장)
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/live/pharmq-headscale-production/register-client-pharmq-live.sh | bash
+```
+
+### 다운로드 후 설치
+```bash
+curl -fsSL https://git.0bin.in/thug0bin/headscale-tailscale-replacement/raw/branch/live/pharmq-headscale-production/register-client-pharmq-live.sh -o register-client.sh
+chmod +x register-client.sh
+./register-client.sh
+```
+
+### 📋 스크립트 파일 직접 다운로드
+- [register-client-pharmq-live.sh](./register-client-pharmq-live.sh) - 클라이언트 자동 등록 스크립트
+
+## 🌐 서비스 주소
+
+### 메인 서비스
+- **Headscale 서버**: http://head.pharmq.kr:8070
+- **관리자 대시보드**: http://head.pharmq.kr:5001
+
+### 개발/테스트 (내부용)
+- **Headscale**: http://192.168.0.100:8070
+- **farmq-admin**: http://192.168.0.100:5001
+
+## 📊 네트워크 정보
+
+- **네트워크 대역**: 100.64.0.0/10
+- **IPv6 대역**: fd7a:115c:a1e0::/48
+- **Magic DNS**: headscale.local
+- **기본 사용자**: default
+
+## 🔧 관리자 도구
+
+### farmq-admin 웹 GUI
+- 사용자 관리
+- 머신/노드 관리
+- 실시간 네트워크 모니터링
+- Headscale CLI API 래퍼
+
+### 주요 기능
+- ✅ Docker 기반 Headscale 서버
+- ✅ 웹 기반 관리 인터페이스
+- ✅ 자동 클라이언트 등록 스크립트
+- ✅ 1년 유효 재사용 가능 preauth key
+- ✅ Magic DNS 지원
+
+## 📋 클라이언트 등록 과정
+
+1. **스크립트 실행**: 위 curl 명령어 실행
+2. **Tailscale 자동 설치**: 시스템에 맞게 설치
+3. **Headscale 서버 연결**: head.pharmq.kr 연결
+4. **자동 인증**: preauth key로 즉시 승인
+5. **네트워크 참여**: Tailscale IP 할당 완료
+
+## 🛠️ 기술 스택
+
+- **Headscale**: v0.26.1 (Docker)
+- **farmq-admin**: Flask + SQLAlchemy
+- **Database**: SQLite3
+- **Frontend**: HTML/CSS/JavaScript
+- **Network**: Tailscale protocol
 
 ## 📁 파일 구조
 ```