PairDrop 安装和配置指南

1. 项目基础介绍和主要编程语言

PairDrop 是一个跨平台的文件传输工具，灵感来源于 Apple 的 AirDrop。它允许用户在同一局域网内或通过互联网轻松传输文件，无需设置或注册。PairDrop 的主要编程语言是 JavaScript，前端使用 HTML5 和 CSS3，后端使用 Node.js。

2. 项目使用的关键技术和框架

PairDrop 使用了多种现代技术和框架来实现其功能：

• WebRTC：用于点对点文件传输。
• WebSockets：用于实时通信。
• Node.js：作为后端运行环境。
• Progressive Web App (PWA)：提供统一的移动和桌面体验。
• IndexedDB：用于本地存储。
• zip.js：用于处理文件压缩。
• cyrb53：用于快速哈希计算。
• NoSleep：防止设备在文件传输时进入休眠状态。
• heic2any：用于将 HEIC/HEIF 格式转换为 PNG/GIF/JPEG。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装之前，请确保你的系统满足以下要求：

• Node.js：确保你已经安装了 Node.js（建议版本 14 或更高）。
• npm：Node.js 的包管理工具，通常随 Node.js 一起安装。
• Git：用于克隆项目仓库。

安装步骤

1. 克隆项目仓库

   打开终端或命令提示符，运行以下命令克隆 PairDrop 仓库：

   git clone https://github.com/schlagmichdoch/PairDrop.git
   

2. 进入项目目录

   克隆完成后，进入项目目录：

   cd PairDrop
   

3. 安装依赖

   使用 npm 安装项目依赖：

   npm install
   

4. 启动项目

   安装完成后，运行以下命令启动 PairDrop：

   npm start
   

   项目启动后，你可以在浏览器中访问 http://localhost:3000 来使用 PairDrop。

配置

PairDrop 提供了一些配置选项，你可以根据需要进行调整：

• STUN/TURN 服务器：如果你需要通过互联网传输文件，可以配置自己的 STUN/TURN 服务器。
• 显示名称：你可以更改设备的显示名称以便于区分。
• 设备配对：你可以通过 6 位代码或二维码配对设备，以便在不同网络环境下找到彼此。

常见问题

• 无法启动：确保 Node.js 和 npm 已正确安装，并且所有依赖项都已成功安装。
• 文件传输失败：检查网络连接，确保设备在同一局域网内或正确配置了 STUN/TURN 服务器。

通过以上步骤，你应该能够成功安装和配置 PairDrop，并开始使用它进行跨平台的文件传输。