Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

redirect

package

Go to main page

Versions in this module

v0

v0.4.0

Sep 6, 2026

v0.3.0

Aug 18, 2026

Changes in this version

type Snapshot

+ Codes []string

+ func (s *Snapshot) CodeSlug(raw string) string

v0.2.0

Aug 6, 2026

Changes in this version

+ const InvalidationChannel

+ const SSLStatusPending

+ type BroadcastHostInvalidator struct

+ Local *HostCache

+ Publisher *Resolver

+ func (b BroadcastHostInvalidator) InvalidateHosts(ctx context.Context)

+ type BroadcastRootInvalidator struct

+ Local RootCache

+ Publisher *Resolver

+ func (b BroadcastRootInvalidator) InvalidateRoot()

+ type Choice struct

+ ID uuid.UUID

+ URL string

+ type HostCache struct

+ OnReload func()

+ func NewHostCache(pool *pgxpool.Pool, log *slog.Logger) *HostCache

+ func (c *HostCache) Lookup(host string) (VerifiedDomain, bool)

+ func (c *HostCache) MarkTLSActive(host string)

+ func (c *HostCache) Ready() bool

+ func (c *HostCache) Refresh(ctx context.Context)

+ func (c *HostCache) Reload(ctx context.Context) error

+ func (c *HostCache) Size() int

type Options

+ InvalidateBudget time.Duration

type Resolver

+ func (r *Resolver) InvalidateDomain(ctx context.Context, domainID uuid.UUID)

+ func (r *Resolver) PublishHostInvalidation(ctx context.Context)

+ func (r *Resolver) PublishRootInvalidation(ctx context.Context)

+ type RootCache interface

+ InvalidateRoot func()

type Snapshot

+ BotPolicy domain.BotPolicy

+ Destinations []SnapshotDest

+ DomainBotPolicy domain.DomainBotPolicy

+ ForwardPath bool

+ RequireSignature bool

+ Rules []SnapshotRule

+ func (s *Snapshot) Fallback() (Choice, bool)

+ func (s *Snapshot) Gated() bool

+ func (s *Snapshot) Route(subject domain.RuleSubject) (Choice, bool)

+ func (s *Snapshot) RuleNeeds() domain.RuleNeeds

+ func (s *Snapshot) Split() (kind string, arms []Choice)

+ func (s *Snapshot) Weights(arms []Choice) []int32

+ type SnapshotDest struct

+ ID uuid.UUID

+ URL string

+ Weight int32

+ type SnapshotRule struct

+ Cond domain.RuleConditions

+ Dest int

+ Kind string

+ func (r SnapshotRule) KindOf() string

+ type Subscriber struct

+ Hosts *HostCache

+ Log *slog.Logger

+ ReadTimeout time.Duration

+ ReconnectBackoff time.Duration

+ Redis *goredis.Client

+ Resolver *Resolver

+ Root RootCache

+ func (s *Subscriber) Run(ctx context.Context)

+ type VerifiedDomain struct

+ Hostname string

+ ID uuid.UUID

+ RootRedirectURL string

+ SSLStatus string

v0.1.0

Jul 31, 2026

Changes in this version

+ const CacheKeyVersion

+ type Options struct

+ DBTimeout time.Duration

+ Logger *slog.Logger

+ MemCacheSize int

+ NegativeTTL time.Duration

+ RedisTimeout time.Duration

+ TTL time.Duration

+ type Outcome int

+ const OutcomeGone

+ const OutcomeNotFound

+ const OutcomeRedirect

+ type Resolver struct

+ func NewResolver(pool *pgxpool.Pool, rdb *goredis.Client, opts Options) *Resolver

+ func (r *Resolver) CacheSize() int

+ func (r *Resolver) InvalidateAlias(ctx context.Context, domainID uuid.UUID, alias string)

+ func (r *Resolver) Resolve(ctx context.Context, domainID uuid.UUID, alias string) (Result, error)

+ func (r *Resolver) ResolveCached(domainID uuid.UUID, alias string) (Result, bool)

+ type Result struct

+ Snapshot *Snapshot

+ Source Source

+ type Snapshot struct

+ ExpiresAt *time.Time

+ ForwardQuery bool

+ HasPassword bool

+ LinkID uuid.UUID

+ MaxClicks *int64

+ NotFound bool

+ OneTime bool

+ Status string

+ URL string

+ WorkspaceID uuid.UUID

+ func (s *Snapshot) CacheTTL(now time.Time, base, negative time.Duration) time.Duration

+ func (s *Snapshot) Decide(now time.Time) Outcome

+ type Source string

+ const SourceDatabase

+ const SourceMemory

+ const SourceNegative

+ const SourceRedis