시골약사
e0c4a9de3d
✨ 추가된 파일들: - 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>
2.0 KiB
2.0 KiB
🚀 Headscale + Headplane Docker Setup
Tailscale을 완전히 대체하는 자체 호스팅 솔루션
📁 파일 구조
/srv/
├── docker-compose.yml # Docker Compose 설정
├── .env # 환경변수
├── start.sh # 자동 설치 스크립트
├── config/
│ └── config.yaml # Headscale 설정
├── data/ # 데이터베이스 및 키 파일
└── run/ # 런타임 파일
🚀 빠른 시작
1. 자동 설치 (권장)
chmod +x /srv/start.sh
/srv/start.sh
2. 수동 설치
# 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
👤 사용자 관리
사용자 생성
docker-compose exec headscale headscale users create myuser
Pre-auth 키 생성
docker-compose exec headscale headscale preauthkeys create --user myuser --reusable --expiration 24h
📱 클라이언트 연결
Linux/macOS
# Tailscale 클라이언트 설치 후
tailscale up --login-server=http://localhost:8080
Windows
tailscale up --login-server=http://localhost:8080
🔧 유용한 명령어
상태 확인
docker-compose ps
docker-compose logs -f
노드 목록 확인
docker-compose exec headscale headscale nodes list
사용자 목록 확인
docker-compose exec headscale headscale users list
🛠️ 트러블슈팅
컨테이너 재시작
docker-compose restart
로그 확인
docker-compose logs headscale
docker-compose logs headplane
완전 초기화
docker-compose down
sudo rm -rf data/*
docker-compose up -d