📦 下载部署灵犀引擎 v2.0.37

系统要求与部署命令总览

平台	要求	部署命令
Windows	Win10 1809+ / Win11，PowerShell 5.1+，磁盘 ≥ 2GB	irm https://www.lingxi-engine.com/install.ps1 | iex
macOS	macOS 12+，Apple Silicon 或 Intel，磁盘 ≥ 2GB	curl -fsSL https://www.lingxi-engine.com/public/install.sh | bash
Linux 桌面	Ubuntu 20.04+ / Debian 11+ / CentOS Stream 8/9	curl -fsSL https://www.lingxi-engine.com/public/install.sh | bash
Linux 服务器	同上，建议 1 核 2GB 起步	curl -fsSL https://www.lingxi-engine.com/install.sh | bash
NVIDIA DGX	DGX OS（Ubuntu 基底），自带 CUDA 驱动	curl -fsSL https://www.lingxi-engine.com/install.sh | bash
CentOS 7	❌ 不支持（glibc 2.17 过旧）	—

安装脚本会自动做什么

1. 识别操作系统与芯片架构（x86_64 / arm64）
2. 安装 Node.js 运行时（apt / dnf / yum / Homebrew 自动分支）
3. 下载引擎分发包（约 2.65MB）并解压到安装目录
4. 生成 .env 配置（含随机 JWT 密钥）并安装 npm 依赖
5. 配置开机自启（macOS LaunchAgent / Linux systemd 用户服务或 XDG autostart）
6. 启动引擎并打开 http://localhost:3456

DGX / GPU 服务器追加步骤（本地大模型推理）

引擎装好后，如需接本地 GPU 模型：

curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:14b          # 按显存选模型
cat >> /opt/lingxi-engine/.env <<'EOF'
OPENAI_BASE_URL=http://localhost:11434/v1
OPENAI_API_KEY=ollama
MODEL_NAME=qwen2.5:14b
EOF
pm2 restart lingxi-engine || sudo systemctl restart lingxi-engine

DGX OS 自带 CUDA，Ollama 直接识别 GPU，无需额外装驱动；端口对外需 sudo ufw allow 3456。

安装后验证

curl http://localhost:3456/api/health
# 期望返回 {"ok":true,"version":"2.0.37","agents":11,...}

手动部署（不用脚本）

完整手动步骤（Node 安装 → tarball 解压 → .env 配置 → npm install → PM2/systemd 托管）参考 install.sh 内的安装逻辑；Linux 桌面还可选 deb / AppImage 安装包（构建脚本在仓库 linux_packaging/ 目录）。

📖 更完整的图文部署指南（含离线部署、PM2 托管、常见排障）见 站内文档。

安装类

Q：curl 命令执行后没反应 / 卡住？
A：检查网络能否访问 https://www.lingxi-engine.com（公司内网可能拦截非常用端口）；macOS 用户确认用的是「终端」而非 IDE 内置受限终端。

Q：macOS 上 dmg 应用被系统拦截？
A：执行 curl -fsSL https://www.lingxi-engine.com/public/install.sh | bash -s -- --fix-app 一键解除 Gatekeeper 拦截。

Q：Linux 提示 glibc too old？
A：系统过旧（如 CentOS 7），请升级到 Ubuntu 20.04+ / Debian 11+ / CentOS Stream 8+。

Q：npm 安装很慢或超时？
A：切换国内镜像 npm config set registry https://registry.npmmirror.com 后重跑脚本。

移动端类

Q：手机端需要配置什么吗？
A：不需要配置模型、不需要装运行环境。手机只做显示和下发指令，用同一个账号登录即可。

Q：手机端会不会消耗手机算力／手机会不会发烫？
A：不会。模型推理和工具执行全部发生在引擎所在机器（你的电脑或云端服务器）上，手机不承担计算。

Q：手机登录后为什么和我电脑上的会话不一样？
A：多半是登录了不同账号。请确认手机端与电脑端使用完全相同的账号密码；另外若引擎是本地／自部署的，需确认手机访问的正是那台引擎。

Q：电脑上正在跑的任务，手机能接管吗？
A：能。同账号下任务状态共享，手机上可查看进度、继续下发指令，任务仍在引擎侧持续运行。

运行类

Q：端口 3456 被占用？
A：编辑 .env 修改 PORT 后重启；或用 ss -tlnp | grep 3456（Linux）/ lsof -i :3456（macOS）找到占用进程。

Q：怎么验证装好了？
A：浏览器打开 http://localhost:3456，或终端执行 curl http://localhost:3456/api/health，返回 ok 即成功。

Q：开机没有自启？
A：macOS 检查「系统设置 → 通用 → 登录项」；Linux 检查 systemctl --user status lingxi-engine；重跑安装脚本可修复。

Q：怎么彻底卸载？
A：curl -fsSL https://www.lingxi-engine.com/public/install.sh | bash -s -- --uninstall，会清理程序文件、自启配置和菜单图标（保留用户数据）。

Q：WSL 里能跑吗？
A：能。按 Linux 方式安装，Windows 浏览器直接访问 localhost:3456 即可。