clientip

package

v0.1.1 Latest Latest Go to latest Published: Apr 18, 2026 License: MIT Imports: 4 Imported by: 0

Details

Package clientip provides client IP extraction utilities. 客户端 IP 提取工具。

This section is empty.

This section is empty.

func FromRemote(remoteAddr string) (netip.Addr, bool)

FromRemote parses IP from remote address string. FromRemote 从远程地址字符串解析 IP。

func FromRequest(r *http.Request, opts Options) (netip.Addr, bool)

FromRequest extracts client IP using the provided trust policy. FromRequest 按传入的信任策略提取客户端 IP。

Example / 示例:

ip, ok := clientip.FromRequest(r, clientip.Options{})

type Options struct {
	TrustedProxies []netip.Prefix
}

Options controls whether forwarded headers may be trusted. Options 控制是否允许信任转发头。