mirror of
				https://github.com/juanfont/headscale.git
				synced 2025-10-28 10:51:44 +01:00 
			
		
		
		
	* Simplify /windows to the bare minimum. Also remove the /windows/tailscale.reg endpoint as its generated file is no longer valid for current Tailscale versions. * Update and simplify the windows documentation accordingly. * Add a "Unattended mode" section to the troubleshooting section explaining how to enable "Unattended mode" in the via the Tailscale tray icon. * Add infobox about /windows to the docs Tested on Windows 10, 22H2 with Tailscale 1.72.0 Replaces: #1995 See: #2096
		
			
				
	
	
		
			357 lines
		
	
	
		
			8.8 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			357 lines
		
	
	
		
			8.8 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| package hscontrol
 | |
| 
 | |
| import (
 | |
| 	"bytes"
 | |
| 	_ "embed"
 | |
| 	"html/template"
 | |
| 	"net/http"
 | |
| 	textTemplate "text/template"
 | |
| 
 | |
| 	"github.com/gofrs/uuid/v5"
 | |
| 	"github.com/gorilla/mux"
 | |
| 	"github.com/rs/zerolog/log"
 | |
| )
 | |
| 
 | |
| //go:embed templates/apple.html
 | |
| var appleTemplate string
 | |
| 
 | |
| //go:embed templates/windows.html
 | |
| var windowsTemplate string
 | |
| 
 | |
| // WindowsConfigMessage shows a simple message in the browser for how to configure the Windows Tailscale client.
 | |
| func (h *Headscale) WindowsConfigMessage(
 | |
| 	writer http.ResponseWriter,
 | |
| 	req *http.Request,
 | |
| ) {
 | |
| 	winTemplate := template.Must(template.New("windows").Parse(windowsTemplate))
 | |
| 	config := map[string]interface{}{
 | |
| 		"URL": h.cfg.ServerURL,
 | |
| 	}
 | |
| 
 | |
| 	var payload bytes.Buffer
 | |
| 	if err := winTemplate.Execute(&payload, config); err != nil {
 | |
| 		log.Error().
 | |
| 			Str("handler", "WindowsRegConfig").
 | |
| 			Err(err).
 | |
| 			Msg("Could not render Windows index template")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Could not render Windows index template"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	writer.Header().Set("Content-Type", "text/html; charset=utf-8")
 | |
| 	writer.WriteHeader(http.StatusOK)
 | |
| 	_, err := writer.Write(payload.Bytes())
 | |
| 	if err != nil {
 | |
| 		log.Error().
 | |
| 			Caller().
 | |
| 			Err(err).
 | |
| 			Msg("Failed to write response")
 | |
| 	}
 | |
| }
 | |
| 
 | |
| // AppleConfigMessage shows a simple message in the browser to point the user to the iOS/MacOS profile and instructions for how to install it.
 | |
| func (h *Headscale) AppleConfigMessage(
 | |
| 	writer http.ResponseWriter,
 | |
| 	req *http.Request,
 | |
| ) {
 | |
| 	appleTemplate := template.Must(template.New("apple").Parse(appleTemplate))
 | |
| 
 | |
| 	config := map[string]interface{}{
 | |
| 		"URL": h.cfg.ServerURL,
 | |
| 	}
 | |
| 
 | |
| 	var payload bytes.Buffer
 | |
| 	if err := appleTemplate.Execute(&payload, config); err != nil {
 | |
| 		log.Error().
 | |
| 			Str("handler", "AppleMobileConfig").
 | |
| 			Err(err).
 | |
| 			Msg("Could not render Apple index template")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Could not render Apple index template"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	writer.Header().Set("Content-Type", "text/html; charset=utf-8")
 | |
| 	writer.WriteHeader(http.StatusOK)
 | |
| 	_, err := writer.Write(payload.Bytes())
 | |
| 	if err != nil {
 | |
| 		log.Error().
 | |
| 			Caller().
 | |
| 			Err(err).
 | |
| 			Msg("Failed to write response")
 | |
| 	}
 | |
| }
 | |
| 
 | |
| func (h *Headscale) ApplePlatformConfig(
 | |
| 	writer http.ResponseWriter,
 | |
| 	req *http.Request,
 | |
| ) {
 | |
| 	vars := mux.Vars(req)
 | |
| 	platform, ok := vars["platform"]
 | |
| 	if !ok {
 | |
| 		log.Error().
 | |
| 			Str("handler", "ApplePlatformConfig").
 | |
| 			Msg("No platform specified")
 | |
| 		http.Error(writer, "No platform specified", http.StatusBadRequest)
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	id, err := uuid.NewV4()
 | |
| 	if err != nil {
 | |
| 		log.Error().
 | |
| 			Str("handler", "ApplePlatformConfig").
 | |
| 			Err(err).
 | |
| 			Msg("Failed not create UUID")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Failed to create UUID"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	contentID, err := uuid.NewV4()
 | |
| 	if err != nil {
 | |
| 		log.Error().
 | |
| 			Str("handler", "ApplePlatformConfig").
 | |
| 			Err(err).
 | |
| 			Msg("Failed not create UUID")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Failed to create content UUID"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	platformConfig := AppleMobilePlatformConfig{
 | |
| 		UUID: contentID,
 | |
| 		URL:  h.cfg.ServerURL,
 | |
| 	}
 | |
| 
 | |
| 	var payload bytes.Buffer
 | |
| 	handleMacError := func(ierr error) {
 | |
| 		log.Error().
 | |
| 			Str("handler", "ApplePlatformConfig").
 | |
| 			Err(ierr).
 | |
| 			Msg("Could not render Apple macOS template")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Could not render Apple macOS template"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	switch platform {
 | |
| 	case "macos-standalone":
 | |
| 		if err := macosStandaloneTemplate.Execute(&payload, platformConfig); err != nil {
 | |
| 			handleMacError(err)
 | |
| 
 | |
| 			return
 | |
| 		}
 | |
| 	case "macos-app-store":
 | |
| 		if err := macosAppStoreTemplate.Execute(&payload, platformConfig); err != nil {
 | |
| 			handleMacError(err)
 | |
| 
 | |
| 			return
 | |
| 		}
 | |
| 	case "ios":
 | |
| 		if err := iosTemplate.Execute(&payload, platformConfig); err != nil {
 | |
| 			log.Error().
 | |
| 				Str("handler", "ApplePlatformConfig").
 | |
| 				Err(err).
 | |
| 				Msg("Could not render Apple iOS template")
 | |
| 
 | |
| 			writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 			writer.WriteHeader(http.StatusInternalServerError)
 | |
| 			_, err := writer.Write([]byte("Could not render Apple iOS template"))
 | |
| 			if err != nil {
 | |
| 				log.Error().
 | |
| 					Caller().
 | |
| 					Err(err).
 | |
| 					Msg("Failed to write response")
 | |
| 			}
 | |
| 
 | |
| 			return
 | |
| 		}
 | |
| 	default:
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusBadRequest)
 | |
| 		_, err := writer.Write(
 | |
| 			[]byte("Invalid platform. Only ios, macos-app-store and macos-standalone are supported"),
 | |
| 		)
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	config := AppleMobileConfig{
 | |
| 		UUID:    id,
 | |
| 		URL:     h.cfg.ServerURL,
 | |
| 		Payload: payload.String(),
 | |
| 	}
 | |
| 
 | |
| 	var content bytes.Buffer
 | |
| 	if err := commonTemplate.Execute(&content, config); err != nil {
 | |
| 		log.Error().
 | |
| 			Str("handler", "ApplePlatformConfig").
 | |
| 			Err(err).
 | |
| 			Msg("Could not render Apple platform template")
 | |
| 
 | |
| 		writer.Header().Set("Content-Type", "text/plain; charset=utf-8")
 | |
| 		writer.WriteHeader(http.StatusInternalServerError)
 | |
| 		_, err := writer.Write([]byte("Could not render Apple platform template"))
 | |
| 		if err != nil {
 | |
| 			log.Error().
 | |
| 				Caller().
 | |
| 				Err(err).
 | |
| 				Msg("Failed to write response")
 | |
| 		}
 | |
| 
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	writer.Header().
 | |
| 		Set("Content-Type", "application/x-apple-aspen-config; charset=utf-8")
 | |
| 	writer.WriteHeader(http.StatusOK)
 | |
| 	_, err = writer.Write(content.Bytes())
 | |
| 	if err != nil {
 | |
| 		log.Error().
 | |
| 			Caller().
 | |
| 			Err(err).
 | |
| 			Msg("Failed to write response")
 | |
| 	}
 | |
| }
 | |
| 
 | |
| type AppleMobileConfig struct {
 | |
| 	UUID    uuid.UUID
 | |
| 	URL     string
 | |
| 	Payload string
 | |
| }
 | |
| 
 | |
| type AppleMobilePlatformConfig struct {
 | |
| 	UUID uuid.UUID
 | |
| 	URL  string
 | |
| }
 | |
| 
 | |
| var commonTemplate = textTemplate.Must(
 | |
| 	textTemplate.New("mobileconfig").Parse(`<?xml version="1.0" encoding="UTF-8"?>
 | |
| <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 | |
| <plist version="1.0">
 | |
|   <dict>
 | |
|     <key>PayloadUUID</key>
 | |
|     <string>{{.UUID}}</string>
 | |
|     <key>PayloadDisplayName</key>
 | |
|     <string>Headscale</string>
 | |
|     <key>PayloadDescription</key>
 | |
|     <string>Configure Tailscale login server to: {{.URL}}</string>
 | |
|     <key>PayloadIdentifier</key>
 | |
|     <string>com.github.juanfont.headscale</string>
 | |
|     <key>PayloadRemovalDisallowed</key>
 | |
|     <false/>
 | |
|     <key>PayloadType</key>
 | |
|     <string>Configuration</string>
 | |
|     <key>PayloadVersion</key>
 | |
|     <integer>1</integer>
 | |
|     <key>PayloadContent</key>
 | |
|     <array>
 | |
|     {{.Payload}}
 | |
|     </array>
 | |
|   </dict>
 | |
| </plist>`),
 | |
| )
 | |
| 
 | |
| var iosTemplate = textTemplate.Must(textTemplate.New("iosTemplate").Parse(`
 | |
|     <dict>
 | |
|         <key>PayloadType</key>
 | |
|         <string>io.tailscale.ipn.ios</string>
 | |
|         <key>PayloadUUID</key>
 | |
|         <string>{{.UUID}}</string>
 | |
|         <key>PayloadIdentifier</key>
 | |
|         <string>com.github.juanfont.headscale</string>
 | |
|         <key>PayloadVersion</key>
 | |
|         <integer>1</integer>
 | |
|         <key>PayloadEnabled</key>
 | |
|         <true/>
 | |
| 
 | |
|         <key>ControlURL</key>
 | |
|         <string>{{.URL}}</string>
 | |
|     </dict>
 | |
| `))
 | |
| 
 | |
| var macosAppStoreTemplate = template.Must(template.New("macosTemplate").Parse(`
 | |
|     <dict>
 | |
|         <key>PayloadType</key>
 | |
|         <string>io.tailscale.ipn.macos</string>
 | |
|         <key>PayloadUUID</key>
 | |
|         <string>{{.UUID}}</string>
 | |
|         <key>PayloadIdentifier</key>
 | |
|         <string>com.github.juanfont.headscale</string>
 | |
|         <key>PayloadVersion</key>
 | |
|         <integer>1</integer>
 | |
|         <key>PayloadEnabled</key>
 | |
|         <true/>
 | |
|         <key>ControlURL</key>
 | |
|         <string>{{.URL}}</string>
 | |
|     </dict>
 | |
| `))
 | |
| 
 | |
| var macosStandaloneTemplate = template.Must(template.New("macosStandaloneTemplate").Parse(`
 | |
|     <dict>
 | |
|         <key>PayloadType</key>
 | |
|         <string>io.tailscale.ipn.macsys</string>
 | |
|         <key>PayloadUUID</key>
 | |
|         <string>{{.UUID}}</string>
 | |
|         <key>PayloadIdentifier</key>
 | |
|         <string>com.github.juanfont.headscale</string>
 | |
|         <key>PayloadVersion</key>
 | |
|         <integer>1</integer>
 | |
|         <key>PayloadEnabled</key>
 | |
|         <true/>
 | |
|         <key>ControlURL</key>
 | |
|         <string>{{.URL}}</string>
 | |
|     </dict>
 | |
| `))
 |