开源项目 ShareDrop 的安装和配置指南

开源项目 ShareDrop 的安装和配置指南

sharedrop Easy P2P file transfer powered by WebRTC - inspired by Apple AirDrop 项目地址: https://gitcode.com/gh_mirrors/sha/sharedrop

1. 项目基础介绍

ShareDrop 是一个受到苹果 AirDrop 启发的网页应用程序，它允许用户在不同设备之间直接传输文件，而不需要先将文件上传到任何服务器。ShareDrop 使用 WebRTC 技术来实现安全的点对点文件传输，并使用 Firebase 进行在线状态管理和 WebRTC 信号传输。

主要编程语言：JavaScript

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

• WebRTC: 用于实现点对点的文件传输。
• Firebase: 用于在线状态管理和信令。
• Ember.js: 用于前端框架。
• Node.js: 作为服务器端的运行环境。

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

准备工作

• 确保你的计算机上已经安装了 Node.js 和 npm（Node.js 的包管理器）。
• 准备 Firebase 帐户并创建一个数据库。
• 安装 Ember CLI。

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/szimek/sharedrop.git
   cd sharedrop
   

2. 安装项目依赖：

   npm install -g ember-cli
   yarn install
   

3. 配置 Firebase：

   • 登录 Firebase 控制台，创建一个新的项目。
   • 在 Firebase 控制台中，找到 "安全规则" 选项卡，点击 "加载规则" 按钮，选择项目中的 firebase_rules.json 文件。
   • 记下数据库的 URL 和密钥，它们可以在 "Secrets" 选项卡中找到。

4. 配置环境变量：

   cp .env{.sample,}
   

   在 .env 文件中，设置 SECRET 密钥，这个密钥用于加密 cookies 和根据公网 IP 地址生成房间名称。SECRET 密钥可以是任何随机字符串，你可以使用如 date | md5sum 的命令生成一个。

5. 启动开发服务器：

   yarn develop
   

   现在项目应该已经在本地启动，并通过浏览器访问 http://localhost:4200 可以查看。

以上步骤为基本的安装和配置指南，用于在本地环境运行 ShareDrop 项目。如需将项目部署到线上环境，如 Heroku，还需要进行额外的配置和部署步骤。

sharedrop Easy P2P file transfer powered by WebRTC - inspired by Apple AirDrop 项目地址: https://gitcode.com/gh_mirrors/sha/sharedrop