Damru 安卓原生隐身浏览器自动化框架

这个 Agent 能做什么，适合哪些场景？

Damru 是面向 Android 的开源隐身浏览器自动化框架，核心思路是不在网页里注入任何 JavaScript，而是在 Docker 中启动完整 Android 系统（Redroid），再用 Playwright 经 Chrome DevTools Protocol 驱动 Chrome。它通过 resetprop 修改系统属性、patch Vulkan/GLES 驱动 .so、用 libfakemem.so 拦截 sysinfo 系统调用、调整 wm size/density 与 iptables 规则，在 OS、二进制和 CDP 协议层伪造设备指纹。框架内置 155 个真实 Android 设备档案、Chrome/WebView 版本轮换与约 184 种 TLS/JA3 指纹随机化，并提供 AsyncDamru、Damru、DamruPool 等 Python 接口以及 python -m damru 命令行。运行环境依赖 Ubuntu 24.04 或带专用内核的 WSL2、Docker 和 binderfs 内核支持，官方明确不支持物理手机，项目本身仍处于 Beta 阶段。

运行时 Damru 先通过 ADB 连接到 Redroid 容器，根据选定设备档案执行 resetprop 修改 ro.product.model、ro.build.fingerprint 等系统属性，并用 wm size/wm density 设定屏幕尺寸与 DPI。随后它 patch Vulkan/GLES 驱动二进制以伪装 GPU、通过 LD_PRELOAD 加载 libfakemem.so 拦截 sysinfo/sysconf 伪造内存与 CPU、用 iptables 屏蔽 WebRTC 内网 IP 泄漏与 IPv6，并借助 CDP 的 Emulation.setHardwareConcurrencyOverride 与 Target.setAutoAttach 把硬件覆盖下发到主线程和各类 Worker。Chrome 侧会改写 Preferences 与启动参数、随机化 TLS 密码套件、禁用 DoH 以走代理 DNS，并可按代理出口自动匹配时区与 locale。最终对外暴露 AsyncDamru/Damru 的 new_page 等 Playwright 风格页面对象，以及 python -m damru 的 setup、check preflight、force-profile、stealth-open-url、benchmark、screenshot、record、ui 等命令。

1. 需要在大规模抓取中绕过 Cloudflare Turnstile、DataDome 等 WAF 的数据团队，用真实 Android 指纹降低封禁率。
2. 做反爬与指纹识别研究的工程师，用 155 个设备档案和可切换的 TLS/JA3 配置对照测试检测逻辑。
3. 要在真实 Android 环境而非桌面模拟器上做移动端 QA 的测试团队，通过 Playwright API 编写端到端脚本。
4. 需要并发多个独立 Android 身份的自动化团队，用 DamruPool 在两到三台容器间编排任务。
5. 希望用图形界面观察或手动操作浏览器的研究者，通过 python -m damru ui 或 scrcpy 查看工作进程。

如何安装或部署这个 Agent？

先准备 Ubuntu 24.04 主机（或启用 Damru 捆绑内核的 WSL2），安装 ADB 与 Python 虚拟环境，再用 pip 从 Git 安装并执行初始化命令：

sudo apt update && sudo apt upgrade -y
sudo apt install adb wget curl git jq python3-venv -y
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip setuptools wheel
pip install git+https://github.com/akwin1234/damru.git

接着安装依赖与预烘焙 Redroid 镜像，并做环境自检：

python -m damru install-deps -y
python -m damru install-image
python -m damru check-env

镜像默认从 https://dl.damru.dev/assets/damru-baked.tar.gz 获取；若本机没有本地 tarball，可改用 python -m damru install-image --download。只有需要自行烘焙 raw Redroid 时才需要另外下载约 3.3 GB 的 chrome-apks.zip（python -m damru install-apks --download）。

如何使用这个 Agent？

最小可运行脚本通过 AsyncDamru 打开页面：

from damru import AsyncDamru

async def main():
    async with AsyncDamru(chrome_apk="/home/damru/chrome-apks/145.0.7632.75") as browser:
        page = await browser.new_page()
        await page.goto("https://example.com")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

命令行侧先做只读预检，再启动工作进程或用 stealth 方式打开 URL：

python -m damru check preflight --json
python -m damru force-profile --serial 127.0.0.1:5600 --device pixel_8_pro
python -m damru stealth-open-url --serial 127.0.0.1:5600 --url https://example.com
python -m damru ui

代理、时区、locale 在 damru/config.py 中配置；未设置 TIMEZONE/LOCALE 时会根据代理出口自动推断。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题