Files
headscale/QUICKSTART.md
Timmy c3f7ef2c75 Restructure documentation files for better organization
- Remove old README file
- Add QUICKSTART.md for quick setup (3-step process)
- Add SUMMARY.md for project overview and architecture
- Add OPERATIONS.md for detailed management procedures
- Keep README.md as comprehensive main documentation
- Organize content by purpose: quick start, overview, operations

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-03-24 10:26:22 +08:00

1.3 KiB
Raw Permalink Blame History

Headscale 快速上手指南

伺服器資訊

三步快速啟動

1. 準備環境

# 建立 Docker 網路
docker network create shared-net

# 啟動服務
make up

# 查看狀態
make ps

2. 設備連接

# 產生預授權金鑰
headscale preauthkeys create \
  --user 1 \
  --reusable \
  --ephemeral=false \
  --expiration 87600h

# 設備連接指令
tailscale up --login-server https://headscale.lotimmy.com --auth-key <金鑰>

3. 註冊節點

# 在設備連接後執行
headscale nodes register --user mainnet --key <設備返回的金鑰>

常用指令

服務管理

make up      # 啟動服務
make down    # 停止服務
make restart # 重啟服務
make logs    # 查看日誌

節點管理

headscale nodes list              # 查看節點
headscale nodes tag --id 4 --tags tag:server  # 標記節點

健康檢查

./api_user_request.sh    # API 檢查
make logs               # 服務日誌

下一步

  • 查看 README.md 獲取完整文件
  • 查看節點狀態:headscale nodes list
  • 配置 Exit Node參考 README 中的 Exit Node 章節