feat: 新增浏览器插件打码模式（extension）

Author: ws4934

Dockerfile.captcha

@@ -0,0 +1,52 @@
+FROM python:3.11-slim-bookworm
+
+# 安装运行依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+  fonts-liberation fonts-noto-cjk \
+  xvfb dbus dbus-x11 procps xdotool fluxbox \
+  libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \
+  libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 \
+  libpango-1.0-0 libcairo2 libasound2 libxshmfence1 \
+  && rm -rf /var/lib/apt/lists/*
+
+# 安装 CloakBrowser Python 包
+RUN pip install --no-cache-dir cloakbrowser
+
+# 预下载二进制（ensure_binary 会在最后验证运行，build 阶段无 X11 会 segfault，忽略即可）
+RUN mkdir -p /opt/cloakbrowser \
+  && HOME=/opt/cloakbrowser python -c "from cloakbrowser import ensure_binary; ensure_binary()" || true
+
+# 创建软链接（二进制已下载到 /opt/cloakbrowser/.cloakbrowser/*/chrome）
+RUN CLOAK_BIN=$(find /opt/cloakbrowser -name "chrome" -type f | head -1) \
+  && echo "CloakBrowser binary: $CLOAK_BIN" \
+  && ln -sf "$CLOAK_BIN" /usr/local/bin/cloakbrowser-bin \
+  && chmod -R a+rX /opt/cloakbrowser
+
+# 生成 machine-id
+RUN dbus-uuidgen > /etc/machine-id
+
+# 预创建 X11 socket 目录
+RUN mkdir -p /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix
+
+# 创建非 root 用户
+RUN groupadd -r chrome && useradd -r -g chrome -G audio,video chrome \
+  && mkdir -p /home/chrome/extension /home/chrome/data \
+  && chown -R chrome:chrome /home/chrome
+
+# 复制插件文件
+COPY chrome-extension/ /home/chrome/extension/
+RUN chown -R chrome:chrome /home/chrome/extension
+
+# 复制启动脚本
+COPY docker/entrypoint.captcha.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+ENV DISPLAY=:99
+ENV WS_URL=""
+ENV AUTH_KEY=""
+ENV PROXY_URL=""
+
+USER chrome
+WORKDIR /home/chrome
+
+ENTRYPOINT ["/entrypoint.sh"]

README.md

@@ -84,6 +84,24 @@ docker compose -f docker-compose.headed.yml logs -f
 - API 端口：`8000`
 - 进入管理后台后，将验证码方式设为 `browser` 或 `personal`
 
+#### Docker 浏览器插件打码模式（extension）
+
+> 支持在 PC 浏览器或安卓 Kiwi 浏览器中作为插件安装，也可直接通过 Docker 容器运行。
+> 容器内默认使用 [CloakBrowser](https://github.com/CloakHQ/CloakBrowser) + Xvfb ，插件自动连接到 `/ws/captcha`。
+> 默认启动 2 个 solver 实例，后端根据客户端状态自动进行负载均衡。
+
+```bash
+# 启动插件打码模式（首次启动需带 --build 编译指纹环境）
+docker compose -f docker-compose.captcha.yml up -d --build
+
+# 查看日志
+docker compose -f docker-compose.captcha.yml logs -f captcha-solver
+
+# 调整实例数量（如需 3 个并发处理容器）
+docker compose -f docker-compose.captcha.yml up -d --scale captcha-solver=3
+```
+
+- **安卓手机节点**：手机端可用 [Kiwi Browser](https://kiwibrowser.com/) 安装插件。必须在系统设置中允许 Kiwi **自启动**，并将省电策略设为**无限制**（极其关键，否则锁屏必然断网掉线）。
 ### 方式二：本地部署
 
 ```bash