# S3FileClient

**Repository Path**: sky0535/S3FileClient

## Basic Information

- **Project Name**: S3FileClient
- **Description**: S3 兼容存储客户端
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# S3FileClient

基于 .NET 8.0 Windows Forms 的 S3 兼容存储客户端应用程序。

## 功能特性

- ✅ S3 兼容存储服务连接
- ✅ 文件列表展示
- ✅ 文件上传
- ✅ 文件下载
- ✅ 下载记录管理
- ✅ 日志记录

## 技术栈

| 技术/框架 | 版本 |
|-----------|------|
| .NET | 8.0 |
| Windows Forms | - |
| AWSSDK.S3 | 4.0.23.6 |
| NLog | 6.0.1 |

## 项目结构

```
S3FileClient/
├── S3FileClient.sln
├── Common/                    # 通用类库
│   ├── Models/
│   │   └── FileData.cs        # 文件数据模型
│   └── Utils/
│       └── ConfigHelper.cs    # 配置辅助类
└── S3FileClient/              # 主应用
    ├── Program.cs             # 程序入口
    ├── MainForm.cs            # 主窗体
    └── Utils/
        ├── S3ClientHelper.cs  # S3客户端助手
        ├── S3FileService.cs   # 文件服务
        └── UIHelper.cs        # UI辅助类
```

## 快速开始

### 编译项目

```powershell
dotnet build S3FileClient.sln
```

### 运行应用

```powershell
cd S3FileClient/S3FileClient/bin/Debug/net8.0-windows
./S3FileClient.exe
```

## 使用说明

1. 在服务器地址输入框中输入 S3 兼容存储服务地址
2. 点击"连接"按钮建立连接
3. 连接成功后可浏览文件列表
4. 使用"上传"按钮上传本地文件
5. 选择文件后点击"下载"按钮下载文件
6. 在下载记录列表中可打开已下载的文件

## 配置说明

### 默认凭证配置

- **Access Key**: `rustfsadmin`
- **Secret Key**: `rustfsadmin`
- **Bucket Name**: `test`

> **注意**: 当前版本将凭证硬编码在代码中，生产环境建议使用外部配置文件。

### 日志输出

日志文件输出到 `bin/Debug/net8.0-windows/Logs/` 目录。

## 核心功能

### S3ClientHelper
- 初始化 S3 客户端连接
- 自动检测并创建 Bucket

### S3FileService
- 获取文件列表
- 文件上传/下载
- 管理下载目录

### UIHelper
- 文件大小格式化显示
- 线程安全的 UI 更新

## 安全建议

1. 将凭证移至外部配置文件或环境变量
2. 生产环境使用 HTTPS 协议
3. 增加输入验证和异常处理

## 许可证

MIT License