diff --git a/README.md b/README.md index b732c93..7220f50 100644 --- a/README.md +++ b/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 ## ๐Ÿ“ ํŒŒ์ผ ๊ตฌ์กฐ ```