Help us shape the future of Go! Take the 2026 Go Developer Survey

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

config

package

Go to main page

Versions in this module

v0

v0.3.0

Oct 2, 2026

v0.2.0

Sep 25, 2026

Changes in this version

+ type ClientConfig struct

+ AllowHTTP bool

+ DialTimeout time.Duration

+ Dialer network.Dialer

+ DisableKeepAlive bool

+ MaxHeaderListSize uint32

+ MaxIdleConnDuration time.Duration

+ NoDefaultUserAgent bool

+ PingTimeout time.Duration

+ ReadIdleTimeout time.Duration

+ ReadTimeout time.Duration

+ RetryConfig *retry.Config

+ RetryIf client.RetryIfFunc

+ StrictMaxConcurrentStreams bool

+ TLSConfig *tls.Config

+ WriteByteTimeout time.Duration

+ WriteTimeout time.Duration

+ func NewClientConfig(opts ...ClientOption) *ClientConfig

+ func (o *ClientConfig) Apply(opts []ClientOption)

+ type ClientOption struct

+ F func(o *ClientConfig)

+ func WithAllowHTTP(allow bool) ClientOption

+ func WithClientDisableKeepAlive(disable bool) ClientOption

+ func WithClientReadTimeout(t time.Duration) ClientOption

+ func WithClientWriteTimeout(t time.Duration) ClientOption

+ func WithDialTimeout(timeout time.Duration) ClientOption

+ func WithDialer(d network.Dialer) ClientOption

+ func WithMaxHeaderListSize(maxHeaderListSize uint32) ClientOption

+ func WithMaxIdempotentCallAttempts(n int) ClientOption

+ func WithMaxIdleConnDuration(d time.Duration) ClientOption

+ func WithNoDefaultUserAgent(noDefaultUserAgent bool) ClientOption

+ func WithPingTimeout(pt time.Duration) ClientOption

+ func WithReadIdleTimeout(readIdleTimeout time.Duration) ClientOption

+ func WithRetryConfig(opts ...retry.Option) ClientOption

+ func WithStrictMaxConcurrentStreams(strictMaxConcurrentStreams bool) ClientOption

+ func WithTLSConfig(tlsConfig *tls.Config) ClientOption

+ func WithWriteByteTimeout(writeByteTimeout time.Duration) ClientOption

+ type Config struct

+ DisableKeepalive bool

+ EnableTrace bool

+ IdleTimeout time.Duration

+ MaxConcurrentStreams uint32

+ MaxHandlers int

+ MaxHeaderFields int

+ MaxHeaderListSize uint32

+ MaxReadFrameSize uint32

+ MaxUploadBufferPerConnection int32

+ MaxUploadBufferPerStream int32

+ PermitProhibitedCipherSuites bool

+ ReadTimeout time.Duration

+ func NewConfig(opts ...Option) *Config

+ func (o *Config) Apply(opts []Option)

+ type Option struct

+ F func(o *Config)

+ func WithDisableKeepAlive(disableKeepAlive bool) Option

+ func WithIdleTimeout(t time.Duration) Option

+ func WithMaxConcurrentStreams(n uint32) Option

+ func WithMaxReadFrameSize(n uint32) Option

+ func WithMaxUploadBufferPerConnection(n int32) Option

+ func WithMaxUploadBufferPerStream(n int32) Option

+ func WithPermitProhibitedCipherSuites(permitProhibitedChipherSuites bool) Option

+ func WithReadTimeout(t time.Duration) Option

+ func WithServerMaxHeaderFields(n int) Option

+ func WithServerMaxHeaderListSize(n uint32) Option