iWant

基于CLI的去中心化点对点文件共享

构建状态

这是什么？

一个命令行工具，用于在局域网中搜索和下载文件，无需任何中央服务器。

特性

• 去中心化：没有中央服务器托管文件，因此没有单点故障。
• 轻松发现文件：像在谷歌上搜索一样简单。
• 从多个对等点下载文件：如果种子节点失效或离开群组，下载者将继续从网络中的其他种子节点下载。
• 目录下载：支持下载目录。
• 断点续传：从上次中断的地方继续下载。
• 数据一致性：对共享文件夹内的文件所做的任何更改（修改、删除、添加）都会立即在网络中反映。
• 跨平台：可在Linux/Windows/Mac上运行。在Mac上还需要更多测试。

为什么我要构建它？

• 我喜欢在终端中输入某个文件名，如果周围的人有它就可以下载的想法。
• 无需第三方注册。
• 无需疯狂的配置。
• 希望它是跨平台的。
• 零停机时间。
• 无需浏览器……只需终端。
• 纯粹为了好玩 ¯\(ツ)/¯

安装

pip install iwant

或者，如果你从源码下载：

python setup.py install --user

系统依赖

请确保已安装以下系统依赖：

• libffi-dev
• libssl-dev

用法

iWant.

    一个命令行工具，用于在局域网中搜索和下载文件，无需任何中央服务器。


用法：
    iwanto start
    iwanto search <name>
    iwanto download <hash>
    iwanto share <path>
    iwanto download to <destination>
    iwanto view config
    iwanto --version

选项：
    -h --help                           显示此屏幕。
    --version                           显示版本。
    start                               启动系统中的 iwant 服务器。
    search <name>                       在网络中发现文件。例如：iwanto search batman
    download <hash>                     从网络下载文件。
    share <path>                        更改你的共享文件夹。
    view config                         查看共享文件夹和下载文件夹。
    download to <destination>           更改下载文件夹。

注意：共享文件夹和下载文件夹不能相同

如何运行

运行 iwanto start（这会在你的系统上启动 iwant 服务）。

运行客户端

要运行搜索、下载、查看配置和更改配置等服务，请打开另一个终端并确保 iwant 服务器正在运行。

运行服务器

在 Windows 上，需要管理员权限才能运行服务器。

iwanto start

搜索文件

输入文件名 ;)（提示：不需要精确的名称）

iwanto search <filename>

示例：

iwanto search "slicon valey"

下载文件

要下载文件，只需输入搜索后得到的文件哈希值。

iwanto download <hash of the file>

示例：

iwanto download b8f67e90097c7501cc0a9f1bb59e6443

更改共享文件夹

随时更改共享文件夹（即使在 iwant 服务运行时）。

iwanto share <path>

示例：

iwanto share /home/User/Movies/

在 Windows 上，请使用引号：

iwanto share "C:\Users\xyz\books\"

更改下载文件夹

随时更改下载文件夹。

iwanto download to <path>

示例：

iwanto download to /home/User/Downloads

在 Windows 上，请使用引号：

iwanto download to "C:\User\Downloads"

查看共享/下载文件夹

iwanto view config

它是如何工作的？

程序启动后，会生成 选举守护进程、文件夹监控守护进程 和 服务器守护进程。

1. 选举守护进程 负责以下活动：

   • 管理共识。
   • 一旦发生领导者变更，立即通知 服务器守护进程。
   • 与其他网络中的对等点协调，处理选举竞争、领导者不可用、网络故障、脑裂情况等。
   • 使用 多播 进行对等点发现。共识描述见此处。

2. 当 文件夹监控守护进程 启动时，执行以下步骤：

   • 索引共享文件夹中的所有文件。
   • 更新数据库中的条目。
   • 告知服务器已索引的文件和文件夹。
   • 共享文件夹中的任何更改都将触发 文件夹监控守护进程 重新索引修改的文件、更新数据库，然后告知服务器这些更改。

3. 当用户希望进行以下操作时，iwant 客户端 与 服务器守护进程 通信：

   • 搜索文件
   • 下载文件
   • 更改共享文件夹
   • 更改下载文件夹

4. 服务器守护进程 接收来自 iwant 客户端 的命令以及来自 文件监控守护进程和选举守护进程 的更新。

   • 来自 文件夹监控守护进程 的更新（例如，已索引的文件/文件夹信息）会被转发给领导者。
   • 来自 选举守护进程 的更新（例如“领导者变更”事件）会触发服务器将已索引的文件/文件夹信息转发给新领导者。
   • 来自 iwant 客户端 的查询（例如“文件搜索”）会被转发给领导者，领导者对从其他对等点收到的元数据进行模糊搜索，并返回一个列表（包含文件名、大小、校验和）。
   • 来自 iwant 客户端 的查询（例如“文件下载”）会被转发给领导者，领导者转发文件/文件夹的根哈希以及拥有该文件的对等点列表。服务器守护进程 随后与对等点列表中提到的对等点启动下载过程。
   • 来自 iwant 客户端 的更新（例如“更改共享文件夹”）会触发 服务器守护进程 确保 文件夹监控守护进程 索引新文件夹，索引完成后，服务器守护进程 将新的已索引文件/文件夹元信息更新给领导者。

待办事项

• 集成严格的安全机制
• 添加 Python3 支持
• 添加视频预览
• 添加流媒体功能
• 添加基本的 NAT 穿透
• 创建测试模块
• 改进文件/文件夹下载进度条的 UI

为什么它可能无法工作？

• 防火墙
• 路由器不支持多播。

错误

所有日志位于 ~/.iwant/.iwant.log 或 AppData\Roaming\.iwant\.iwant.log

喜欢这个项目吗？

如果有任何想法、bug 或需要修改的地方，请随时给我发 PR :)