普通启动
先跑 01_quickstart.py 或 quickstart_bing_search.py,最快看到成功结果。
这一页先解决安装、验证和启动前准备,然后再引导你按普通 Firefox、指纹浏览器、隐私模式或接管浏览器四条路径继续走。
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows、Linux、macOS |
| Python | >= 3.9 |
| 浏览器 | Firefox |
| 协议路线 | WebDriver BiDi |
pip install ruyiPagepython -c "import ruyipage; print(ruyipage.__version__)"pip install ruyiPage --upgrade先跑 01_quickstart.py 或 quickstart_bing_search.py,最快看到成功结果。
适合一次性会话、减少历史痕迹和验证私密浏览流程。
适合高风控站点,可结合 fpfile、时区、语言和代理配置。
适合浏览器已被手工打开,或调试端口并不固定的场景。
最短可运行的 hello-world 级别示例,适合验证环境和建立第一层心智模型。
源码文件:app/content/ruyipage_examples/01_quickstart.py · 仓库:01_quickstart.py
# =============================
# RuyiPage 示例注释版
# 标题: 一步上手:最少代码完成访问与读取
# 说明: 最短可运行的 hello-world 级别示例,适合验证环境和建立第一层心智模型。
# 你会学到:
# 1. 用 launch() 启动 Firefox
# 2. 访问网页并等待页面稳定
# 3. 读取标题和 H1 文本
# 4. 演示最短退出流程
# 相关 API: launch, page.get, page.wait, page.title, page.ele, ele.text, page.quit
# =============================
# -*- coding: utf-8 -*-
"""
示例01: 一步上手
面向新手:最少代码完成一次页面访问与元素交互。
"""
import io
import sys
if sys.platform == "win32":
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8")
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8")
from ruyipage import launch
def quickstart_demo():
print("=" * 60)
print("示例01: 一步上手")
print("=" * 60)
page = launch(headless=False)
try:
page.get("https://example.com")
page.wait(1)
print(f"标题: {page.title}")
h1 = page.ele("tag:h1")
print(f"H1文本: {h1.text}")
print("\n✓ 快速上手完成")
finally:
page.wait(1)
page.quit()
if __name__ == "__main__":
quickstart_demo()
展示 Firefox 私密浏览模式的两种启动方式,以及它与临时 profile 的区别。
演示如何把 Firefox 指纹浏览器、指纹文件、地理位置、语言和请求头一起接入 RuyiPage。
适合 Firefox、ADS、FlowerBrowser 等已打开实例的自动探测接管场景。