AionUi 如何在 Android Termux 中用 Proot Ubuntu 运行 WebUI 模式并实现局域网远程访问 📅 发布时间:2026/9/10 5:35:27 👁 浏览次数: AionUi 如何在 Android Termux 中用 Proot Ubuntu 运行 WebUI 模式并实现局域网远程访问【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUiAionUi 的 Electron 桌面模式在 Android 上不受支持但可以用 Termux Proot Ubuntu 的方式在手机上运行 WebUI 模式在 Proot 环境里安装 AionUi 的 ARM64 包以--webui启动后在浏览器中访问再加--remote让同一局域网内的其他设备也能访问。本文按 docs/guides/webui.md 中 Android (Termux) 一节的官方步骤展开适用环境为 Android 7.0文档实测环境为 Android 14、Termux 0.118.0、AionUi 1.5.2 左右的最新 release。前提条件文档列出的前置要求如下安装前逐项确认Termux 需从 F-Droid 渠道安装文档明确说明 Google Play 上的版本较旧不推荐约 5 GB 空闲存储空间可用的网络连接下载 Proot rootfs 和 .deb 包都需要联网Android 7.0 及以上系统。安装 Proot Ubuntu 环境在 Termux 主 Shell 中更新包列表并安装proot-distro# Update package list pkg update -y # Install proot-distro pkg install proot-distro -y然后通过 Proot 安装 Ubuntu 并登录进去以下命令除特别注明外都在proot-distro login ubuntu进入的 Ubuntu 环境里执行# Install Ubuntu rootfs在 Termux 主 Shell 中执行 proot-distro install ubuntu # 登录 Ubuntu 环境此后进入 Ubuntu Shell proot-distro login ubuntu安装 AionUi 及其依赖在 Ubuntu 环境中先更新包列表再安装文档列出的必需依赖apt update apt install -y \ wget \ libgtk-3-0 \ libnss3 \ libasound2 \ libgbm1 \ libxshmfence1 \ ca-certificates文档还给出了一组可选的附加库遇到缺失再装apt install -y \ libx11-xcb1 \ libxcomposite1 \ libxdamage1 \ libxrandr2 \ libatk1.0-0 \ libcups2然后下载 ARM64 的 .deb 包并安装。命令中的VERSION需要替换为实际的 release tag文档以v1.5.2为例VERSIONv1.5.2 wget https://github.com/iOfficeAI/AionUi/releases/download/$VERSION/AionUi_$VERSION_arm64.deb # 安装包 apt install -y ./AionUi_*.deb # 验证安装应输出可执行文件路径 which AionUiwhich AionUi能返回路径说明安装到位如果后续启动时报权限错误见文末排查部分。启动 WebUI 并在本机浏览器访问在 Ubuntu 环境中启动AionUi --no-sandbox --webui文档特别强调--no-sandbox标志在 Termux/proot 环境中是必需的不能省略。启动后在 Android 的浏览器中打开http://localhost:25808文档说明 Termux 场景下默认端口为 25808如果终端显示使用了其他端口以终端实际输出为准。可以忽略的启动告警终端可能出现如下告警文档原文示例均非致命WebUI 模式下与 D-Bus、X server 相关可忽略[WARNING] Could not connect to session bus: Using X11 for dbus-daemon autolaunch was disabled at compile time [ERROR] Failed to connect to the bus: Failed to connect to socket: No such file or directory [WARNING] Multiple instances of the app detected, but not running on display server结果判断文档给出的判据是终端出现 Server started 消息且浏览器能打开上面的地址即启动成功。开启局域网远程访问要让手机之外的其他设备同一局域网内的电脑、平板等访问加上--remote标志启动AionUi --no-sandbox --webui --remote然后获取 Android 设备的 IP 地址——这一步要在 Termux 主 ShellProot 之外执行# 以下两者任选其一查看 inet 地址 ifconfig ip addr show之后其他设备浏览器访问http://YOUR_ANDROID_IP:25808YOUR_ANDROID_IP替换为上一步查到的手机 IP。文档的通用 Remote Access 部分同时提醒--remote会开放网络访问只在可信网络中使用生产用途应考虑认证和防火墙规则。可选启动脚本与一行命令文档提供两个便捷方式可按需选用在 Ubuntu 环境内创建启动脚本cat ~/start-aionui.sh EOF #!/bin/bash echo Starting AionUi WebUI... AionUi --no-sandbox --webui --remote EOF chmod x ~/start-aionui.sh # 之后随时运行 ./start-aionui.sh或者在 Termux 主 Shell 里直接用一行命令启动并带远程访问proot-distro login ubuntu -- bash -c AionUi --no-sandbox --webui --remote常见问题排查现象文档给出的处理方式端口 25808 被占用指定其他端口启动AionUi --no-sandbox --webui --port 8080Permission Denied 报错确认二进制有执行权限chmod x /opt/AionUi/aionui内存不足Out of MemoryAionUi 需要足够内存遇到内存问题时关闭其他应用浏览器无法访问先确认终端有 Server started 消息换 Termux 自带浏览器或 Chrome 重试清除浏览器缓存文档给出的性能建议均为 Termux 场景使用轻量浏览器Chrome 或 Firefox Focus、关闭后台应用释放内存、远程访问优先用 WiFi 而非移动数据、保持设备充电状态。限制与实测环境Android 上只支持 WebUI 模式Electron 桌面模式不支持文档标注的实测组合Android 14、Termux 0.118.0、AionUi 1.5.2latest release、Proot-distro Ubuntulatest。不同 Android 版本或 Termux 版本下如遇问题按文档指引先核对 docs/guides/webui.md 的 Troubleshooting 部分再查阅其引用的社区教程与 issue 记录。【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考