manus在linux系统上完全兼容，官方已在银河麒麟v10等主流发行版完成全链路测试并修复全部已知问题；需内核≥5.4.0、安装libglib2.0-0等图形依赖、设置playwright_download_host镜像源，并通过chromium --headless验证。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Manus在Linux系统上完全兼容，官方已在银河麒麟V10等主流Linux发行版完成全链路兼容性测试并修复全部已知问题。

验证Linux兼容性前提

确认你的系统内核版本不低于5.4.0（如dev-fj-srv所用的5.4.0-81-generic），这是OpenManus运行的最低要求。低于该版本可能无法加载Chromium内核或触发Pydantic 2.10+的类型校验异常。

执行uname -r命令查看当前内核版本，若输出结果为4.15.0-210-generic或更低，请先升级内核再继续部署。

部署时必须启用的Linux特性

① 确保系统已安装libglib2.0-0、libnss3、libatk1.0-0、libxss1等基础图形依赖库。缺失任一包会导致Playwright启动Chromium失败，报错信息通常为Failed to load libatk-1.0.so.0。

② 执行playwright install chromium前，必须设置国内镜像源：
export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

【未设置该环境变量将直接触发超时失败，且错误提示不明确】

③ Chromium安装完成后，需手动验证是否可静默运行：
chromium --headless --disable-gpu --dump-dom https://baidu.com | head -n 5
若返回HTML片段则说明内核就绪；若报cannot open shared object file，请按步骤①补全系统库。

规避Ubuntu/Debian桌面环境冲突

方法一：使用非GUI用户部署
创建专用部署用户（如openmanus）并禁用其桌面会话：
sudo adduser --disabled-login openmanus
切换后所有操作在纯终端下进行，彻底避开.profile中Pyenv等工具引发的GUI登录崩溃问题。

方法二：隔离X11会话
在部署用户home目录下新建.xsessionrc文件，写入：
export DISPLAY=
该行强制屏蔽图形界面接管，避免OpenManus后台进程与GNOME/KDE争抢显示资源。