headscale-tailscale-replacement/README.md

# 🚀 Headscale + Headplane Docker Setup

Tailscale을 완전히 대체하는 자체 호스팅 솔루션

## 📁 파일 구조
```
/srv/
├── docker-compose.yml    # Docker Compose 설정
├── .env                  # 환경변수
├── start.sh             # 자동 설치 스크립트
├── config/
│   └── config.yaml      # Headscale 설정
├── data/                # 데이터베이스 및 키 파일
└── run/                 # 런타임 파일
```

## 🚀 빠른 시작

### 1. 자동 설치 (권장)
```bash
chmod +x /srv/start.sh
/srv/start.sh
```

### 2. 수동 설치
```bash
# 1. Headscale 시작
docker-compose up -d headscale

# 2. API 키 생성
docker-compose exec headscale headscale apikeys create

# 3. .env 파일에 API 키 입력
vi .env

# 4. Headplane 시작
docker-compose up -d headplane
```

## 📋 접속 정보
- **Headscale API**: http://localhost:8080
- **Headplane UI**: http://localhost:3000

## 👤 사용자 관리

### 사용자 생성
```bash
docker-compose exec headscale headscale users create myuser
```

### Pre-auth 키 생성
```bash
docker-compose exec headscale headscale preauthkeys create --user myuser --reusable --expiration 24h
```

## 📱 클라이언트 연결

### Linux/macOS
```bash
# Tailscale 클라이언트 설치 후
tailscale up --login-server=http://localhost:8080
```

### Windows
```cmd
tailscale up --login-server=http://localhost:8080
```

## 🔧 유용한 명령어

### 상태 확인
```bash
docker-compose ps
docker-compose logs -f
```

### 노드 목록 확인
```bash
docker-compose exec headscale headscale nodes list
```

### 사용자 목록 확인
```bash
docker-compose exec headscale headscale users list
```

## 🛠️ 트러블슈팅

### 컨테이너 재시작
```bash
docker-compose restart
```

### 로그 확인
```bash
docker-compose logs headscale
docker-compose logs headplane
```

### 완전 초기화
```bash
docker-compose down
sudo rm -rf data/*
docker-compose up -d
```