
下面是一份覆盖 Windows、macOS、Linux、Android/iOS 的 Brave 浏览器下载、安装与“首次启动”常见问题排查指南。按需跳到你的平台和症状对应的部分操作。
一、下载与安装(各平台)
- 安全提示
- 只从官方渠道获取:brave.com/download
- 如官网受限,可用官方镜像/发布页:github.com/brave/brave-browser/releases(选择对应平台与架构)
- 核验文件:如提供 SHA256 校验值,下载后进行校验(Windows 可用 certutil -hashfile 文件路径 SHA256;macOS 使用 shasum -a 256 文件;Linux 使用 sha256sum 文件)
- Windows(10/11,64 位)
- 标准安装
- 访问 brave.com/download 下载 BraveBrowserSetup.exe,双击安装
- 首次运行位置(默认):%LocalAppData%\BraveSoftware\Brave-Browser\Application\brave.exe 或 %ProgramFiles%\BraveSoftware\Brave-Browser\Application\brave.exe
- 离线/企业安装
- 企业环境可使用 MSI 包(在 GitHub Releases 的 “MSI” 资源或企业页面),支持静默部署
- 常见注意
- Windows S 模式不支持非商店应用
- 如果被 SmartScreen 拦截:选择“更多信息”→“仍要运行”
- 老旧系统(如 7/8/8.1)已停止支持,请升级到 Windows 10/11
- macOS(10.15+,Intel 与 Apple Silicon)
- 标准安装
- 访问 brave.com/download 获取 Brave-Browser.dmg
- 打开 dmg,将 Brave Browser 拖入“应用程序”
- 首次启动如提示“无法验证开发者”:在“系统设置→隐私与安全”底部选择“仍要打开”,或在 Finder 中按住 Control 点击图标选择“打开”
- Apple Silicon
- Brave 提供原生支持,无需 Rosetta。若从第三方处获得 Intel 版导致性能或崩溃,请从官网重新下载
- Linux(64 位)
- 官方仓库(推荐)
- Debian/Ubuntu 及衍生:
- sudo apt install curl
- curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
- echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main" | sudo tee /etc/apt/sources.list.d/brave-browser-release.list
- sudo apt update && sudo apt install brave-browser
- Fedora/RHEL/CentOS:
- sudo dnf install dnf-plugins-core
- sudo dnf config-manager –add-repo https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
- sudo rpm –import https://brave-browser-rpm-release.s3.brave.com/brave-browser-release.gpg
- sudo dnf install brave-browser
- openSUSE:
- sudo zypper ar https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
- sudo rpm –import https://brave-browser-rpm-release.s3.brave.com/brave-browser-release.gpg
- sudo zypper ref && sudo zypper in brave-browser
- Debian/Ubuntu 及衍生:
- Snap/Flatpak
- Snap:sudo snap install brave
- Flatpak:flatpak install flathub com.brave.Browser
- 注:某些发行版下 Snap/Flatpak 的 GPU/沙箱行为与原生包略有差异,遇到图形或权限问题可尝试官方仓库版本
- Wayland/X11
- Wayland 环境可用 brave –ozone-platform=wayland
- 若有兼容问题,尝试 brave –ozone-platform=x11 或 brave –use-gl=swiftshader
- Android/iOS
- Android:Google Play 商店搜索 Brave Browser(Brave Software)
- iOS/iPadOS:App Store 搜索 Brave Browser(Brave Software)
二、首次启动与基础检查
- 第一次打开可能会出现引导页(默认浏览器、导入书签、同步设置)
- 检查版本:地址栏输入 brave://version 确认版本与安装路径
- 检查更新:brave://settings/help(需网络通畅与系统时间正确)
- 如导入设置后出现异常,先跳过导入,确认浏览器可稳定启动后再导入
三、首次启动常见问题排查(按症状)
- 无法下载或下载极慢
- 更换网络(有线/无线/手机热点),检查代理/VPN 是否干扰
- 临时关闭拦截下载的安全软件或网关过滤
- 使用 GitHub Releases 离线安装包,再断网安装
- 安装程序无法运行/报错
- Windows
- 以管理员运行安装程序
- 检查磁盘空间与临时目录权限(%TEMP%)
- 关闭第三方安全软件后重试
- 若提示“此应用无法在你的电脑上运行”:确认系统为 64 位、Windows 10/11;从官网重新下载
- macOS
- 通过“隐私与安全→仍要打开”,或在终端移除隔离属性:
xattr -dr com.apple.quarantine "/Applications/Brave Browser.app"
- 通过“隐私与安全→仍要打开”,或在终端移除隔离属性:
- Linux
- 确认仓库 key 与源配置正确,重新 sudo apt update / sudo dnf clean all
- SELinux/企业策略可能拦截安装,暂时将其设置为 permissive 测试(仅限排查),或联系管理员
- 安装完成但首次启动无响应/闪退
- 通用快速分诊
- 用新用户数据目录启动(不改动现有数据):
Windows:brave.exe –user-data-dir="%TEMP%\brave-test-profile"
macOS:/Applications/Brave\ Browser.app/Contents/MacOS/Brave\ Browser –user-data-dir="/tmp/brave-test-profile"
Linux:brave –user-data-dir=/tmp/brave-test-profile - 如果这样能正常启动,说明原配置/导入数据有问题。后续可备份并重建配置(见第 7 点)
- 用新用户数据目录启动(不改动现有数据):
- 禁用 GPU 启动(定位显卡/驱动问题)
- 在上述命令后追加:–disable-gpu –use-gl=swiftshader
- Linux Wayland 可加:–ozone-platform=x11 或 –ozone-platform=wayland
- 以隐身模式绕过会话恢复
- 追加:–incognito –no-first-run
- 首次启动黑屏/白屏/界面空白
- 更新显卡驱动(Windows 更新、厂商官网)
- 禁用硬件加速:能进设置时到 brave://settings/system 关闭“使用可用的硬件加速”,然后正常重启
- 仍空白时,使用命令行禁用 GPU 启动一次,进设置关闭硬件加速后再正常启动
- 被系统或安全软件拦截
- Windows SmartScreen/AppLocker/SRTP
- SmartScreen:点击“更多信息→仍要运行”
- 企业策略(AppLocker/SRP)需联系管理员放行签名:Brave Software, Inc.
- 杀软/EDR
- 暂时退出或为以下路径添加信任:
可执行:%LocalAppData%\BraveSoftware\Brave-Browser\Application
用户数据:%LocalAppData%\BraveSoftware\Brave-Browser\User Data
macOS 用户数据:/Library/Application Support/BraveSoftware/Brave-Browser/.config/BraveSoftware/Brave-Browser
Linux 用户数据:
- 暂时退出或为以下路径添加信任:
- 企业/学校环境限制
- 下载被拦截:让 IT 从企业通道获取 MSI/PKG,并通过软件中心分发
- 首次启动连接失败:检查代理自动配置 PAC、WPAD、证书注入;在系统网络设置正确填写代理
- 组策略阻止运行未知应用:将 Brave 列入允许清单
- 配置文件损坏/导入导致崩溃
- 备份并重建配置(彻底定位)
- 关闭 Brave 后备份以下目录,然后删除原目录再启动 Brave:
Windows:%LocalAppData%\BraveSoftware\Brave-Browser\User Data
macOS:/Library/Application Support/BraveSoftware/Brave-Browser//.config/BraveSoftware/Brave-Browser/
Linux: - 如果重建后可正常启动,说明旧配置有问题。可逐步迁回书签等数据(优先从账户或 HTML 文件导入)
- 关闭 Brave 后备份以下目录,然后删除原目录再启动 Brave:
- 注意:首次导入浏览器数据时可只选书签,确认稳定后再逐步导入历史、密码
- Linux 特有问题
- 内核用户命名空间未启用(影响沙箱)
- Ubuntu/Debian 可临时启用:sudo sysctl kernel.unprivileged_userns_clone=1
- 永久生效可写入 /etc/sysctl.d/ 配置文件
- Wayland 问题:尝试 brave –ozone-platform=wayland 或切到 X11
- SELinux/AppArmor 拦截:查看审计日志,添加策略例外或暂时 permissive 排查
- 缺失依赖/编解码:使用官方仓库安装通常自带必要依赖;如果媒体播放异常,更新系统并安装 chromium-codecs-ffmpeg-extra(Deb 系)
- 网络相关:能启动但打不开任何页面
- 系统时间和时区正确,否则 TLS 握手失败
- 检查代理/VPN 设置,关闭系统级抓包/过滤软件测试
- DNS 故障:临时切换到公共 DNS(如 1.1.1.1/8.8.8.8)
- 证书被拦截:公司网关注入证书时需将其导入系统信任区
- 窗口“看不见”或在屏幕外
- Windows:Alt+Space → M → 方向键移动窗口;或删除布局缓存
- 删除窗口状态缓存文件(关闭 Brave 后)
- Windows:User Data\Default\Preferences 内的窗口位置项
- macOS/Linux:同上路径对应文件中窗口坐标项(可先备份,直接删除 Preferences 文件由程序重建)
四、启用日志与收集崩溃信息
- 命令行日志
- 追加:–enable-logging=stderr –v=1
- Crash 报告位置(关闭浏览器后查看)
- Windows:%LocalAppData%\BraveSoftware\Brave-Browser\User Data\Crashpad\reports
- macOS:~/Library/Application Support/BraveSoftware/Brave-Browser/Crashpad/reports
- Linux:~/.config/BraveSoftware/Brave-Browser/Crashpad/reports
- 系统日志
- Windows:事件查看器(应用程序、系统)
- macOS:控制台.app
- Linux:journalctl -xe、dmesg(关注沙箱/显卡/SELinux)
五、干净卸载与重装
- 卸载
- Windows:设置→应用→Brave→卸载;随后手动删除 %LocalAppData%\BraveSoftware\Brave-Browser\
- macOS:将应用拖至废纸篓;删除 ~/Library/Application Support/BraveSoftware/Brave-Browser/
- Linux:使用包管理器卸载;并删除 ~/.config/BraveSoftware/Brave-Browser/
- 重装
- 重启系统后按“下载与安装”步骤重新安装
- 首次启动先不导入数据,确认稳定后再迁移
六、常见问答
- 32 位系统支持?Brave 目前主力发布为 64 位。建议升级到 64 位系统
- 如何确认更新正常?
- brave://settings/help 查看更新状态;Linux 使用包管理器更新
- 能否便携运行?
- 官方未提供 Windows 便携版。可用 –user-data-dir 指向自定义目录以“便携化”配置,仅作个人使用
- 与 Chrome 共存?
- 可共存,彼此数据独立。不要在两个浏览器间直接复制“用户数据”目录,以免不兼容
需要我根据你的操作系统与具体报错信息做一步一步的定制排查吗?把你的平台、症状、错误提示或日志简要发我,就能更精准定位。


