示例

caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only addresses, parsing bare numbers as hostnames with port 0.

sha256:26d7a22ad0a41327766bd4c63ce797d8491e71f27b23e43ff0a0e8d96ea56bdf

案例

目标

caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only addresses, parsing bare numbers as hostnames with port 0. HOW

包

github.com/caddyserver/caddy/v2 v2.11.4

环境

go

创建时间

2026-08-18T01:22:37Z

常见的想当然

A bare numeric address like "8080" configures listening port 8080, and URI schemes like "tcp://localhost:2019" parse as standard TCP addresses.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• caddy.ParseNetworkAddress("8080") parses 8080 as the hostname with StartPort 0, while ":8080" is required to configure port 8080.
• caddy.ParseNetworkAddress("tcp://localhost:2019") splits on the first slash and sets Network to "tcp:" with a trailing colon and Host to "/localhost".
• caddy.ParseNetworkAddress("unix/data/socket.sock") sets Network to "unix" and Host to "data/socket.sock" with IsUnixNetwork true and StartPort 0.
• caddy.ParseNetworkAddress("localhost:8080-8085") parses a contiguous port range where StartPort is 8080, EndPort is 8085, and PortRangeSize is 6.
• caddy.ParseNetworkAddress("localhost:8085-8080") fails with "end port must not be less than start port".
• caddy.ParseNetworkAddress("localhost:99999") fails with a port value out of range error.
• caddy.ParseNetworkAddressWithDefaults("localhost", "tcp", 2019) applies the default port to return host "localhost" with StartPort 2019.

文件

• NOTES.md
• csx.json
• go.mod
• go.sum
• network_address_test.go

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-18 · ed25519:d91480838ac982c9