lsdrive

✨ 特性

🔥 核心功能

🎯 技术特性

🚀 快速开始

使用 Docker(推荐)

# 克隆项目
git clone https://github.com/your-repo/lsdrive.git
cd lsdrive
# 使用 Docker Compose 启动
docker-compose up -d
# 或使用部署脚本
./docker/deploy.sh

从源码构建

# 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# 克隆并构建
git clone https://github.com/your-repo/lsdrive.git
cd lsdrive
cargo build --release
# 运行
./target/release/lsdrive server

前端开发

cd web
npm install
npm run dev

📖 使用说明

基本配置

# 数据库配置
database_url = "sqlite:./lsdrive.db"
# 服务器配置
[server]
host = "127.0.0.1"
port = 8080
# 存储后端配置
[storage_backends.local]
type = "Local"
root_path = "./storage"

存储配置

阿里云盘

[storage_backends.aliyun]
type = "AliyunDrive"
refresh_token = "your_refresh_token"
client_id = "your_client_id"
client_secret = "your_client_secret"

OneDrive

[storage_backends.onedrive]
type = "OneDrive"
client_id = "your_client_id"
client_secret = "your_client_secret"
redirect_uri = "http://localhost:8080/auth/callback"

API 使用

REST API

# 获取文件列表
curl http://localhost:8080/api/files
# 创建分享
curl -X POST http://localhost:8080/api/shares \
 -H "Content-Type: application/json" \
 -d '{"name":"test.txt","path":"/test.txt"}'

GraphQL

query {
 files(path: "/") {
 edges {
 node {
 id
 name
 size
 isDir
 }
 }
 }
}

WebDAV 访问

# 挂载为网络驱动器
# Windows: \\localhost:8080\webdav
# macOS/Linux: http://localhost:8080/webdav

🏗️ 架构设计

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Web UI │ │ REST API │ │ GraphQL API │
│ (React) │ │ (Axum) │ │ (async-graphql)│
└─────────────────┘ └─────────────────┘ └─────────────────┘
 │ │ │
 └───────────────────────┼───────────────────────┘
 │
┌─────────────────────────────────┼─────────────────────────────────┐
│ 应用服务层 │ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐│
│ │ 文件管理 │ │ 用户认证 │ │ 分享管理 │ │ 下载管理 ││
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘│
└─────────────────────────────────┼─────────────────────────────────┘
 │
┌─────────────────────────────────┼─────────────────────────────────┐
│ VFS 引擎 │ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐│
│ │ 本地存储 │ │ 阿里云盘 │ │ OneDrive │ │ 百度网盘 ││
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘│
└─────────────────────────────────────────────────────────────────┘

🛠️ 开发指南

项目结构

lsdrive/
├── crates/ # Rust Crates
│ ├── lsdrive-core/ # 核心库
│ ├── lsdrive-vfs/ # VFS 引擎
│ ├── lsdrive-api/ # API 服务
│ ├── lsdrive-storage-*/ # 存储适配器
│ ├── lsdrive-webdav/ # WebDAV 服务
│ ├── lsdrive-preview/ # 文件预览
│ ├── lsdrive-downloader/ # 下载管理
│ ├── lsdrive-share/ # 分享管理
│ └── lsdrive-cli/ # 命令行工具
├── web/ # 前端代码
├── tests/ # 测试文件
├── docker/ # Docker 配置
└── docs/ # 文档

添加新的存储适配器

cargo new --lib crates/lsdrive-storage-newtype

use lsdrive_vfs::StorageBackend;
#[async_trait]
impl StorageBackend for NewTypeBackend {
 async fn list_directory(&self, path: &str) -> Result<Vec<VfsNode>> {
 // 实现目录列表
 }
 
 // 实现其他必需方法
}

运行测试

# 运行所有测试
cargo test
# 运行特定测试
cargo test --test integration_tests
# 性能测试
cargo test --test simple_performance --release

生成文档

# 生成 API 文档
cargo doc --open
# 构建用户文档
cd docs && mdbook build

🐳 Docker 部署

基础部署

# 基础服务
docker-compose up -d
# 包含 nginx 反向代理
docker-compose --profile nginx up -d
# 包含 PostgreSQL 数据库
docker-compose --profile postgres up -d

生产环境部署

# 使用部署脚本
./docker/deploy.sh --with-nginx --with-postgres up
# 查看服务状态
./docker/deploy.sh status
# 查看日志
./docker/deploy.sh logs

环境变量

📊 性能优化

缓存配置

[performance]
metadata_cache_size_mb = 256
file_cache_size_mb = 1024
db_pool_size = 20

并发设置

[performance]
max_concurrent_uploads = 10
max_concurrent_downloads = 20
worker_threads = 8

监控指标

🔒 安全配置

启用认证

[security]
enable_auth = true
jwt_secret = "your-super-secret-key"
token_expiry_hours = 24

HTTPS 配置

# 生成 SSL 证书
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
 -keyout key.pem -out cert.pem
# 配置 nginx 反向代理
./docker/deploy.sh --with-nginx up

🤝 贡献指南

代码规范

📝 许可证