headscale-tailscale-replacement/CLIENT_SETUP_GUIDE.md

팜큐(FARMQ) Headscale 클라이언트 설치 가이드

🏥 개요

팜큐 네트워크에 PC를 연결하기 위한 간편한 설치 가이드입니다.

📋 Pre-auth Key 정보

✅ Pre-auth Key 특징:

• 1회 등록: 한 번 사용하면 해당 머신이 영구적으로 네트워크에 등록됩니다
• 자동 재연결: 재부팅 후에도 자동으로 연결됩니다
• 재사용 가능: 동일한 key로 여러 머신을 등록할 수 있습니다 (설정에 따라)

🔑 현재 유효한 Key:

• myuser: fc4f2dc55ee00c5352823d156129b9ce2df4db02f1d76a21 (재사용 가능)
• pharmacy1: 5c15b41ea8b135dbed42455ad1a9a0cf0352b100defd241c (7일 유효, 재사용 가능)

🚀 자동 설치 (권장)

Linux/Ubuntu 시스템

1. 스크립트 다운로드:

   wget https://head.0bin.in/register-client.sh
   chmod +x register-client.sh
   

2. 스크립트 실행:

   sudo ./register-client.sh
   

수동으로 Pre-auth Key 업데이트

스크립트의 Pre-auth Key를 업데이트하려면:

# 스크립트 편집
nano register-client.sh

# PREAUTH_KEY 값을 새로운 key로 변경
PREAUTH_KEY="새로운키값"

🔧 수동 설치

1. Tailscale 설치

Ubuntu/Debian:

curl -fsSL https://tailscale.com/install.sh | sh

CentOS/RHEL:

curl -fsSL https://tailscale.com/install.sh | sh

macOS:

# Homebrew 사용
brew install --cask tailscale

# 또는 직접 다운로드
# https://tailscale.com/download/mac

Windows:

1. https://tailscale.com/download/windows 에서 다운로드
2. 설치 후 아래 명령어를 관리자 권한 PowerShell에서 실행

2. Headscale 서버에 등록

Linux/macOS:

sudo tailscale up \
  --login-server="https://head.0bin.in" \
  --authkey="fc4f2dc55ee00c5352823d156129b9ce2df4db02f1d76a21" \
  --accept-routes \
  --accept-dns=false

Windows (PowerShell 관리자 권한):

tailscale up `
  --login-server="https://head.0bin.in" `
  --authkey="fc4f2dc55ee00c5352823d156129b9ce2df4db02f1d76a21" `
  --accept-routes `
  --accept-dns=false

📊 연결 확인

연결 상태 확인:

tailscale status

IP 주소 확인:

tailscale ip -4

네트워크 테스트:

# 다른 팜큐 머신으로 핑 테스트
ping 100.64.0.1

🔑 관리자용 - Pre-auth Key 생성

새로운 약국용 Key 생성:

1. 스크립트 사용 (권장):

   ./create-preauth-key.sh pharmacy2 30d
   

2. 수동 생성:

   # 사용자 생성 (필요시)
   docker exec headscale headscale users create pharmacy2
   
   # Pre-auth key 생성
   docker exec headscale headscale preauthkeys create \
     -u 2 --expiration 30d --reusable
   

Key 관리 명령어:

# 사용자 목록 확인
docker exec headscale headscale users list

# Pre-auth key 목록 확인 (사용자 ID 필요)
docker exec headscale headscale preauthkeys list -u 1

# 만료된 key 삭제
docker exec headscale headscale preauthkeys expire -k <key_id>

🛠️ 문제해결

연결 안됨:

1. 방화벽 확인: 8080, 443 포트가 열려있는지 확인
2. DNS 확인: https://head.0bin.in 접근 가능한지 확인
3. Key 유효성: Pre-auth key가 만료되지 않았는지 확인

기존 연결 해제:

sudo tailscale logout

완전 재설정:

sudo tailscale logout
sudo tailscale up --login-server="https://head.0bin.in" --authkey="새로운키"

📱 모바일 설정

Android/iOS:

1. Tailscale 앱 설치
2. "Use a different server" 선택
3. 서버 URL: https://head.0bin.in
4. Pre-auth key 입력 (위 key 중 하나 사용)

🔐 보안 참고사항

• Pre-auth key는 민감한 정보입니다. 공유 시 주의하세요
• Key가 만료되기 전에 새로운 key를 생성하세요
• 불필요한 key는 정기적으로 만료시키세요
• 각 약국별로 별도의 사용자와 key를 사용하는 것을 권장합니다

📞 지원

문제가 발생하면 다음 정보를 포함하여 문의하세요:

• 운영체제 정보
• tailscale status 출력
• 에러 메시지
• 사용한 Pre-auth key (마지막 8자리만)

---

📋 요약

1. 간편 설치: register-client.sh 스크립트 실행
2. 수동 설치: Tailscale 설치 → tailscale up 명령어 실행
3. 연결 확인: tailscale status 및 tailscale ip 확인
4. 문제 시: 재부팅 또는 logout 후 재연결

서버: https://head.0bin.in
기본 Key: fc4f2dc55ee00c5352823d156129b9ce2df4db02f1d76a21