# HDFS可视化工具

**Repository Path**: codewithlong/hdfs_browser_visualization_tool

## Basic Information

- **Project Name**: HDFS可视化工具
- **Description**: HDFS Browser 是一款基于 Electron + Vue 3 + FastAPI 开发的现代、简洁、高性能的 HDFS (Hadoop Distributed File System) 文件管理工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HDFS Browser

HDFS Browser 是一款基于 Electron + Vue 3 + FastAPI 开发的现代、简洁、高性能的 HDFS (Hadoop Distributed File System) 文件管理工具。
<br>本项目也支持仅前后端分离不打包运行，但强烈建议使用Electron！
<br>你是小白，不知道怎么去构建？附上国内网盘链接，为打完包后的免安装文件，支持windows系统一键打开运行
<br>链接:https://pan.baidu.com/s/1aXYUr8Il3R-hT3bTXL1H5g?pwd=ngrg
<br>标注：设计之初是为了解决高版本pycharm以及其bigdata插件不支持老版本hadoop（我hadoop版本为3.3.4）的hdfs文件系统在线浏览和编辑的痛点。

##  功能特性

-  **文件浏览**：流畅查看 HDFS 目录结构，支持文件夹级联导航。
-  **文件操作**：支持文件上传、下载、重命名、删除、新建文件夹等基础功能。
-  **在线编辑**：内置文本编辑器，支持在线查看和编辑 HDFS 上的文本文件（支持 UTF-8 和 GBK 编码）。

##  技术栈

- **前端**：Vue 3, Element Plus, Vite, Axios
- **主进程**：Electron
- **后端**：Python 3, FastAPI, Hdfs (python-hdfs 库)
- **打包工具**：Electron Builder, PyInstaller

##  快速开始

### 开发环境配置

1. **克隆项目**
   ```bash
   git clone git@gitee.com:codewithlong/hdfs_browser_visualization_tool.git
   cd hdfs-browser-app
   ```

2. **安装依赖**
   ```bash
   # 安装根目录依赖
   npm install
   # 安装前端依赖
   cd frontend && npm install
   # 安装后端依赖 (建议使用虚拟环境)
   cd ../backend && pip install -r requirements.txt
   ```

3. **启动开发环境**
   ```bash
   # 在根目录下运行
   npm run dev
   ```

### 打包发布

项目支持一键打包，会自动处理前端构建和后端 PyInstaller 封装：

```bash
# 打包生成安装程序
npm run dist

# 打包生成便携版 (Portable)
npm run dist:portable
```

##  界面预览

连接界面：
![应用截图](./img/1.png)
目录界面：
![应用截图](./img/2.png)
文件浏览界面：
![应用截图](./img/3.png)

##  贡献指南

欢迎提交 Issue 或 Pull Request。

##  作者

- **作者**：codewithlong
- **邮箱**：codewithlong@qq.com
- **备注**：若有相关问题，欢迎联系探讨

##  开源协议

MIT License