# 3FS

**Repository Path**: kunpeng_compute/3FS

## Basic Information

- **Project Name**: 3FS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 4
- **Created**: 2025-03-11
- **Last Updated**: 2025-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目介绍<a name="ZH-CN_TOPIC_0000002442162516"></a>

Fire-Flyer文件系统（以下简称3FS）是由DeepSeek AI专为满足AI训练和推理工作负载的密集数据需求而设计开发的一种高性能分布式并行文件系统，以高吞吐、低延迟和强一致性为核心设计理念，通过高效利用RDMA网络，为分布式应用开发者提供了一个简化的共享存储层。

Kunpeng-3FS是鲲鹏参与DeepSeek开源社区，通过毕昇编译器、编译优化等手段帮助用户在鲲鹏平台的openEuler22.03操作系统下，完成3FS的编译和安装。

# 版本说明<a name="ZH-CN_TOPIC_0000002442827374"></a>

**表 1**  版本说明

<a name="table541361919200"></a>
<table><thead align="left"><tr id="row1041351932014"><th class="cellrowborder" valign="top" width="27.382738273827385%" id="mcps1.2.4.1.1"><p id="p441411962014"><a name="p441411962014"></a><a name="p441411962014"></a>Kunpeng-3FS</p>
</th>
<th class="cellrowborder" valign="top" width="39.28392839283928%" id="mcps1.2.4.1.2"><p id="p6414919202018"><a name="p6414919202018"></a><a name="p6414919202018"></a>DeekSeek-3FS</p>
</th>
<th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.3"><p id="p124141119102017"><a name="p124141119102017"></a><a name="p124141119102017"></a>特性</p>
</th>
</tr>
</thead>
<tbody><tr id="row54141019102019"><td class="cellrowborder" valign="top" width="27.382738273827385%" headers="mcps1.2.4.1.1 "><p id="p10414101912207"><a name="p10414101912207"></a><a name="p10414101912207"></a>v1.0.0</p>
</td>
<td class="cellrowborder" valign="top" width="39.28392839283928%" headers="mcps1.2.4.1.2 "><p id="p74140197204"><a name="p74140197204"></a><a name="p74140197204"></a>commitId：3a30c53bf25c23a963aaa547098dcceff2c33baf</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p1141491911206"><a name="p1141491911206"></a><a name="p1141491911206"></a>适配鲲鹏平台的openEuler22.03操作系统下编译和部署</p>
</td>
</tr>
</tbody>
</table>

# 环境部署<a name="ZH-CN_TOPIC_0000002476107261"></a>




## 环境准备<a name="ZH-CN_TOPIC_0000002442853836"></a>

参考[鲲鹏社区](https://www.hikunpeng.com/document/detail/zh/kunpengsdss/ecosystemEnable/3FS/kunpeng3fs_01_0005.html)准备编译环境、Rust、FoundationDB、libfuse以及其他依赖项的安装。

## 编译3FS<a name="ZH-CN_TOPIC_0000002442693944"></a>

1.  安装毕昇编译器。
    1.  从[毕昇编译器产品页](https://www.hikunpeng.com/zh/developer/devkit/download/bishengcompiler)获取BiShengComplier-4.2.0压缩包。
    2.  解压并配置临时环境变量。

        ```
        tar -xvf BiShengCompiler-4.2.0-aarch64-linux.tar.gz
        export PATH={PATH_BiShengCompiler}/bin:$PATH
        ```

    3.  查看编译器版本。

        ```
        clang -v 
        ```

        回显如下。

        ```
        BiSheng Enterprise 4.2.0.B009 clang version 17.0.6 (958fd14d28f0)
        Target: aarch64-unknown-linux-gnu  
        ...
        ```

2.  获取源码并切换openEuler分支。

    ```
    git clone https://gitcode.com/boostkit/3FS.git
    cd 3fs
    git checkout openeuler
    git submodule update --init --recursive 
    ./patches/apply.sh 
    ```

3.  获取[openeuler\_3fs.patch](https://gitee.com/kunpeng_compute/3FS/releases/download/openeuler_3fs/openeuler_3fs.patch)和[openeuler\_3fs\_folly.patch](https://gitee.com/kunpeng_compute/3FS/releases/download/openeuler_3fs/openeuler_3fs_folly.patch)并应用。

    ```
    patch -p1 < openeuler_3fs.patch 
    cd third_party/folly 
    patch -p1 < openeuler_3fs_folly.patch
    ```

4.  编译3FS。

    ```
    cd /home/3fs 
    cmake -S . -B build -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_EXPORT_COMPILE_COMMANDS=ON  
    cmake --build build -j
    ```

5.  检查编译结果。

    ```
    ls build/bin
    ```

    可以看到一系列3FS二进制文件。

## 部署3FS<a name="ZH-CN_TOPIC_0000002476053937"></a>

3FS部署的详细操作步骤参考[鲲鹏社区](https://www.hikunpeng.com/document/detail/zh/kunpengsdss/ecosystemEnable/3FS/kunpeng3fs_01_0019.html)。

# 快速上手<a name="ZH-CN_TOPIC_0000002442667478"></a>

3FS部署完成后，可以使用fio工具对其挂载的目录进行读写测试，本小节以3FS挂载目录为“/3fs/stage“进行举例说明。

```
fio -numjobs=128 -fallocate=none -iodepth=2 -ioengine=libaio -direct=1 \ 
    -rw=read -bs=4M --group_reporting -size=100M -time_based -runtime=3000 \ 
    -name=2depth_128file_4M_direct_read_bw -directory=/3fs/stage
```

# 安装后验证<a name="ZH-CN_TOPIC_0000002476027457"></a>

3FS部署成功后，在客户端节点可以查看到3FS挂载的目录信息，本小节以3FS挂载目录为“/3fs/stage“进行举例说明。

```
df -h 
```

回显信息如下。

```
# Filesystem                         Size  Used Avail Use% Mounted on  
# ...  
# hf3fs.stage                         70T  650G   70T   1% /3fs/stage 
```

# 贡献指南<a name="ZH-CN_TOPIC_0000002442827378"></a>

如果使用过程中有任何问题，或者需要反馈特性需求和bug报告，可以提交issues联系我们，具体贡献方法可参考[这里](https://gitcode.com/boostkit/community/blob/master/docs/contributor/contributing.md)。

# 免责声明<a name="ZH-CN_TOPIC_0000002476107265"></a>

此代码仓计划参与DeepSeek-3FS软件开源，仅作系统适配，编码风格遵照原生开源软件，继承原生开源软件安全设计，不破坏原生开源软件设计及编码风格和方式，软件的任何漏洞与安全问题，均由相应的上游社区根据其漏洞和安全响应机制解决。请密切关注上游社区发布的通知和版本更新。鲲鹏计算社区对软件的漏洞及安全问题不承担任何责任。