#client #bitmessage #networking #p2p #socks5-proxy #protocols #local-file

app koibumi

一个实验性的Bitmessage客户端

11个版本

0.0.10 2024年6月26日
0.0.9 2021年1月6日
0.0.8 2020年9月9日
0.0.6 2020年8月25日
0.0.1 2020年5月26日

#1228 in 网络编程

AGPL-3.0-or-later

1.5MB
15K SLoC

Koibumi

Koibumi 是一个实验性的 Bitmessage 客户端。请注意,Koibumi 不是 The Bitmessage Developers 的官方项目。

特性

Koibumi 可以连接到 Bitmessage 网络,并中继 Bitmessage 对象。

它有一个图形用户界面。可以在窗口中执行配置和监控。如果您不需要任何GUI,请使用 koibumi-daemon 代替。

目前,此客户端可以发送和接收频道和广播消息。

默认情况下,网络连接仅限于通过 Tor 进行。在这种情况下,您需要一个运行在本地主机的 Tor SOCKS5 代理。

通过网络加载的对象和已知节点地址列表使用 SQLite 保存到本地文件系统。配置可以保存到用户配置目录中的文件。可以通过指定命令行上的 -d 选项来更改数据目录。

用法

要安装 Koibumi Bitmessage 客户端,请发出以下命令

cargo install koibumi

或者,如果您想显示日文字符

cargo install koibumi --features unifont_jp

为了成功完成安装,您可能需要在宿主 Linux 机器上安装一些额外的库,例如 libvulkan-dev

要运行客户端,请运行 koibumi 命令,并弹出一个 GUI 窗口。可能需要在 Linux 上安装 mesa-vulkan-drivers。在窗口中,您可以配置几个设置。

要连接到 Bitmessage 网络,请在窗口中点击“启动”按钮。当客户端连接到一些远程节点时,它们的地址和用户代理将显示在窗口上。您可以监控下载和共享的 Bitmessage 对象数量。

此客户端是实验性的,处于开发中,因此在控制台上打印了许多调试日志。在命令行上添加 -v 选项,将打印更多消息。

请注意,由于数据库格式可能在版本之间发生变化,尝试新版本时,您可能需要删除位于$HOME/.config/koibumi的数据库文件。

设置

这些是默认设置

  • 在127.0.0.1:8444上启动Bitmessage服务器。但是,目前这还没有完全工作,客户端没有宣传其服务器地址。
  • 通过位于127.0.0.1:9050的SOCKS5代理连接到Bitmessage网络。这是默认的本地Tor代理服务器地址。请注意,如果此复选框被关闭,则不使用SOCKS代理,所有连接都直接连接到Clearnet。
  • 客户端可以连接到具有Onion地址的Bitmessage节点。
  • 客户端可以连接到具有IP地址的Bitmessage节点。请注意,如果上面的SOCKS复选框被关闭,则所有连接都直接连接到Clearnet。
  • 不会连接到自己。
  • 使用PyBitmessage版本的用户代理。
  • 最初,连接到Tor网络上的种子Bitmessage节点。此默认地址嵌入在PyBitmessage源代码中。
  • 可以接受的最大160个传入连接,以及可以管理的最大128个传入建立连接。
  • 可以发起的最大32个传出连接,以及保持的最大8个传出建立连接。

您可以在GUI窗口中更改这些设置。

实现细节

Koibumi使用的某些重要的外部crates

Koibumi的内部实现分为几个crates

  • 应用程序
    • koibumi:一个具有GUI的实验性Bitmessage客户端
    • koibumi-daemon:一个没有GUI的实验性Bitmessage客户端
    • koibumi-core:一个提供各种类型和方法的库,可用于实现Bitmessage客户端
    • koibumi-node:Bitmessage网络节点的实现
  • 其他小型库

依赖项

~80MB
~1.5M SLoC