WSL2 中无法直接运行 InterSystems IRIS——它不是 Go 框架或 Mediapipe 模块，而是需下载 IRIS_Community_lnxubuntux64 安装包，解压后执行 irisinstall；pip 中的 iris 是 Go Web 框架，mediapipe 的 iris 导入失败则因版本不兼容。
WSL2 中无法直接运行 Iris 框架——因为 Iris 是 InterSystems IRIS 数据平台的简称，不是 Go 语言的 Iris Web 框架，也不是 Mediapipe 的 iris 模块。你在 WSL2 里搜 “Iris 安装” 却配不出服务，大概率是混淆了这三个完全无关的技术实体。
确认你真正要装的是 InterSystems IRIS 社区版
InterSystems IRIS 是 Caché 的继任者，专为医疗、金融等高事务场景设计，提供 MUMPS/SQL/互操作/机器学习一体化能力。它不叫 iris 命令，安装包名带 IRIS_Community 和 lnxubuntux64，解压后是 irisinstall 可执行文件。
- 如果你在 pip 里找
iris或iris-web，那是 Go 语言框架，和 WSL2 + Ubuntu 无关——Go 的Iris是纯编译型 Web 框架，不依赖数据库服务 - 如果你在
mediapipe.solutions里 importiris失败，那是 Python 包版本链断裂（见 mediapipe 0.10.x + protobuf 4.25 + numpy - IRIS 社区版官方只提供 tar.gz 包，不支持 apt install、不进 Ubuntu 软件源、不提供 .deb 包
IRIS_Community 在 WSL2 Ubuntu 上必须手动解压 + 初始化
IRIS 不走 Linux 标准服务注册流程，安装后需显式运行 irisinstall 并指定实例名、端口、目录；它默认监听 localhost:52773（Management Portal）、:1972（SuperServer），但 WSL2 的 localhost 和 Windows 主机不通，必须改绑定地址。
- 解压后进入目录，先给
irisinstall加执行权限：chmod +x irisinstall - 运行安装命令时必须加
-installdir和-port参数，例如：./irisinstall -installdir /opt/iris -port 52773 -name IRIS1 -
关键一步：启动前编辑
/opt/iris/mgr/iris.cpf，把WebServerAddress=localhost改成WebServerAddress=0.0.0.0，否则 Windows 浏览器打不开 Management Portal - 启动实例用
iris start IRIS1，而非systemctl或service—— IRIS 自带进程管理器，不兼容 systemd
WSL2 网络限制导致 Management Portal 访问失败的典型表现
你看到 iris start 成功、netstat -tuln | grep 52773 有监听，但 Windows 浏览器访问 http://localhost:52773/csp/sys/%25CSP.Portal.Home.zen 显示连接被拒绝，这不是 IRIS 没起来，而是 WSL2 的网络模型没打通。
- WSL2 使用虚拟网卡（如
eth0地址是172.xx.xx.xx），它的localhost≠ Windows 的localhost - 解决方法只有两个：
curl http://$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):52773在 WSL2 内验证；或在 Windows 上用http://127.0.0.1:52773——前提是 IRIS 配置已改为0.0.0.0且 Windows 防火墙放行该端口 - 如果仍连不上，检查 Windows 是否启用了“Windows Defender 防火墙”，临时关闭测试；或用
netsh interface portproxy add v4tov4 listenport=52773 listenaddress=127.0.0.1 connectport=52773 connectaddress=$(hostname -I | awk '{print $1}')做端口转发（需管理员 PowerShell）
IRIS 启动后不会自动创建用户，首次登录 Management Portal 必须用初始账号 SuperUser / 密码 SYS，登录后立即在 System Administration → Security → Users 里修改密码——社区版到期后若未续许可证，会强制锁定所有非内置账户，这个细节容易被忽略。
