凯迪浏览器

安装与部署指南

从单机安装到批量部署，以及这一路上最容易出问题的几个点。

本页内容
系统要求 安装 安装程序做了什么 卸载 便携模式 多实例与目录规划 自动化接入 排错

系统要求

操作系统Windows 10 x64 或更高。Chromium 146 已不支持 Windows 7 / 8 / 8.1
架构仅 64 位。32 位系统会被安装程序明确拒绝，不会装出一个跑不起来的浏览器
权限安装需要管理员权限（要写入 Program Files 与 HKLM 注册表）
磁盘安装后约 383.6 MB（70 个文件）。安装包本身 120.6 MB，安装过程中两者会短暂同时存在
界面语言简体中文 / 繁体中文 / English (US) / English (GB)
关于语言。只保留四种语言包以缩小体积。若系统语言不在这四种里，界面会回退到 English (US)。 系统语言是 zh-HK / zh-MO 时会落到繁体中文 —— 上游 Chromium 在 Windows 平台本来就不构建 zh-HK 语言包。 需要其他语言，可从构建产物 out/Release/locales/ 把对应的 .pak 拷进安装目录的 locales/。

安装

双击安装包，依次是：欢迎 → 选择安装目录 → 安装 → 完成。

图形安装

  • 默认目录 C:\Program Files\kaidibrowser，可改成任意路径
  • 已经装过的话，重装会沿用上次选择的目录
  • 自动创建桌面快捷方式与开始菜单项
  • 完成页默认不自动启动浏览器 —— 建议先把 fp.json 放好

静默安装

批量部署
kaidibrowser-Setup.exe /S /D=D:\Apps\kaidibrowser
/D= 必须是最后一个参数，并且不能加引号。

从官方渠道下载

安装包与便携版统一从官网 liulanqi.kaidi.cc 提供的地址下载：安装版 http://t.kaidi.cc/down/Chrome/kaidibrowser-Setup.exe，便携版 http://t.kaidi.cc/down/Chrome/kaidibrowser146.7z。 如需校验完整性，可在下载后自行计算 SHA256：
命令提示符
certutil -hashfile kaidibrowser-Setup.exe SHA256

安装程序做了什么

文件与快捷方式

注册表

注册表一律使用英文名 kaidibrowser；给用户看的中文名只出现在 DisplayName 里。 两项都写在 64 位注册表视图，不会被重定向到 WOW6432Node。

注册表布局
HKLM\Software\kaidibrowser
    InstallDir      = <安装目录>
    Version         = v0.1.27.104
    DisplayName     = 凯迪浏览器

HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\kaidibrowser
    DisplayName            = 凯迪浏览器        ; 控制面板里显示的名字
    DisplayVersion         = v0.1.27.104
    Publisher              = kaidibrowser
    InstallLocation        = <安装目录>
    DisplayIcon            = <安装目录>\chrome.exe,0
    UninstallString        = "<安装目录>\uninst.exe"
    QuietUninstallString   = "<安装目录>\uninst.exe" /S
    NoModify               = 1                 ; 不显示"修改"
    NoRepair               = 1                 ; 不显示"修复"
    EstimatedSize          = 433656 (KB)

卸载

三个入口任意一个即可，都是一键完成。

控制面板

「程序和功能」或用 Windows 10 的「应用和功能」列表，找到「凯迪浏览器」，点卸载。

开始菜单

开始菜单 → 凯迪浏览器 → 「卸载 凯迪浏览器」。

静默卸载

命令
<安装目录>\uninst.exe /S

卸载会清掉什么

卸载不会动什么

不会删除用户数据目录：%LOCALAPPDATA%\Chromium\User Data。 那里存着浏览记录、Cookie 以及你自己写进去的指纹配置。删不删应该由你决定，卸载程序不替你做这个决定。 需要彻底清除时请手动删除该目录。

两个需要知道的行为

浏览器正在运行时会拒绝安装/卸载，并提示先完全退出。这是有意的保护： 运行中的 chrome.exe 被系统锁定，硬删会留下「注册表没了、目录还在、快捷方式没了、exe 还在」的半截状态， 既用不了也装不回去。
静默模式（/S）下这条提示不弹窗，而是直接中止，且退出码仍为 0。 静默脚本若需要确认结果，请以「程序是否还在」为准，不要只看退出码。

便携模式

不安装也能用。官网提供的便携版 kaidibrowser146.7z 解压到任意位置即可运行； 安装版目录内的程序文件同样是绿色版，直接拷贝也能跑。

把数据也留在程序目录里
chrome.exe --user-data-dir=".\_profile"

多实例与目录规划

一个数据目录 = 一个实例。实例之间的 Cookie、缓存、扩展和指纹完全隔离。

推荐目录结构
D:\bots\
  p001\
    profiles\
      p001\
        fp.json          <-- 这个实例的指纹配置
    Cache\  Cookies\  ...  <-- 浏览器自己生成
  p002\
    profiles\
      p002\
        fp.json
启动 p001
chrome.exe ^
  --user-data-dir=D:\bots\p001 ^
  --fingerprint-profile=p001 ^
  --no-first-run --no-default-browser-check

自动化接入

用 CDP（Chrome DevTools Protocol）接管，Playwright / Puppeteer / 裸协议都行。

开放调试端口
chrome.exe ^
  --user-data-dir=D:\bots\p001 ^
  --fingerprint-profile=p001 ^
  --remote-debugging-port=9222 ^
  --no-first-run --no-default-browser-check ^
  about:blank
探活
curl -s -o NUL -w "%{http_code}" http://127.0.0.1:9222/json/version

排错

现象原因处理
双击没反应 / 启动后闪退AppContainer 访问控制条目（ACE）缺失从安装包重新安装，或从完整分发包重新解压；不要用会保留源 ACL 的复制方式搬运目录
以管理员身份运行报沙箱错误受限环境下进程沙箱起不来加 --no-sandbox（普通用户账号不需要）
安装时提示程序正在运行浏览器未完全退出退出所有窗口与后台进程后重试
卸载后仍有残留在磁盘上个别文件被占用，已登记重启后删除重启一次系统即可；用户数据目录是刻意保留的
指纹完全不生效启动参数没带，或配置校验未通过加 --fingerprint-debug 看日志；配置问题见配置参考页的常见问题
界面语言不是我想要的当前系统语言不在内置的四种里把对应 .pak 放进安装目录的 locales/，或用启动参数指定语言
关于用途。本浏览器的指纹控制能力面向隐私保护、多账号环境隔离、自动化测试与风控自检等正当场景。 使用者应自行遵守所在地区的法律法规与目标网站的服务条款，不得用于欺诈、绕过访问控制、批量注册或其他违法用途。