LingStorage 是一个统一的存储网关系统，提供多存储后端的文件管理解决方案。通过统一的 API 接口，您可以轻松地在不同的存储后端之间切换，无需修改业务代码。无论是本地存储、云存储还是对象存储，LingStorage 都能为您提供一致的文件管理体验。
- 🔄 统一存储接口 - 一套 API 支持多种存储后端
- ☁️ 多存储支持 - 本地存储、七牛云、腾讯云COS、阿里云OSS、MinIO、AWS S3
- 🎨 现代化界面 - 基于 React + TypeScript 的响应式管理后台
- 🔐 完善的权限系统 - 支持 RBAC/ABAC 权限控制
- 📊 实时监控 - API 调用统计、带宽监控、性能分析
- 🚀 Docker 部署 - 一键部署，开箱即用
- 📝 完整文档 - 详细的 API 文档和使用指南
- ✅ 存储桶管理（创建、删除、权限设置）
- ✅ 文件上传、下载、删除、复制、移动
- ✅ 文件列表查询（支持分页、前缀过滤）
- ✅ 文件预览和访问 URL 生成
- ✅ 支持大文件上传（默认限制 100MB）
- ✅ 用户注册、登录、认证
- ✅ 角色权限管理（RBAC/ABAC）
- ✅ 用户状态管理（启用/禁用）
- ✅ 设备管理和信任设备
- ✅ 双因素认证（2FA）
- ✅ 配置管理（公开/私有配置）
- ✅ 通知系统
- ✅ 操作日志记录
- ✅ API 文档自动生成
- ✅ 健康检查和监控
| 存储类型 | 状态 | 说明 |
|---|---|---|
| 本地存储 | ✅ | 本地文件系统存储 |
| 七牛云 | ✅ | 七牛云对象存储 |
| 腾讯云 COS | ✅ | 腾讯云对象存储 |
| 阿里云 OSS | ✅ | 阿里云对象存储 |
| MinIO | ✅ | 开源对象存储（S3 兼容） |
| AWS S3 | ✅ | Amazon S3 兼容存储 |
- Go: 1.21+
- Node.js: 18+
- 数据库: MySQL 8.0+ / PostgreSQL 13+ / SQLite
- Docker: 20.10+ (可选，用于 Docker 部署)
# 克隆项目
git clone https://github.com/LingByte/LingStorage.git
cd LingStorage
# 使用启动脚本
./docker-start.sh
# 或使用 docker-compose
docker-compose up -d访问地址：
- 前端界面: http://localhost:7075/admin
- API 文档: http://localhost:7075/api/docs
# 安装依赖
go mod download
# 配置环境变量
cp env.example .env
# 编辑 .env 文件
# 初始化数据库
go run cmd/bootstrap/main.go
# 启动服务器
go run cmd/server/main.gocd admin
# 安装依赖
npm install
# 或使用 pnpm
pnpm install
# 启动开发服务器
npm run dev- Go 1.21+ - 高性能后端语言
- Gin 1.9+ - 轻量级 Web 框架
- GORM 1.25+ - ORM 数据库操作
- MySQL/PostgreSQL/SQLite - 关系型数据库支持
- JWT/OAuth2 - 认证授权
- Zap - 高性能日志库
- React 18+ - 用户界面库
- TypeScript 5.0+ - 类型安全的 JavaScript
- Vite 4.0+ - 快速构建工具
- Tailwind CSS 3.0+ - 实用优先的 CSS 框架
- Framer Motion 10+ - 动画库
- Zustand - 状态管理
- React Router - 路由管理
- 本地存储 - 本地文件系统
- 七牛云 - 对象存储服务
- 腾讯云 COS - 对象存储服务
- 阿里云 OSS - 对象存储服务
- MinIO - 开源对象存储
- AWS S3 - Amazon S3 兼容存储
LingStorage/
├── cmd/ # 应用程序入口
│ ├── server/ # Web服务器
│ └── bootstrap/ # 数据库初始化
├── internal/ # 内部包
│ ├── handlers/ # HTTP处理器
│ ├── models/ # 数据模型
│ └── listeners/ # 事件监听器
├── pkg/ # 公共包
│ ├── auth/ # 认证授权
│ ├── storage/ # 存储管理
│ ├── config/ # 配置管理
│ ├── logger/ # 日志系统
│ ├── middleware/ # 中间件
│ └── utils/ # 工具函数
├── admin/ # 前端管理后台
│ ├── src/
│ │ ├── components/ # React组件
│ │ ├── pages/ # 页面组件
│ │ └── services/ # API服务
└── templates/ # 邮件模板
主要配置项（完整配置请参考 env.example）：
# 应用环境
APP_ENV=production
# 服务器配置
ADDR=:7075
SERVER_URL=http://localhost:7075
# 数据库配置
DB_DRIVER=sqlite
DSN=./ling.db
# 存储配置
STORAGE_KIND=local
UPLOAD_DIR=./uploads
# JWT 配置
JWT_SECRET_KEY=your-secret-key
JWT_ACCESS_TOKEN_TTL=3600STORAGE_KIND=local
UPLOAD_DIR=./uploadsSTORAGE_KIND=qiniu
QINIU_ACCESS_KEY=your-access-key
QINIU_SECRET_KEY=your-secret-key
QINIU_BUCKET=your-bucket
QINIU_DOMAIN=your-domainSTORAGE_KIND=cos
SECRET_ID=your-secret-id
SECRET_KEY=your-secret-key
REGION=ap-guangzhou
BUCKET_NAME=your-bucket更多配置请参考 部署指南
无需认证的文件上传接口，支持多种编程语言对接：
POST /api/public/upload
Content-Type: multipart/form-data
参数：
- file: 文件（必需）
- bucket: 存储桶名称（可选，默认：default）
- key: 文件存储路径（可选）
- allowedTypes: 允许的文件类型（可选，查询参数）响应示例：
{
"code": 200,
"message": "File uploaded successfully",
"data": {
"key": "uploads/1703123456_example.jpg",
"bucket": "default",
"filename": "example.jpg",
"size": 1024000,
"url": "http://localhost:7075/uploads/1703123456_example.jpg"
}
}项目提供了多种语言的对接示例：
- JavaScript/TypeScript - Fetch API、Axios
- React - 完整组件示例
- Java - Hutool 工具包
- Go - 标准库、go-resty
- gRPC - gRPC-Gateway 对接方案
详细示例请查看：文件上传接口对接文档
启动服务后访问：http://localhost:7075/api/docs
# 使用启动脚本
./docker-start.sh
# 或使用 docker-compose
docker-compose up -d# 创建 .env 文件
cp env.example .env
# 编辑 .env 配置
# 启动生产环境
docker-compose -f docker-compose.prod.yml up -d详细部署文档请参考：Docker 部署指南
我们欢迎所有形式的贡献！
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- Go: 使用
gofmt格式化代码，遵循 Go 官方代码规范 - TypeScript/React: 使用 ESLint 和 Prettier，遵循 React 最佳实践
本项目采用 MIT 许可证。
感谢所有为这个项目做出贡献的开发者！
如果这个项目对您有帮助，请给一个 ⭐ Star！
Made with ❤️ by LingByte Team