Iris 是基于 Go 的高性能 Web 框架，部署本质是分发和运行静态编译的可执行文件；无需 Go 环境或外部依赖，仅需跨平台编译、传输二进制，并通过 systemd 或进程管理工具启动。
Iris 是一个用 Go 语言编写的高性能 Web 框架，不是 Python 的 iris 数据集或 DFIR-IRIS 安全平台。安装和启动它不依赖 Python、PostgreSQL 或 Docker，而是基于 Go 工具链。如果你在 Linux 上执行 go run main.go 却报错 “command not found: iris”，说明你没装 Go，或者没正确初始化项目。
确认 Go 环境是否就绪
Go 必须已安装且 $GOPATH 和 $PATH 配置正确，否则 go get 会失败或生成的二进制无法运行。
- 运行
go version，输出应类似go version go1.21.13 linux/amd64（1.21+ 推荐） - 检查
go env GOPATH，确保路径存在且可写；若为空，需手动设置（如export GOPATH=$HOME/go） - 把
$GOPATH/bin加入$PATH，否则安装的 CLI 工具（如iris-cli）无法调用
用 go install 安装 iris-cli（可选但实用）
iris-cli 是官方提供的脚手架工具，能快速生成项目结构，但它从 Go 1.21 起不再支持 go get，必须用 go install：
- 执行
go install github.com/kataras/iris/v12@latest（注意末尾的@latest，缺了会报“invalid version”） - 安装后验证：
iris-cli version应输出版本号；若提示 command not found，请检查$GOPATH/bin是否在$PATH中 - 不用
iris-cli也能写 Iris 应用——只需导入"github.com/kataras/iris/v12"包并调用app.Run()
启动一个最简 Iris 服务
新建 main.go，内容不能少于三行，否则监听失败或 panic：
Linux Security Scanner
下载
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.New()
app.Get("/ping", func(ctx iris.Context) {
ctx.WriteString("pong")
})
app.Listen(":8080")
}
- 保存后执行
go run main.go，访问http://localhost:8080/ping应返回pong - 若提示
address already in use，说明端口被占；换端口如:8081即可 - 别用 root 启动监听
:80或:443——生产环境应反向代理（如 Nginx），而非直接提权运行
常见启动失败原因
实际部署时，app.Listen() 报错往往不是代码问题，而是权限或环境干扰：
-
listen tcp :8080: bind: permission denied：Linux 上非 root 用户不能绑定 1024 以下端口，但 8080 是合法的；此错误多因 SELinux 或 systemd socket 激活占用了该端口 -
failed to listen on :8080: accept tcp [::]:8080: use of closed network connection：通常因app.Shutdown()被提前调用，或main()函数退出太快 - 使用
systemd托管时，务必设Type=simple，不能用Type=notify——Iris 不发 readiness 信号
Go 模块缓存、CGO_ENABLED 设置、交叉编译目标架构这些细节，在简单启动阶段几乎不会暴露；真正卡住人的，往往是 $GOPATH 没生效，或以为装了 iris 就像 pip 包一样全局可用——它只是个 Go 包，没有独立 CLI，除非你显式安装了 iris-cli。
