anbox-playstore-installer常见问题排查overlay未启用、下载失败等10大报错解决方案【免费下载链接】anbox-playstore-installerInstall script that automates installation of googles playstore in anbox项目地址: https://gitcode.com/gh_mirrors/an/anbox-playstore-installeranbox-playstore-installer 是一款自动化安装脚本它能帮助 Linux 用户快速在 Anbox基于 LXC 容器、可在桌面运行 Android 应用的平台中一键安装 Google Play 商店。不过很多新手在实际运行时常常会遇到 overlay 未启用、依赖缺失、OpenGApps 下载失败等各种报错让人摸不着头脑。本文整理了 10 大高频报错及对应的解决方案从环境准备到一键重试帮你顺利完成 Anbox 安装 Google Play 的完整流程。一、anbox-playstore-installer 是做什么的简单来说它是一个把手动折腾变成一键完成的安装脚本。你只需要运行它脚本就会自动完成以下核心工作检查并启用 rootfs-overlayoverlay 文件系统解压 Anbox 自带的 android.img 系统镜像从 OpenGApps 下载并安装 Google Play 商店、Google 登录服务、Google 服务框架GMS等核心组件安装 Houdini 转译层让 ARM 架构应用能在 x86 的 Anbox 中运行修改系统特性文件与 build.prop最后自动重启 Anbox获取脚本的方式很简单git clone https://gitcode.com/gh_mirrors/an/anbox-playstore-installer二、安装前的依赖准备一张表搞定脚本在install-playstore.sh中会逐一检查 6 个依赖工具缺失任何一个都会直接报错并退出。提前装好它们可以避免一半以上的报错依赖作用安装命令lzip解压 OpenGApps 的 .tar.lz 文件sudo apt install lzipsquashfs-tools提供 mksquashfs / unsquashfs解压 android.imgsudo apt install squashfs-toolswget下载 OpenGApps 与 Houdini 文件sudo apt install wgetcurl查询 OpenGApps 最新版本号sudo apt install curlunzip解压 OpenGApps 压缩包sudo apt install unziptar解压 GMS 组件包sudo apt install tarUbuntu 用户可以一条命令全部装齐sudo apt update sudo apt install lzip squashfs-tools wget curl unzip tar三、10 大常见报错与解决方案报错 1Overlay not enabled —— overlay 文件系统未启用 ⚠️这是最经典、最高频的报错。脚本启用 overlay 后会检查 overlay 目录是否存在Snap 版路径为/var/snap/anbox/common/rootfs-overlayDeb 版为/var/lib/anbox/rootfs-overlay不存在就输出Overlay no enabled ! Please check error messages!并退出。Snap 版 Anbox 的解决方法——手动开启 overlay 并重启容器管理器sudo snap set anbox rootfs-overlay.enabletrue sudo snap restart anbox.container-managerDeb 版 Anbox 的解决方法——需要让 container-manager 以--use-rootfs-overlay参数启动脚本会自动写入/etc/systemd/system/anbox-container-manager.service.d/override.conf执行重载并重启服务sudo systemctl daemon-reload sudo systemctl restart anbox-container-manager.service 小提示脚本启用 overlay 后会固定等待 20 秒再检查目录。如果你的磁盘较慢可以稍等片刻后手动确认是否挂载成功ls /var/lib/anbox/rootfs-overlay报错 2lzip is not installedlzip 是解压 OpenGApps 组件.tar.lz格式的必需工具脚本无法跳过这一步。安装命令sudo apt install lzip安装完成后重新运行安装脚本即可。报错 3squashfs-tools is not installedsquashfs-tools 提供mksquashfs和unsquashfs两个命令用于解压 Anbox 的 android.img 镜像文件。缺少它会直接中断解压流程sudo apt install squashfs-tools报错 4wget / curl / unzip / tar is not installed脚本分别用 wget 下载文件、curl 查询 OpenGApps 版本号、unzip 解压压缩包、tar 解压 GMS 组件四个工具缺一不可。一次性补齐sudo apt install wget curl unzip tar报错 5OpenGApps 下载失败或卡住不动 脚本会从 OpenGApps 镜像下载open_gapps-x86_64-7.1-pico版本约几百 MB受网络环境影响很大常见表现为进度条卡住、超时报错。好在脚本内置了while循环重试 -c断点续传机制遇到失败会自动重试。排查建议确认网络能正常访问境外资源必要时为终端配置代理断网重连后再次运行脚本已下载的部分会自动续传如果反复失败可以先清理再重试见报错 10 的--clean用法也可以手动下载对应的 OpenGApps 压缩包放到脚本生成的anbox-work目录中脚本检测到文件存在后会直接使用报错 6Houdini 下载失败Houdini 是让 ARM 应用在 x86 设备上运行的关键转译组件脚本需要分别下载 32 位houdini_y和 64 位houdini_z两个文件下载源是 dl.android-x86.org 的镜像站偶尔会出现连接不稳定。解决方法与报错 5 类似多试几次、检查网络、配置代理。下载完成后脚本会解压到 overlay 目录的system/lib/arm和system/lib64/arm64下并自动注册 binfmt_misc 内核解析器。报错 7Please use BASH to start the script!脚本会检测当前运行环境是否为 bash通过ps -p $$判断用sh或其他 shell 直接运行就会报这个错。解决方法显式用 bash 运行bash install-playstore.sh不要用sh install-playstore.sh或直接./install-playstore.sh除非确定默认 shell 是 bash。报错 8Google Play 商店闪退或无法登录 安装完成后 Play 商店打不开、闪退或登录报错通常由以下几种原因导致GMS 组件权限不对脚本会把 Play 商店等 APK 复制到 overlay 目录并执行chown -R 100000:100000Snap 容器的 UID 映射。如果权限被重置会导致应用无法读取数据。可手动修复sudo chown -R 100000:100000 /var/snap/anbox/common/rootfs-overlay/system/priv-app系统时间不准确Google 服务校验时间失败会导致登录报错请确保系统时间同步sudo timedatectl set-ntp true残留旧数据可在 Anbox 设置中清除 Google Play 商店的数据后重试。报错 9ARM 应用提示不兼容或无法安装安装了 Play 商店却下载不了 ARM 应用通常是 Houdini 转译层没有完全生效。脚本会修改build.prop中的 CPU 指令集列表加入armeabi-v7a,armeabi,arm64-v8a并写入persist.sys.nativebridge1开启原生桥接。验证方法检查 binfmt_misc 是否注册了 ARM 解析器ls /proc/sys/fs/binfmt_misc/ | grep arm如果输出为空说明 Houdini 注册失败需要重新运行安装脚本或使用 install-houdini-only.sh 单独安装 Houdini。另外注意Snap 版 Anbox 需要额外确认 snap 的接口权限已正常授予。报错 10反复安装失败残留文件导致异常 多次安装失败后anbox-work目录里可能残留了损坏的下载文件、旧的解压目录导致脚本在解压或复制阶段反复报错。解决方法使用脚本自带的清理参数一键删除下载和临时文件bash install-playstore.sh --clean清理完成后重新运行安装脚本从零开始下载绝大多数玄学报错都能解决。四、两个实用的进阶参数除了基本的安装功能脚本还支持两个非常实用的参数参数功能示例--clean删除下载文件和临时目录彻底重来bash install-playstore.sh --clean--layout安装指定键盘布局支持 en_US、de_DE、ru_RU 等 17 种bash install-playstore.sh --layout en_US如果你在 Anbox 中打字出现键盘布局错乱的问题用--layout参数加上对应的语言代码重新运行一次脚本即可修复无需重装整个系统。五、总结anbox-playstore-installer 虽然做到了一键安装但受网络、依赖和系统环境的影响新手仍然可能遇到各种报错。回顾本文的 10 大解决方案核心思路可以归纳为三句话装全依赖——lzip、squashfs-tools、wget、curl、unzip、tar 一个都不能少先解决 overlay——大部分安装中断都源于 overlay 文件系统未启用不行就 --clean 重来——清理残留后重新安装能解决 90% 以上的疑难问题只要按照上面的排查顺序逐一检查相信你很快就能在 Anbox 中顺利用上 Google Play 商店。如果某个报错信息不在本文列表中也可以根据终端输出的错误提示对照install-playstore.sh脚本中的检查逻辑依赖检查在脚本前 96 行overlay 启用逻辑在 149-180 行自行定位问题所在。【免费下载链接】anbox-playstore-installerInstall script that automates installation of googles playstore in anbox项目地址: https://gitcode.com/gh_mirrors/an/anbox-playstore-installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
