简介：小飞兔下载10.0是一款面向网页设计师、前端开发者及技术型数据采集人员的轻量级整站下载工具，专为快速备份、仿站分析与离线研究网站结构而设计，解决手动抓取耗时、资源链接失效、静态资源缺失等痛点。压缩包共25个文件，含20个核心DLL（如HtmlAgilityPack.dll用于HTML解析、RestSharp.dll支持API交互、LiteDB.dll实现本地数据存储）、3个可执行程序（含主程序与升级模块）、1个配置文件及1个使用说明HTML文档，整体仅1.19MB，即下即用，无依赖安装。已有1623人学习下载，体现其在中小规模网站复刻与教学演示场景中的实用认可。用户可直接运行获得图形化操作界面，完整获取目标站点的HTML、CSS、JS、图片等全部静态资源，并通过内置模型与处理器实现链接自动修正、资源路径重映射与目录结构还原，显著提升仿站效率与工程复用性。
1. 小飞兔下载10.0：不是“一键仿站”，而是整站资源抓取的可控流水线
你有没有遇到过这种场景：客户甩来一个老系统前端页面，要求三天内搭出结构一致的静态预览版；或者某高校实验室需要归档一批已关停但仍有学术价值的旧项目网站；又或者做安全审计时，得在离线环境下反复比对 HTML 模板与 JS 行为差异——这时候，你不会去手动右键另存为 200 个页面，也不会指望浏览器插件能扛住带登录态、动态路由、CDN 跳转和反爬 header 的混合站点。小飞兔下载10.0.zip 就是为这类「需完整保留原始资源拓扑关系」的整站下载任务而生的工具包。它不渲染页面，不执行 JS，不模拟用户行为，而是以 HTTP 协议层为锚点，构建一套可配置、可中断、可复现的资源拉取流水线。适合前端工程师做快速原型归档、渗透测试人员做离线资产分析、教育机构做网页教学素材沉淀。它不是黑盒“扒站神器”，而是一套你随时能看懂请求链路、改得了规则、压得住并发、查得清失败原因的下载基础设施。
2. 核心能力拆解：为什么是“整站下载器”而非“网页快照工具”
小飞兔下载10.0 的定位非常清晰：它解决的是「资源完整性 + 结构保真度 + 下载可控性」三者耦合的问题。市面上很多所谓“仿站工具”本质是浏览器自动化截图或 DOM 导出，丢失 CSS 引用路径、JS 模块依赖、图片原始尺寸、甚至<base>标签带来的相对路径偏移。而小飞兔走的是协议解析路线——它把目标站点当作一个 HTTP 资源图（Resource Graph）来遍历：从种子 URL 出发，解析 HTML 中所有href和src属性，提取绝对/相对链接，按预设规则归类（HTML / CSS / JS / IMG / FONT / VIDEO 等），再逐层递归抓取。整个过程不依赖浏览器内核，纯 HTTP Client 实现，因此体积轻、启动快、内存占用低，且天然支持代理链、自定义 User-Agent、Referer 绕过、Basic Auth 认证等企业级网络环境适配。
2.1 抓取策略设计：深度、广度与边界控制
小飞兔下载10.0 提供三类核心控制维度，全部通过配置文件config.yaml或命令行参数生效：
- 深度控制（
max_depth）：限制从种子页开始的递归层级。设为1仅抓取首页及首页直接引用资源；设为3则会进入二级链接页再抓其引用资源。注意：该值不等于“页面数量”，而取决于链接嵌套结构。 - 域名白名单（
allowed_domains）：关键安全阀。默认只允许同域资源被抓取；若需拉取 CDN 图片（如cdn.example.com），必须显式加入列表，否则自动丢弃。这是防止误触第三方站点的核心机制。 - 路径过滤（
exclude_patterns）：支持正则表达式。常见用法包括屏蔽/api/接口、/admin/后台、/track/埋点脚本、.php?动态参数页等非静态资源路径。
提示：
exclude_patterns的匹配对象是完整请求 URL，不是文件后缀。例如想排除所有带utm_source参数的链接，应写exclude_patterns: ["utm_source="]，而非["\.php$"]。
2.2 资源映射与本地化重写：让离线浏览真正可用
单纯下载文件还不够——浏览器离线打开index.html时，若其中<link href="/css/main.css">仍指向绝对路径，将 404。小飞兔内置资源重写引擎，在保存 HTML 文件前，会扫描并重写所有href/src属性，将其转换为相对于当前 HTML 文件的本地路径。例如：
原始 HTML 片段：
<link rel="stylesheet" href="/static/css/app.css"> <script src="https://cdn.example.com/lib/jquery.min.js"></script> <img src="/uploads/avatar.png" />重写后（假设保存至output/index.html）：
<link rel="stylesheet" href="static/css/app.css"> <!-- 注意：跨域 CDN 资源默认不下载，此处保持原样 --> <script src="https://cdn.example.com/lib/jquery.min.js"></script> <img src="uploads/avatar.png" />该重写逻辑由rewrite_rules配置驱动，支持自定义规则。例如强制将所有https://fonts.googleapis.com替换为本地fonts/目录（需提前下载字体文件）：
rewrite_rules: - pattern: "https://fonts.googleapis.com/.*" replacement: "fonts/google-fonts.css"2.3 并发与限速：平衡效率与服务友好性
小飞兔默认启用多线程下载（concurrent_requests: 5），但提供精细调控能力：
| 参数 | 默认值 | 说明 |
|---|---|---|
concurrent_requests | 5 | 同时发起的最大请求数。提高可加速，但过高易触发目标服务器限流 |
delay_per_request | 0.5 | 每次请求前的固定等待秒数（支持小数）。用于降低请求密度 |
random_delay_range | [0.1, 0.5] | 在固定延迟基础上叠加随机抖动，进一步规避简单频率检测 |
实际项目中，我一般会先用concurrent_requests: 1+delay_per_request: 1跑通全流程，确认无 403/429 错误后，再逐步提升并发至 3～4，并开启随机抖动。这比盲目调高并发更稳妥——毕竟一次被封 IP，后续调试成本远高于多花两分钟。
3. 快速上手：从解压到完成一次可控整站下载
小飞兔下载10.0 是一个免安装的绿色工具包，无需 Python 环境或 Node.js，Windows/macOS/Linux 均可直接运行。整个流程分四步：解压 → 配置 → 执行 → 验证。下面以下载某开源文档站点https://docs.example.org为例，全程可复制粘贴执行。
3.1 解压与目录结构认知
下载小飞兔下载10.0.zip后解压，得到标准目录结构：
xiaofeitu_10.0/ ├── xft.exe # Windows 主程序（无后缀为 macOS/Linux 可执行文件） ├── config.yaml # 全局配置模板（必须修改！） ├── seeds.txt # 种子 URL 列表（每行一个，支持注释#） ├── rules/ # 自定义规则目录（可选） │ └── rewrite_rules.yaml ├── output/ # 默认输出目录（首次运行前为空） └── logs/ # 运行日志（按日期分割）注意：
xft.exe是单文件二进制，无依赖库。不要试图用 Python 解包或反编译——它不是 Python 打包产物，而是 Rust 编译的 native 二进制，这也是它启动快、内存稳的根本原因。
3.2 修改配置：三处必改项
打开config.yaml，重点修改以下三项（其余保持默认即可）：
# === 必改项 1：种子入口 === seeds_file: "seeds.txt" # 指向种子文件，确保路径正确 # === 必改项 2：目标域名白名单 === allowed_domains: - "docs.example.org" # 替换为你的真实目标域名 - "cdn.example.org" # 若有 CDN，务必加进来 # === 必改项 3：输出路径与结构 === output_dir: "output/docs_example_org" # 建议用域名命名 output_dir，避免多次运行覆盖然后编辑seeds.txt，写入目标首页：
# 文档站点首页 https://docs.example.org/3.3 命令行执行与实时监控
打开终端（Windows 用 CMD/PowerShell，macOS/Linux 用 Terminal），进入解压目录，执行：
# Windows xft.exe --config config.yaml # macOS/Linux（需先加执行权限） chmod +x xft ./xft --config config.yaml程序启动后，控制台实时输出：
[INFO] 加载配置：config.yaml [INFO] 发现种子 URL：1 个 [INFO] 初始化下载器：并发=5，延迟=0.5s [INFO] 开始抓取：https://docs.example.org/ [PROGRESS] 已完成 12/87 个资源（HTML:3, CSS:5, JS:2, IMG:2） [SUCCESS] 已保存至 output/docs_example_org/逻辑说明：
--config参数指定配置文件路径，所有行为均从此读取。不加此参数将使用内置默认配置（仅抓取http://example.com，且无白名单保护，极其危险）。
3.4 验证下载结果：三步确认完整性
下载完成后，不要急着双击打开，先做结构验证：
检查 output 目录层级
正常应看到类似结构：output/docs_example_org/ ├── index.html ├── css/ │ └── main.css ├── js/ │ └── app.js └── images/ └── logo.png若只有
index.html且无子目录，大概率是allowed_domains未配对或exclude_patterns过于激进。用浏览器离线打开
index.html
双击打开，观察控制台（F12 → Console）是否有 404 报错。重点看Failed to load resource类错误，记录下缺失路径，反推是哪个资源未被下载或重写失败。比对原始页面与本地页面的
<head>区域
原始页面中<link href="/css/theme.css">应变为<link href="css/theme.css">；若仍是/css/theme.css，说明重写引擎未生效——检查config.yaml中rewrite_enabled: true是否为 true（默认开启，但曾有用户误改为 false）。
4. 避坑指南：五个真实翻车现场与血泪修复方案
小飞兔下载10.0 功能扎实，但因直面真实 Web 复杂性，新手极易在几个关键节点踩坑。以下是我在某高校实验室部署该工具时，A同学连续三次失败后总结出的高频问题清单，每条都附带可立即验证的修复动作。
4.1 现象：程序秒退，控制台无任何输出
原因：config.yaml文件编码为 UTF-8 with BOM（Windows 记事本默认保存格式），导致解析器读取失败，静默退出。
解决：用 VS Code / Notepad++ 等编辑器重新保存config.yaml，编码选UTF-8（无 BOM）。验证方法：用file config.yaml（Linux/macOS）或 PowerShell 中Get-Content config.yaml -Encoding UTF8查看首行是否含乱码。
4.2 现象：只下载了首页 HTML，CSS/JS 一个没下来
原因：allowed_domains配置错误。例如目标站为https://blog.example.net，却只写了example.net（缺少子域）。小飞兔严格匹配完整域名，example.net≠blog.example.net。
解决：在allowed_domains中明确列出所有涉及子域：
allowed_domains: - "blog.example.net" - "cdn.example.net" - "fonts.example.net"4.3 现象：下载的 HTML 中图片路径变成../images/xxx.jpg，但实际images/目录在同级
原因：目标页面使用<base href="/subpath/">标签，导致所有相对路径基准被重定向。小飞兔默认不处理<base>，需手动启用解析。
解决：在config.yaml中添加：
parse_base_tag: true # 默认 false，必须显式开启启用后，程序会先提取<base>的href值，再据此计算所有相对路径的真实目标。
4.4 现象：大量.html?ver=123页面被重复下载，占满磁盘
原因：exclude_patterns未覆盖带查询参数的 URL。小飞兔默认不忽略查询参数，/page.html?ver=123和/page.html被视为两个不同资源。
解决：在exclude_patterns中加入参数过滤规则：
exclude_patterns: - "\\?.*" # 排除所有带 ? 的 URL（最粗暴有效） # 或更精准：- "\\?ver=|\\?t=|\\?v=" # 只排除特定参数4.5 现象：登录后才能访问的页面始终 403，加了 Cookie 也不行
原因：小飞兔不支持会话维持（Session Persistence）。它每次请求都是无状态的，无法继承登录态。
解决：这不是 bug，而是设计取舍。正确做法是——
- 用浏览器登录目标站，F12 → Application → Cookies，复制所有
domain匹配目标站的 Cookie 字符串（如sessionid=abc123; csrftoken=xyz789）； - 在
config.yaml中配置：
default_headers: Cookie: "sessionid=abc123; csrftoken=xyz789"注意：Cookie 有效期有限，需定期更新。长期方案是导出登录态为
cookies.json，再用脚本注入，但小飞兔原生不支持该格式，需自行扩展。
5. 进阶技巧：用规则文件实现动态资源调度与条件下载
当面对大型站点（如含 500+ 页面的文档中心）或混合架构站点（部分静态、部分需 API 获取）时，硬编码在config.yaml的规则很快会失控。小飞兔下载10.0 支持外部规则文件机制，将「什么资源该下、怎么下、下到哪」的决策逻辑从主配置中剥离，实现真正的策略即代码（Policy as Code）。
5.1 规则文件结构：YAML 驱动的资源路由表
在rules/目录下新建route_rules.yaml，内容如下：
# route_rules.yaml routes: # 规则 1：所有 /docs/ 下的 HTML 页面，深度限制为 2，保存至 docs/ 子目录 - match: "^https://docs.example.org/docs/.*\\.html$" depth_limit: 2 output_subdir: "docs" # 规则 2：所有 /assets/ 下的图片，强制下载，忽略 referer 检查 - match: "^https://docs.example.org/assets/.*\\.(png|jpg|gif)$" force_download: true skip_referer_check: true # 规则 3：排除所有 /drafts/ 路径（草稿区，不对外公开） - match: "^https://docs.example.org/drafts/.*$" skip: true # 规则 4：对 /api/v1/docs/ 的 JSON 描述文件，单独保存为 markdown - match: "^https://docs.example.org/api/v1/docs/.*\\.json$" output_subdir: "api_docs" post_process: "json_to_md" # 调用内置转换器逻辑说明：
match使用正则表达式匹配完整 URL；depth_limit覆盖全局max_depth，实现局部深度控制；output_subdir指定该类资源的保存子目录，避免混杂；post_process是小飞兔内置的钩子，json_to_md会自动将 OpenAPI JSON 转为可读性更强的 Markdown 文档。
5.2 启用规则文件与优先级说明
要使route_rules.yaml生效，需在config.yaml中声明：
# config.yaml rule_files: - "rules/route_rules.yaml" # 可加载多个，按顺序合并，后加载的规则优先级更高规则匹配遵循「最长匹配优先」原则。例如一个 URL 同时匹配规则1和规则2，以正则表达式更具体的那个为准（/docs/guide.htmlvs/docs/.*\.html，前者更具体）。
5.3 自定义后处理：用 Python 脚本增强下载能力
小飞兔支持调用外部 Python 脚本进行下载后处理（Post-process），适用于需复杂逻辑的场景，如：
- 将 SVG 图标批量转为 PNG（适配老旧浏览器）
- 从 HTML 中提取 H1 标题生成
SUMMARY.md - 对 JS 文件做 Uglify 压缩
步骤如下：
- 编写脚本
scripts/svg_to_png.py：
#!/usr/bin/env python3 # svg_to_png.py import sys import os from cairosvg import svg2png input_path = sys.argv[1] output_path = sys.argv[2] # 将 .svg 替换为 .png if input_path.endswith('.svg'): png_path = output_path.replace('.svg', '.png') svg2png(url=input_path, write_to=png_path) print(f"[SVG2PNG] {input_path} → {png_path}")- 在
route_rules.yaml中引用：
- match: ".*\\.svg$" post_process: "scripts/svg_to_png.py"注意：脚本需有执行权限（
chmod +x scripts/svg_to_png.py），且cairosvg等依赖需在系统 Python 环境中安装。小飞兔仅负责调用，不管理 Python 环境。
5.4 验证规则有效性：用 dry-run 模式预演下载路径
在正式运行前，用--dry-run参数预览规则匹配结果，避免误删或错下：
xft.exe --config config.yaml --dry-run输出示例：
[DRYRUN] 匹配规则: routes[0] -> https://docs.example.org/docs/intro.html [DRYRUN] depth_limit=2, output_subdir="docs" [DRYRUN] 匹配规则: routes[1] -> https://docs.example.org/assets/logo.svg [DRYRUN] force_download=true, skip_referer_check=true [DRYRUN] 匹配规则: routes[3] -> https://docs.example.org/api/v1/docs/spec.json [DRYRUN] output_subdir="api_docs", post_process="json_to_md"这相当于给下载流水线装上了「沙箱模式」，所有网络请求被跳过，只做规则解析与路径规划。从那以后我每次新增规则，都强制走一遍--dry-run，再对比原始页面的<a href>和<img src>，确保没有漏网之鱼或误伤。希望帮到你。
本文还有配套的精品资源，点击获取
