tsweb

README

Simple Private Virtual Service on Tailscale

This module is intended to remove some of the boilerplate for running simple web services within a tailscale tailnet.

Adding to project

go get -u github.com/kellegous/tsweb

Example Use

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"

	"tailscale.com/tsnet"

	"github.com/kellegous/tsweb"
)

func main() {
	s, err := tsweb.Start(&tsnet.Server{
		AuthKey:  os.Getenv("TS_AUTHKEY"),
		Hostname: "sample",
		Dir:      "data",
	})
	if err != nil {
		log.Panic(err)
	}
	defer s.Close()

	l, err := s.ListenTLS("tcp", ":https")
	if err != nil {
		log.Panic(err)
	}

	log.Panic(
		http.Serve(l, http.HandlerFunc(
			func(w http.ResponseWriter, r *http.Request) {
				fmt.Fprintf(w, "Hello Tailnet")
			},
		)),
	)
}

Authors

• Kelly Norton (kellegous)

Documentation

Index

• type Service
  • func Start(s *tsnet.Server) (*Service, error)
  • func (s *Service) GetDNSName(ctx context.Context) (string, error)
  • func (s *Service) ListenTLS(network string, addr string) (net.Listener, error)
  • func (s *Service) RedirectHTTP(ctx context.Context) error
  • func (s *Service) WaitUntilReady(ctx context.Context) error

Types

type Service

type Service struct {
	*tsnet.Server
}

func Start

func Start(s *tsnet.Server) (*Service, error)

func (*Service) GetDNSName

func (s *Service) GetDNSName(ctx context.Context) (string, error)

func (*Service) ListenTLS

func (s *Service) ListenTLS(network string, addr string) (net.Listener, error)

func (*Service) RedirectHTTP

func (s *Service) RedirectHTTP(ctx context.Context) error

func (*Service) WaitUntilReady

func (s *Service) WaitUntilReady(ctx context.Context) error