📝 Add missing files: README.md, config.yaml, start.sh
✨ 추가된 파일들: - README.md: 프로젝트 문서 및 사용법 가이드 - config/config.yaml: Headscale 완전 설정 파일 - start.sh: 원클릭 자동 설치 스크립트 🔧 설정 세부사항: - SQLite 데이터베이스 기본 설정 - Magic DNS 활성화 - Korean 시간대 설정 - 보안 설정 포함 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
105
README.md
Normal file
105
README.md
Normal file
@@ -0,0 +1,105 @@
|
||||
# 🚀 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
|
||||
```
|
||||
Reference in New Issue
Block a user