# imagestorage

**Repository Path**: kangSri/imagestorage

## Basic Information

- **Project Name**: imagestorage
- **Description**: 存储文件图片接口
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-23
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📁 文件存储服务

一个基于 Node.js 的简单、高效的文件存储服务，提供文件上传、下载、管理和统计功能。

## ✨ 功能特性

- 🚀 **简单易用**: 现代化的 Web 界面，支持拖拽上传
- 📤 **文件上传**: 支持单文件和多文件上传，最大 50MB
- 📥 **文件下载**: 一键下载存储的文件
- 🗑️ **文件管理**: 查看、删除文件
- 📊 **统计信息**: 实时显示文件数量和存储大小
- 🔒 **安全可靠**: 文件名自动添加时间戳，避免冲突
- 📱 **响应式设计**: 支持桌面和移动设备

## 🛠️ 技术栈

- **后端**: Node.js + Express.js
- **文件处理**: Multer
- **前端**: 原生 JavaScript + CSS3
- **文件系统**: fs-extra

## 📦 安装和运行

### Windows 环境

#### 1. 安装依赖

```bash
npm install
```

#### 2. 启动服务

```bash
# 生产环境
npm start

# 开发环境（自动重启）
npm run dev
```

#### 3. 访问服务

打开浏览器访问: http://localhost:8004

### Linux 环境

#### 方法一：使用部署脚本（推荐）

```bash
# 1. 给脚本执行权限
chmod +x deploy.sh

# 2. 运行部署脚本
sudo ./deploy.sh
```

#### 方法二：手动部署

```bash
# 1. 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 创建存储目录
sudo mkdir -p /data/files
sudo chmod 755 /data/files

# 3. 安装依赖
npm install

# 4. 启动服务
npm start
```

#### 方法三：使用 PM2 管理

```bash
# 1. 安装 PM2
sudo npm install -g pm2

# 2. 启动服务
pm2 start server.js --name "imagestorage"

# 3. 设置开机自启
pm2 startup
pm2 save
```

#### 4. 访问服务

```bash
# 查看服务器IP
ip addr show

# 访问服务（替换为实际IP）
http://your-server-ip:8004
```

## 🔧 API 接口

### 文件管理

- `GET /api/files` - 获取文件列表
- `POST /api/upload` - 上传文件
- `GET /api/download/:filename` - 下载文件
- `DELETE /api/files/:filename` - 删除文件

### 统计信息

- `GET /api/stats` - 获取存储统计信息

## 📁 项目结构

```
imagestorage/
├── server.js          # 主服务器文件
├── package.json       # 项目配置
├── public/            # 静态文件
│   └── index.html     # 前端界面
├── uploads/           # 文件存储目录（自动创建）
└── README.md          # 项目说明
```

## 🎯 使用说明

1. **上传文件**: 
   - 点击"选择文件"按钮选择文件
   - 或直接拖拽文件到上传区域
   - 支持多文件同时上传

2. **管理文件**:
   - 查看文件列表和详细信息
   - 点击"下载"按钮下载文件
   - 点击"删除"按钮删除文件

3. **查看统计**:
   - 实时显示文件总数和存储大小

## 🔧 配置选项

可以在 `server.js` 中修改以下配置：

- **端口**: 修改 `PORT` 变量（默认 8004）
- **文件大小限制**: 修改 `fileSize` 限制（默认 50MB）
- **存储目录**: 修改 `uploadDir` 路径

## 📝 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！