Fiber框架本身不依赖外部网络,局域网安装受阻99%是GOPROXY或GOSUMDB配置问题;需配置国内代理如https://goproxy.cn,direct,或关闭校验go env -w GOSUMDB=off,监听需设为0.0.0.0:3000。

go get 失败:module github.com/gofiber/fiber/v2: reading https://proxy.golang.org/... timeout
局域网没配 GOPROXY,Go 默认走官方代理(https://proxy.golang.org),而该地址在国内多数环境不可达。
- 临时解决:执行
go env -w GOPROXY=https://goproxy.cn,direct(国内可用)或https://goproxy.io,direct - 企业内网推荐:设为公司自建的 Artifactory 或 Nexus 的 Go 仓库地址,例如
https://nexus.example.com/repository/golang-proxy/ - 完全离线?把
github.com/gofiber/fiber/v2及其依赖(github.com/valyala/fasthttp等)提前go mod download到可联网机器,再拷贝整个$GOPATH/pkg/mod目录到目标机器对应路径
go mod tidy 报错:require github.com/gofiber/fiber/v2: reading https://sum.golang.org/lookup/... 410 Gone
这是 Go 校验模块签名时访问 sum.golang.org 失败,和 Fiber 无关,但会卡住模块拉取。
- 关掉校验(仅限可信内网):
go env -w GOSUMDB=off - 换国内校验源(如清华):
go env -w GOSUMDB=sum.golang.google.cn - 若用私有代理,确保它同时支持
GOPROXY和GOSUMDB(比如 Nexus Go repo 支持两者)
fiber.New() 启动后 localhost 能访问,但局域网其他设备 curl http://192.168.x.x:3000 连接拒绝
这不是安装问题,是 Fiber 默认只监听 127.0.0.1:3000,不对外暴露。
- 改监听地址:
app.Listen("0.0.0.0:3000")(注意不是"":3000,后者在某些版本行为不一致) - 检查宿主机防火墙:
ufw status(Ubuntu)或firewall-cmd --list-all(CentOS),放行端口 - 如果是 Docker 容器,确认
-p 3000:3000且应用未绑定127.0.0.1
go mod vendor,然后把 vendor/ 目录一起带过去。


















