README.md · LQ/ 元启星辰-FolkSpace-密钥工具

# FolkSpace 密钥工具

---

### 本仓库说明

本仓库为 FolkSpace 密钥工具源码仓库，用户拉取本仓库源码后，搭建运行环境运行项目，即可自己生成 FolkSpace 平台的密钥对，以及对数据进行签名等。

FolkSpace 密钥对以文件形式下载保存，其中包含三部分信息：私钥、公钥、地址，其文件名为密钥对对应的 FolkSpace 地址。
数据的签名结果也是以文件的形式下载保存，其中只包含签名结果。
若发生错误，会跳转到 Whitelabel Error Page 页面。

本项目为 SpringBoot 的前后端嵌套项目，关键技术：`Thymeleaf`+`FISCO BCOS` 。

下文将具体说明怎么运行和使用这个工具。

### 获取源码

- Git 克隆
- Download（下载） ZIP

### 安装JDK

- **Windows**
  
    下载 jdk-8u181-windows-x64.exe 到本机，[点击这里下载](https://repo.huaweicloud.com/java/jdk/8u181-b13/jdk-8u181-windows-x64.exe)，双击运行 jdk-8u181-windows-x64.exe，一路Next，安装JDK。
    
    **配置环境变量**
    
    1. 右击 “我的电脑”，选择 “高级系统设置”；
    2. 选择 “高级” 选项卡，点击 “环境变量”；
    3. 在 "系统变量" 中设置 3 项属性，**JAVA_HOME**、**CLASSPATH**、**Path**，若已存在则点击 “编辑”，不存在则点击 “新建”。
    
    **变量设置参数**
    
    变量名：`JAVA_HOME`
    
    变量值：`C:\Program Files (x86)\Java\jdk1.8.0_181`（jdk1.8.0_181的绝对路径）
    
    变量名：`CLASSPATH`
    
    变量值：`.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;`
    
    变量名：`Path`
    
    变量值：`%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;`
    
- **Linux**
  
    **检查系统中已有JDK**
    
    ```bash
    # 查看java版本
    java -version
    ```
    
    *如果已有JDK，不用重新安装，跳过此步骤。*
    
    下载 jdk-8u181-linux-x64.tar.gz 到本机，[点击这里下载](https://repo.huaweicloud.com/java/jdk/8u181-b13/jdk-8u181-linux-x64.tar.gz)，解压。
    
    ```bash
    # 解压jdk-8u181-linux-x64.tar.gz到本机
    tar -zxvf jdk-8u181-linux-x64.tar.gz
    ```
    
    **配置环境变量**
    
    ```bash
    # 编辑配置文件
    vi /etc/profile
    
    # 文件最下方添加以下配置
    export JAVA_HOME=/home/用户名/Desktop/jdk1.8.0_181（jdk1.8.0_181的绝对路径）
    export PATH=$PATH:$JAVA_HOME/bin
    export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
    
    # 生效配置文件
    source /etc/profile
    ```

### 安装Gradle

**如果直接运行项目 build 好的Jar包，跳过此步骤。**

下载 gradle-7.3.2-bin.zip 到本机，[点击这里下载](https://gradle.org/next-steps/?version=7.3.2&format=bin)，解压。

- **Windows**

**配置环境变量，变量设置参数**

变量名：`GRADLE_HOME`

变量值：`C:\Users\用户名\Desktop\gradle-7.3.2-bin\gradle-7.3.2`（gradle-7.3.2的绝对路径）

变量名：`Path`

变量值：`%GRADLE_HOME%\bin;`

- **Linux**

```bash
    # 解压gradle-7.3.2-bin.zip到本机
    unzip gradle-7.3.2-bin.zip
    ```
    
    **配置环境变量**

```bash
    # 编辑配置文件
    vi /etc/profile
  
    # 文件最下方添加以下配置
    export GRADLE_HOME=/home/用户名/Desktop/gradle-7.3.2（gradle-7.3.2的绝对路径）
    export PATH=$GRADLE_HOME/bin:$PATH
  
    # 生效配置文件
    source /etc/profile
    ```

### 运行项目

- **运行 build 好的 Jar包**

```bash
  # 进入Jar包所在路径
  cd /home/用户名/Desktop/folkspace/build/libs（Jar包的绝对路径）
  
  # 运行Jar包
  java -jar folkspace-1.1-SNAPSHOT.jar
  
  # 结束
  CTRL + C
  ```

- **运行项目**

```bash
  # 进入项目所在路径
  cd /home/用户名/Desktop/folkspace（folkspace项目的绝对路径）
  
  # 运行项目
  gradle bootRun
  
  # 结束
  CTRL + C
  ```

### 访问工具页

访问地址（URL）：[http://localhost](http://localhost)

通过可视化的工具页完成 FolkSpace 密钥对的下载，以及相关数据的签名。

---

LQ/ 元启星辰-FolkSpace-密钥工具

简介

发行版

贡献者

近期动态

LQ/ 元启星辰-FolkSpace-密钥工具 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

LQ/ 元启星辰-FolkSpace-密钥工具