📝 Add comprehensive README for live production

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

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

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
PharmQ Admin 2025-09-22 11:22:57 +00:00
parent 36a4dca165
commit 46b1580e52

View File

@ -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
## 📁 파일 구조
```