# PeerWeb P2P 分发与内容寻址的工程实现细节 > 深入分析 PeerWeb 如何利用 WebTorrent 实现去中心化网站托管，重点剖析其 P2P 分发机制、内容寻址系统和客户端资源加载的工程实现。 ## 元数据 - 路径: /posts/2026/01/31/peerweb-p2p-content-addressing-resource-loading/ - 发布时间: 2026-01-31T18:30:41+08:00 - 分类: [web](/categories/web/) - 站点: https://blog.hotdry.top ## 正文 PeerWeb 是一个基于 WebTorrent 协议的去中心化网站托管方案，其核心设计理念是将传统的客户端—服务器架构转换为点对点的分布式网络。在传统 Web 托管模式中，网站数据存储在中心化服务器上，用户通过 DNS 解析和 HTTP 请求获取内容；而 PeerWeb 则将网站文件打包成 torrent 种子，通过 WebRTC 在浏览器之间直接传输数据。这种架构从根本上消除了对中心化托管服务的依赖，使得网站能够在全球分布的 Peer 节点上持久存活。 ## P2P 分发机制的核心实现 PeerWeb 的 P2P 分发机制建立在 WebTorrent 协议之上，整个流程始于用户拖拽上传网站文件夹的那一刻。当用户将包含 `index.html` 的文件夹拖入上传区域后，系统首先会遍历所有文件并检查必要的文件是否存在。如果未检测到 `index.html`，系统会提示用户确认是否继续，因为缺少入口文件将导致网站无法正常加载。这个设计体现了工程实践中对边界条件的严格把控。 在文件验证通过后，系统调用 `client.seed()` 方法创建 torrent 种子。值得注意的是，种子创建时采用动态分块大小策略：根据文件总体积自动选择 16KB、32KB、256KB 或 1MB 的分块大小。这种自适应的分块策略能够平衡下载效率和传输开销——对于小型网站使用较小的分块可以提高并行度，而大型网站使用较大的分块则能减少元数据开销。 种子创建完成后，系统会自动连接 7 个 WebRTC 追踪器进行节点发现。这些追踪器包括 `wss://tracker.btorrent.xyz`、`wss://tracker.openwebtorrent.com` 等，分布在不同的域名上以提高去中心化程度。追踪器负责在请求下载的客户端和正在做种的节点之间牵线搭桥，建立 WebRTC 连接。一旦连接建立，网站数据便开始在节点之间流动，无需经过任何中心化服务器的中转。 在做种期间，系统持续跟踪已上传的数据量和当前连接的节点数。当新用户通过 `?orc={hash}` 参数访问网站时，WebTorrent 客户端会向追踪器请求拥有该种子的节点列表，然后逐一下载文件的各个分块。下载过程中，系统采用选择性下载策略：优先获取 `index.html` 和 CSS、JS 等关键资源，仅当这些核心文件达到 90% 以上的下载进度时才触发页面渲染。这种渐进式加载机制确保用户能够尽快看到页面内容，同时后台继续下载次要资源。 ## 内容寻址系统的设计哲学 PeerWeb 的内容寻址系统是其去中心化架构的技术基石。与传统网站使用易变的域名和 IP 地址不同，PeerWeb 完全基于内容本身的身份标识来定位资源。这个标识就是 torrent 种子的 infoHash——一个由 WebTorrent 根据种子内部文件结构计算出的 40 字符十六进制字符串。由于 SHA-1 算法的特性，即使种子中仅有一个字节发生改变，生成的 hash 值也会完全不同，这确保了内容标识的不可篡改性。 系统在处理用户输入的 hash 时，会首先调用 `sanitizeHash()` 方法进行严格过滤。该方法仅保留十六进制字符（a-fA-F0-9），并自动转换为小写，任何非法的字符都会被剔除。这一步骤不仅是安全防护，也是对用户输入的规范化处理，避免因大小写不一致或额外字符导致的解析错误。hash 长度必须恰好为 40 个字符，系统会拒绝不符合格式要求的输入，并给出清晰的错误提示。 网站链接的生成遵循简洁原则：`https://peerweb.lol/?orc={hash}`。用户只需分享这个链接，访问者便能通过 hash 值从网络中的任意节点下载完整的网站内容。在内部资源路由层面，系统将 URL 转换为 `/peerweb-site/{hash}/{file-path}` 的虚拟路径格式。例如，当网页中的 `