Iris 是 Go 库，不可在云服务器上“安装”，正确做法是本地静态编译为二进制（如 CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp ./main.go），再上传至服务器（如 /opt/myapp/），通过 systemd 托管运行，且 iris.Dir() 等路径必须用绝对路径并确保权限正确。
直接在云服务器上安装 Iris 框架本身没有意义——Iris 是 Go 语言库，不提供独立可执行的“服务端程序”，你真正要做的，是把本地写好的 Iris 应用编译成二进制，再传到云服务器运行。整个过程不涉及 go install 或全局框架安装，也不需要在服务器上装 Go 环境（除非你打算在线编译）。
为什么不能在云服务器上 “安装 Iris”？
Iris 是一个 Go import 包，不是像 Nginx 那样的系统级服务。它的生命周期绑定在你的 Go 项目里：go.mod 声明依赖、go build 打包时自动拉取并静态链接。云服务器只需运行最终生成的二进制文件，连 Go 运行时都不需要。
- 执行
go get github.com/kataras/iris/v12在服务器上只会下载源码到$GOPATH/src，但不会注册任何命令或服务 - 若服务器没装 Go，
go get直接报错command not found: go - 即使装了 Go，也仅用于开发调试；生产部署应避免在服务器上
go run或go build，以防环境差异导致行为不一致
正确流程：本地编译 + 上传 + systemd 托管
这是目前最稳定、最符合 Go 生产实践的方式。关键点不在“装”，而在“传”和“启”。
- 本地终端执行：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp ./main.go（确保生成纯静态二进制） - 用
scp或rsync上传：scp myapp user@your-server:/opt/myapp/，目标路径需提前mkdir -p /opt/myapp并chown myapp:myapp /opt/myapp - 创建 systemd 服务文件
/etc/systemd/system/myapp.service，其中WorkingDirectory必须设为/opt/myapp，否则iris.Dir("./assets")类路径会失效 -
ExecStart中不要加cd /opt/myapp && ./myapp—— systemd 不支持 shell 语法，必须写成完整路径：/opt/myapp/myapp --port=8080
常见失败现象与对应检查项
服务启动后访问 404、500 或直接退出，大概率不是 Iris 问题，而是部署链路某处断了。
- 日志显示
open ./assets: permission denied→ 检查iris.Dir()是否用了相对路径，且WorkingDirectory是否匹配 - curl 返回空响应或 connection refused → 先确认端口监听：
sudo ss -tlnp | grep :8080；若无输出，说明进程根本没起来，看journalctl -u myapp -f - 静态资源返回 404，但 API 正常 →
app.HandleDir("/static", iris.Dir("/opt/myapp/static"))中第二个参数漏了iris.Dir()，Go 编译不报错但运行时 panic - HTTPS 自动证书失败（Let’s Encrypt）→ Iris 的 TLS 自动续期依赖服务器有公网 IP + 80/443 端口可被外网访问；云服务器常默认封 80，需在安全组放行
最易被忽略的是 iris.Dir() 必须传绝对路径，且该路径的读权限必须对 systemd 服务用户（如 www-data）开放——哪怕目录存在、所有者是你自己，只要没给组或其他用户读权限，Iris 就静默拒绝提供文件。
