📝 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:
parent
36a4dca165
commit
46b1580e52
69
README.md
69
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
|
||||
|
||||
## 📁 파일 구조
|
||||
```
|
||||
|
||||
Loading…
Reference in New Issue
Block a user