fingerprint-chromium Docker

将 adryfish/fingerprint-chromium 最新 Linux x86_64 安装包封装为 Docker 镜像。

容器始终通过 Xvfb 启动普通的有头 Chromium，不默认使用 --headless。上游仅处理了部分无头特征，因此不要把无头模式设为默认。

构建

需要 Docker、curl 和 jq：

./scripts/build.sh

指定上游 Chrome 版本或镜像名：

CHROME_VERSION=148.0.7778.215 ./scripts/build.sh my-registry/fingerprint-chromium

脚本从上游 GitHub Release 解析唯一的 Linux x86_64 压缩包，镜像 tag 使用完整 Chrome 版本。设置 PUSH=true 时，构建完成后推送镜像。

运行

docker run --rm \
  -p 127.0.0.1:9222:9222 \
  -v fingerprint-profile:/data \
  fingerprint-chromium:148.0.7778.215 \
  --fingerprint=1000 \
  about:blank

CDP 端口默认是 9222；不要直接暴露到公网。每个账号应使用独立的数据卷与 fingerprint seed。可通过 SCREEN_SIZE 调整虚拟显示器，例如 1600x900x24。

上游 Linux 包未携带 SUID sandbox，且普通 Docker runner 默认不允许 Chromium 使用 user namespace sandbox，因此入口使用 --no-sandbox 并以非 root 用户运行。镜像依赖容器边界隔离浏览器；访问不可信内容时应额外限制网络、文件挂载和容器权限。

自动发布

• Gitea Workflow：推送 git.ipao.vip/rogee/fingerprint-chromium:<chrome-version>，使用仓库 secret REGISTRY_TOKEN。
• GitHub Workflow：推送 ghcr.io/rogeecn/fingerprint-chromium:<chrome-version>，使用内置 GITHUB_TOKEN。

两个 Workflow 都会在 PR 中只构建验证，在 main 更新、每日定时任务或手动触发时构建并推送。仓库需要允许 Actions job token 写入 Packages。

验证

./tests/check.sh
docker run --rm fingerprint-chromium:148.0.7778.215 --version

本仓库只支持上游当前提供的 linux/amd64 安装包。