hivecomputing/hive-disk

hiveDisk服务器版（仅贡献模式）Docker镜像

概述

hiveDisk服务器版允许您贡献存储空间，从而赚取可在其他设备的hiveDisk账户上使用的存储空间。hive代理（底层守护进程软件）可在贡献模式下运行，适用于希望在服务器、NAS或无法部署hive桌面应用的系统上向hive网络贡献存储空间的场景。这使得您可以在其他设备上使用在hive网络中赚取的贡献空间。

核心功能与特性

• 贡献模式运行：支持在服务器、NAS等设备上以贡献模式运行hive代理
• 存储空间赚取：通过贡献本地存储空间获得可在其他设备使用的网络存储空间
• 持久化数据存储：配置和数据通过卷挂载实现持久化，容器重启不丢失数据
• 自动认证流程：首次运行时通过浏览器完成身份验证，后续无需重复验证

适用场景

• 服务器环境中贡献存储空间
• NAS设备上部署以利用闲置存储
• 无法安装桌面应用的系统参与hive网络
• 需要在多设备间共享赚取的存储空间的用户

前提条件

您需要：

• 一个hiveDisk用户账户（可通过桌面应用创建）
• 已完成注册过程中的引导流程（通过桌面应用完成）

安装

从Docker Hub拉取最新镜像：

bash
docker pull docker.xuanyuan.run/hivecomputing/hive-disk:latest

使用方法

设置默认配置

1. 创建持久化数据目录并配置权限：

   bash
   mkdir hivedata
   sudo chown :4200 hivedata  # 设置所属组为4200
   sudo chmod 775 hivedata
   sudo chmod g+s hivedata  # 使后续文件/目录创建继承父文件夹的组ID
   

2. 生成配置文件：

   bash
   docker run -p 8080:8080 -p 4443:4443 -p 4001:4001 \
     -v /etc/machine-id:/etc/machine-id \
     -v /var/lib/dbus/machine-id:/var/lib/dbus/machine-id \
     -v ${PWD}/hivedata:/home/hive/.hive \
     docker.xuanyuan.run/hivecomputing/hive-disk:latest hive-agent config init
   

   成功执行后，将在hivedata目录中生成config.yaml文件，并显示消息：Generated and saved a new configuration!

   注意：运行hive-agent的用户必须对指定路径具有文件和目录的创建权限。

启动hive-agent守护进程

使用以下命令启动守护进程并指定贡献的存储空间（XX为GB数，需≥5）：

bash
docker run -p 8080:8080 -p 4443:4443 -p 4001:4001 \
  -v /etc/machine-id:/etc/machine-id \
  -v /var/lib/dbus/machine-id:/var/lib/dbus/machine-id \
  -v ${PWD}/hivedata:/home/hive/.hive \
  docker.xuanyuan.run/hivecomputing/hive-disk:latest hive-agent contribute XX

身份验证流程

首次启动时，系统会要求进行身份验证，认证URL将输出到标准输出：

Challenge received, user code to validate is : ZFMZ-GMXW
A browser should automatically open so you can complete the onboarding flow.
In case it does not open, please complete the flow manually by visiting the following URL in a browser 
https://hivenet-prod.eu.auth0.com/activate?user_code=ZFMZ-GMXW

Please complete the authentication challenge in browser whithin the next 900 second

在浏览器中完成认证后，刷新令牌将加密存储在hivedata目录中，后续启动无需再次认证。

验证运行状态

如果日志中出现以下信息，表示代理已成功启动并开始贡献存储空间：

Agent started in : XXXXms

联系支持

如在使用过程中有任何反馈或遇到问题，请联系：***