离线安装Iris本质是打包依赖并编译可执行文件；需在联网机执行go mod vendor生成vendor目录，离线机用CGO_ENABLED=0 go build -mod=vendor编译，配合go:embed嵌入静态资源实现单二进制部署。
离线安装 Iris 框架本质不是“装框架”，而是把依赖完整打包进项目，再在目标机器上用 go build 编译出可执行文件——因为 Go 的模块机制默认走网络拉包，没网时会卡在 go mod download 或 go build 阶段。
离线环境必须提前准备 vendor 目录
vendor 是 Go 官方支持的离线依赖管理方式，它把所有第三方包（包括 github.com/kataras/iris/v12 及其 transitive deps）拷贝到项目根目录下的 vendor/ 文件夹中。目标机器只需有 Go 环境（无需联网），就能直接编译：
- 开发机（有网）执行：
go mod vendor，生成完整的vendor/目录 - 确认
go.mod中已声明github.com/kataras/iris/v12版本（如v12.2.0），且go.sum已校验通过 - 把整个项目（含
vendor/、go.mod、go.sum、main.go）打包传到离线机器 - 离线机器运行：
go build -mod=vendor -o myapp ./main.go（-mod=vendor强制只读 vendor）
CGO_ENABLED=0 是离线部署的关键开关
Iris 默认不依赖 cgo，但某些中间件（如 iris.Compression 后端用到 zlib）或自定义 DNS 解析可能触发 cgo。一旦启用 cgo，Go 会尝试链接系统 libc，而离线服务器若 libc 版本太旧或缺失头文件，go build 就会失败。所以：
- 统一加
CGO_ENABLED=0：确保静态链接，不查系统库，也不依赖gcc - 命令示例：
CGO_ENABLED=0 go build -mod=vendor -o myapp ./main.go - 如果项目确实要用 SQLite 或 OpenSSL 功能，则必须设
CGO_ENABLED=1，并提前在离线机器装好对应 dev 包（如libc6-dev、libsqlite3-dev），这会大幅增加离线部署复杂度
go:embed 替代 assets 打包，避免 runtime 读文件失败
很多 Iris 项目用 app.HandleDir 或模板渲染依赖磁盘上的 views/、public/ 目录。离线部署时若路径写死或权限不对，启动就 panic。更稳的做法是用 Go 1.16+ 的 go:embed 把静态资源编译进二进制：
- 在代码里声明：
//go:embed views/* public/*，然后用embed.FS构造iris.Dir - 这样连
views/目录都不用传到服务器，单个myapp文件即可运行 - 注意：嵌入路径必须是相对当前
.go文件的路径，且不能用../向上跳转 - 验证是否成功：编译后用
strings myapp | grep "index.html"看资源是否在二进制里
真正麻烦的不是“怎么装 Iris”，而是离线环境下对 go mod 行为、cgo 链接、文件路径的假设容易失效——vendor 目录必须和 go version、GOOS/GOARCH 严格匹配，嵌入资源的路径拼写错一个字符就加载失败，这些细节比联网安装多出三倍检查项。
