最完整的PairDrop使用指南：从安装到文件传输，小白也能轻松上手-优快云博客

最完整的PairDrop使用指南：从安装到文件传输，小白也能轻松上手

【免费下载链接】PairDrop PairDrop: Local file sharing in your browser. Inspired by Apple's AirDrop. Fork of Snapdrop. 项目地址: https://gitcode.com/gh_mirrors/pa/PairDrop

你还在为手机和电脑之间传输文件烦恼吗？用数据线太麻烦，用微信传文件压缩画质，用网盘还要上传下载？现在有了PairDrop，这些问题都能解决！PairDrop是一款基于WebRTC技术的本地文件共享工具，就像浏览器里的"隔空投送"，无需安装额外软件，打开网页就能在各种设备间高速传输文件。读完这篇指南，你将学会如何使用PairDrop进行本地和互联网文件传输，包括网页版快速上手、PWA安装、自托管部署以及命令行工具的使用方法。

什么是PairDrop？

PairDrop是一个开源的网页版文件传输工具，灵感来自苹果的AirDrop。它利用WebRTC技术实现设备间的点对点（P2P）连接，支持在同一局域网内或通过互联网安全快速地传输文件。与传统文件传输方式相比，PairDrop具有以下优势：

跨平台兼容：在任何带有现代浏览器的设备上都能使用，包括Windows、macOS、Linux、iOS和Android。
无需安装：直接在浏览器中运行，也可安装为渐进式Web应用（PWA）获得更优体验。
安全私密：文件直接在设备间传输，不经过第三方服务器（除非使用互联网传输功能）。
功能丰富：支持本地网络传输、互联网传输（通过配对设备或公共房间）、批量传输、多种文件类型预览等。

PairDrop的工作界面简洁直观，左侧显示当前可用的设备，右侧为文件拖放区域。下图展示了在移动设备上使用PairDrop的场景：

快速开始：使用网页版PairDrop

使用PairDrop最简便的方式是直接通过网页访问。无需安装任何软件，只需打开浏览器，按照以下步骤操作：

步骤1：访问PairDrop网页

在设备浏览器中输入PairDrop的网址（如果你是自托管用户，请输入你自己搭建的PairDrop服务地址）。首次访问时，浏览器会请求获取网络摄像头权限，这是WebRTC技术建立P2P连接所必需的，PairDrop不会实际使用摄像头。

步骤2：确认设备发现

打开网页后，PairDrop会自动搜索同一网络中的其他设备。所有开启PairDrop的设备会以卡片形式显示在页面左侧，卡片上会显示设备名称和类型（如"我的笔记本电脑"、"iPhone"等）。如果没有发现其他设备，请检查以下事项：

确保所有设备都连接到同一网络（除非使用互联网传输功能）。
确认防火墙没有阻止WebRTC相关端口。
尝试刷新所有设备的PairDrop页面。

步骤3：传输文件

传输文件有两种常用方式：

拖放方式：

在电脑上，直接将文件或文件夹拖放到PairDrop网页的文件区域。
在移动设备上，点击"选择文件"按钮，从文件管理器中选择要发送的文件。
选择接收设备，对方会收到文件传输请求。
接收方点击"接受"后，文件开始传输。

分享菜单方式：在移动设备上，你还可以通过系统分享菜单直接发送文件到PairDrop：

在手机上打开要分享的文件（如照片、文档等）。
点击分享按钮，在分享选项中找到"PairDrop"（如果没有看到，请先将PairDrop安装为PWA）。
选择目标设备，完成传输。

以下是移动设备上文件传输过程的截图示例（以发送图片为例）：

步骤4：接收文件

当其他设备向你发送文件时，PairDrop会显示通知并弹出接收请求。点击"接受"按钮开始接收文件，接收完成后，文件会自动保存到默认下载文件夹（可在浏览器设置中更改）。对于图片等支持预览的文件，你可以直接在PairDrop中查看。

将PairDrop安装为PWA（推荐）

虽然可以直接通过浏览器使用PairDrop，但将其安装为渐进式Web应用（PWA）可以获得更好的使用体验，包括：

桌面或主屏幕快捷方式，一键打开。
独立窗口运行，类似原生应用。
支持后台运行和推送通知。
可离线使用（基本功能）。

在不同设备上安装PWA

桌面设备（Chrome/Edge浏览器）：

打开PairDrop网页。
点击地址栏右侧的"安装"图标（看起来像一个电脑屏幕带有"+"号）。
在弹出的对话框中点击"安装"。

iOS设备（Safari浏览器）：

打开PairDrop网页。
点击底部工具栏的"分享"按钮。
滑动到分享选项的最右侧，点击"添加到主屏幕"。
确认应用名称，点击"添加"。

Android设备（Chrome浏览器）：

打开PairDrop网页。
点击右上角的菜单按钮（三个点）。
选择"安装应用"或"添加到主屏幕"。
在弹出的对话框中点击"安装"。

安装完成后，你可以在设备的主屏幕或应用列表中找到PairDrop图标，点击即可快速打开。下图展示了PWA安装过程的提示界面：

自托管PairDrop：在本地网络部署

如果你需要在没有互联网连接的环境中使用PairDrop，或者希望拥有更高的隐私性和控制权，可以选择在本地网络中自托管PairDrop服务。自托管可以通过Docker或Node.js两种方式实现，这里我们以更简单的Docker方式为例：

前提条件

一台运行Docker和Docker Compose的设备（如电脑、服务器、树莓派等）。
设备需要连接到本地网络，并具有固定的IP地址或可解析的主机名。

使用Docker Compose部署

克隆PairDrop仓库：首先，在你的服务器上克隆PairDrop的代码仓库：
```
git clone https://gitcode.com/gh_mirrors/pa/PairDrop.git && cd PairDrop
```

配置Docker Compose： PairDrop提供了现成的Docker Compose配置文件。如果你只需要在本地网络使用，可以直接使用默认的docker-compose.yml：

version: "3"
services:
    pairdrop:
        image: "lscr.io/linuxserver/pairdrop:latest"
        container_name: pairdrop
        restart: unless-stopped
        environment:
            - PUID=1000
            - PGID=1000
            - TZ=Etc/UTC
        ports:
            - "3000:3000"

如果你需要通过互联网访问，或需要配置STUN/TURN服务器，请参考自托管文档中的详细说明。

启动服务：运行以下命令启动PairDrop服务：
```
docker compose up -d
```
Docker会自动拉取镜像并启动容器。启动完成后，PairDrop服务会在3000端口运行。
访问自托管的PairDrop：在同一网络的设备浏览器中输入http://<服务器IP地址>:3000，即可访问你自己部署的PairDrop服务。

配置HTTPS（可选）

为了启用PWA安装、通知等高级功能，建议配置HTTPS。你可以通过Nginx反向代理并配合Let's Encrypt证书实现HTTPS。详细的Nginx配置示例可以在自托管文档中找到。

高级功能：互联网文件传输

PairDrop不仅支持本地网络传输，还可以通过以下两种方式实现互联网文件传输：

1. 配对设备

通过设备配对功能，你可以将常用设备（如手机和电脑）进行配对，之后无论它们是否在同一网络，都能互相发现并传输文件。

配对步骤：

在两台设备上打开PairDrop。
在其中一台设备上点击"配对设备"按钮，选择"生成配对码"。
在另一台设备上点击"配对设备"，选择"输入配对码"或扫描QR码。
输入6位配对码，完成配对。

配对后的设备会永久保存在PairDrop中，即使关闭网页后重新打开也不会丢失。你可以在"已配对设备"列表中管理所有配对设备，包括重命名和解除配对。

2. 公共房间

如果你需要临时与他人传输文件（如与朋友分享照片、与同事协作等），可以使用公共房间功能：

在PairDrop页面点击"加入公共房间"。
输入一个房间名称（如"家庭聚会2023"），或使用系统生成的随机名称。
将房间名称或QR码分享给对方。
对方在自己的PairDrop中输入相同的房间名称，即可加入房间。
房间内的所有设备会互相可见，可以直接传输文件。

公共房间是临时的，关闭PairDrop网页后会自动退出房间。所有通过公共房间传输的文件仍然是P2P的，不经过中央服务器。

命令行工具：pairdrop-cli

对于高级用户和开发者，PairDrop提供了命令行工具pairdrop-cli，可以直接在终端中发送文件。这对于服务器管理、自动化脚本等场景非常有用。

安装pairdrop-cli

Linux/macOS：

下载最新的pairdrop-cli.zip压缩包（可从PairDrop的发布页面获取）。

解压到指定目录，例如：

sudo unzip pairdrop-cli.zip -d /usr/share/pairdrop-cli/

复制配置文件：

sudo cp /usr/share/pairdrop-cli/.pairdrop-cli-config.example /usr/share/pairdrop-cli/.pairdrop-cli-config

赋予执行权限并创建符号链接：

sudo chmod +x /usr/share/pairdrop-cli/pairdrop
sudo ln -s /usr/share/pairdrop-cli/pairdrop /usr/local/bin/pairdrop

Windows：

下载pairdrop-cli.zip并解压到C:\Program Files\pairdrop-cli\。
复制.pairdrop-cli-config.example为.pairdrop-cli-config。
将C:\Program Files\pairdrop-cli\添加到系统环境变量PATH中。
安装Git Bash（因为Windows本身不支持Bash脚本）。

使用pairdrop-cli

安装完成后，可以通过pairdrop命令使用工具。常用命令示例：

查看帮助：
```
pairdrop -h
```
发送文件：
```
pairdrop /path/to/file1 /path/to/file2
```
发送文本：
```
pairdrop -t "Hello from pairdrop-cli!"
```

指定PairDrop服务器（适用于自托管用户）：

pairdrop -d "https://your-pairdrop-instance.com" /path/to/file

执行发送命令后，会自动打开默认浏览器，显示可用设备列表，选择目标设备即可完成传输。

常见问题与解决方案

在使用PairDrop的过程中，可能会遇到一些常见问题，以下是解决方法：

问题1：设备无法互相发现

可能原因：

设备不在同一网络（对于本地传输）。
防火墙或安全软件阻止了WebRTC连接。
网络中启用了AP隔离功能（常见于某些公共Wi-Fi）。

解决方法：

确认所有设备连接到同一网络，或使用互联网传输功能。
检查防火墙设置，确保允许WebRTC相关端口（UDP 3478-3479，TCP 443等）。
尝试重启路由器，或使用手机热点创建新网络。

问题2：文件传输速度慢

可能原因：

网络带宽限制。
设备之间使用了WebRTC中继（TURN服务器）而非直连。
传输大文件时设备性能不足。

解决方法：

尽量将设备连接到同一局域网，避免使用互联网传输。
自托管用户可配置性能更好的STUN/TURN服务器（参考配置STUN/TURN服务器）。
关闭其他占用网络带宽的应用。

问题3：无法安装PWA

可能原因：

网站未通过HTTPS提供服务。
浏览器不支持PWA安装。
网页没有正确配置PWA清单文件。

解决方法：

确保PairDrop通过HTTPS访问（自托管用户需配置SSL证书）。
使用最新版本的Chrome、Edge、Safari或Firefox浏览器。
检查浏览器开发者工具中的"应用"面板，查看是否有PWA相关错误。

更多常见问题和解答，请参考官方文档中的FAQ。

总结

PairDrop是一款功能强大、使用简便的跨平台文件传输工具，通过浏览器即可实现设备间的高速P2P文件传输。无论是日常的本地网络文件共享，还是需要跨互联网的设备配对传输，PairDrop都能满足需求。通过本文介绍的方法，你可以快速上手使用网页版PairDrop，也可以选择自托管部署以获得更高的控制权。对于高级用户，命令行工具pairdrop-cli提供了更多自动化和集成的可能性。

希望这篇指南能帮助你充分利用PairDrop的各项功能，享受便捷高效的文件传输体验！如果你在使用过程中遇到问题，或有功能建议，欢迎参与PairDrop的开源社区贡献（贡献指南）。

【免费下载链接】PairDrop PairDrop: Local file sharing in your browser. Inspired by Apple's AirDrop. Fork of Snapdrop. 项目地址: https://gitcode.com/gh_mirrors/pa/PairDrop

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考