FirefoxOptions
返回: FirefoxOptionsFirefoxOptions()创建启动配置对象，传给 FirefoxPage(opts) 使用。
常见坑
- 配置对象本身不启动浏览器，需配合 FirefoxPage 使用。
相关示例
启动配置
RuyiPage FirefoxOptions
FirefoxOptions 是启动配置的总入口。浏览器路径、用户目录、代理、fpfile、隐私模式等所有配置都从这里设置。
核心 API
opts.set_browser_path
返回: Noneopts.set_browser_path(path)指定 Firefox 可执行文件路径。使用指纹浏览器时必须设置。
参数说明
| 参数 | 说明 |
|---|---|
| path | Firefox 或指纹浏览器的绝对路径。 |
常见坑
- 路径错误会直接导致启动失败。
相关示例
opts.set_user_dir
返回: Noneopts.set_user_dir(path)指定用户数据目录（profile）。复用登录态、Cookie 和扩展。
参数说明
| 参数 | 说明 |
|---|---|
| path | 目录路径，不存在会自动创建。 |
常见坑
- 不设置则用临时目录，关闭后数据丢失。
相关示例
opts.set_fpfile
返回: Noneopts.set_fpfile(path)加载指纹配置文件。含代理认证、浏览器指纹等底层配置。
参数说明
| 参数 | 说明 |
|---|---|
| path | fpfile 文件路径，格式为 key:value 逐行。 |
常见坑
- fpfile 由指纹浏览器生成或手动编写。
相关示例
opts.set_proxy
返回: Noneopts.set_proxy("http://host:port")设置 HTTP 代理地址。
参数说明
| 参数 | 说明 |
|---|---|
| proxy | 代理地址，格式 http://host:port。 |
常见坑
- 代理认证信息建议放在 fpfile 中。
相关示例
opts.headless
返回: Noneopts.headless(True)开启无界面模式。
参数说明
| 参数 | 说明 |
|---|---|
| enable | True 无界面 / False 有界面。 |
常见坑
- 无头模式下部分站点行为与有界面不同。
相关示例
opts.private_mode
返回: Noneopts.private_mode(True)开启隐私浏览模式。
参数说明
| 参数 | 说明 |
|---|---|
| enable | True 开启。 |
常见坑
- 隐私模式 ≠ 临时 profile，仍可能使用 user_dir 中的数据。
相关示例
快速上手
from ruyipage import FirefoxOptions, FirefoxPage
opts = FirefoxOptions()
opts.set_browser_path(r"C:\Program Files\Mozilla Firefox\firefox.exe")
opts.set_user_dir(r"D:\ruyipage_userdir")
page = FirefoxPage(opts)
page.get("https://www.example.com")
page.quit()from ruyipage import FirefoxOptions, FirefoxPage
opts = FirefoxOptions()
opts.set_browser_path(r"C:\Firefox\firefox.exe")
opts.set_fpfile(r"C:\Firefox\profile1.txt")
opts.set_proxy("http://your-proxy-host:8080")
page = FirefoxPage(opts)
page.get("https://www.browserscan.net/zh")
page.quit()什么时候用 FirefoxOptions
| 场景 | 用 launch() | 用 FirefoxOptions |
|---|---|---|
| 简单测试 | 推荐 | 不需要 |
| 指定浏览器路径 | browser_path 参数 | set_browser_path() |
| 复用登录态 | user_dir 参数 | set_user_dir() |
| 指纹浏览器 | ❌ 不支持 fpfile | set_fpfile() ✅ |
| 代理 | ❌ 不支持 | set_proxy() ✅ |
| 隐私模式 | private=True | private_mode(True) |
使用建议
- 新手先用 launch() 快速跑通，需要高级配置时再切换到 FirefoxOptions。
- fpfile、proxy、指纹浏览器三件套组合使用时，必须用 FirefoxOptions。
- user_dir 是长期目录时，注意管理生命周期，避免历史状态污染测试。
相关示例源码
3 个示例
▶ 点击展开
隐私模式快速开始
quickstart_private_mode.py
展示 Firefox 私密浏览模式的两种启动方式，以及它与临时 profile 的区别。
- 通过 FirefoxOptions 开启私密浏览
- 通过 launch(private=True) 快速启动
- 理解私密模式与临时用户目录的区别
- 验证私密模式下的页面访问流程
指纹浏览器快速开始
quickstart_fingerprint_browser.py
演示如何把 Firefox 指纹浏览器、指纹文件、地理位置、语言和请求头一起接入 RuyiPage。
GitHub 仓库
查看仓库源码
FirefoxOptionsopts.set_browser_pathopts.set_fpfilepage.emulation.set_geolocationpage.emulation.set_timezonepage.emulation.set_localepage.network.set_extra_headerspage.emulation.set_screen_size
- 加载 Firefox 指纹浏览器可执行文件
- 通过 fpfile 复用指纹配置
- 叠加地理位置、时区和语言环境
- 为请求增加语言请求头
- 访问指纹检测站点验证效果
代理认证与 IP 信息验证
examples/38_proxy_auth_ipinfo.py
展示通过 fpfile 与代理配置协作，让业务脚本只保留最小代理入口。
- 配置 HTTP 代理地址
- 通过 fpfile 承载代理认证账号密码
- 访问 ipinfo 验证出口 IP
- 降低业务脚本中明文认证信息暴露