基于火山引擎TOS的个人网盘 🚀 从不靠谱到靠谱的路上

bkp-drive 是一个基于火山引擎对象存储(TOS)服务构建的网盘服务。项目基于 TOS Go SDK 开发.

• 用户注册: 支持用户账号注册，自动生成唯一用户ID（bkp-前缀）
• 用户登录: JWT令牌认证，支持记住登录状态
• 权限控制: 所有文件操作需要登录验证

• 文件上传: 支持单文件和文件夹批量上传
• 文件下载: 安全的认证下载功能
• 文件删除: 支持单文件和批量删除
• 文件夹操作: 创建文件夹、文件夹导航
• 文件预览: 图片在线预览（缩略图功能开发中）

• Apple风格首页: 现代化的用户界面设计
• 响应式设计: 支持桌面和移动设备
• 网格/列表视图: 多种文件显示模式
• 面包屑导航: 便捷的文件路径导航

# TOS 存储配置
export TOS_ENDPOINT="your-tos-endpoint"
export TOS_REGION="your-region" 
export TOS_ACCESS_KEY="your-access-key"
export TOS_SECRET_KEY="your-secret-key"
export TOS_BUCKET_NAME="your-bucket-name"

# MySQL 数据库配置
export MYSQL_USERNAME="your-mysql-username"
export MYSQL_PASSWORD="your-mysql-password"
export MYSQL_HOST="localhost"
export MYSQL_PORT="3306"
export MYSQL_DATABASE="bkp_drive"

export JWT_SECRET="jwt_secret_key"

# 执行数据库初始化脚本
mysql -u root -p < scripts/init_db.sql

# 安装依赖
go mod tidy

# 启动服务器
go run cmd/server/main.go

• 首页: http://localhost:18666/ (Apple风格首页)
• 网盘功能: http://localhost:18666/pan.html (文件管理界面)
• 用户登录: http://localhost:18666/login.html
• 用户注册: http://localhost:18666/register.html
• API文档: http://localhost:18666/swagger/index.html
• 健康检查: http://localhost:18666/health

访问 http://localhost:18666/swagger/index.html 查看完整的API文档

• main.go: 服务器启动和路由配置
• file_handler.go: 基础文件操作（上传、下载、删除、列表）
• advanced_handler.go: 高级功能（批量操作、搜索、统计）
• share_handler.go: 文件分享和权限管理

• client.go: TOS客户端连接和认证
• operations.go: 基础存储操作（GetObject、PutObject等）
• advanced_operations.go: 批量操作和搜索功能

• 环境变量管理和TOS连接配置
• 服务器端口和CORS设置

• 响应式Web界面和Electron桌面应用
• 文件上传、预览、批量操作交互
• 图片和视频缩略图显示

• Swagger自动生成的API文档
• 支持在线测试和接口说明

• 后端: Go 1.23.4, Gin Web框架
• 存储: 火山引擎TOS对象存储
• 数据库: MySQL 8.0
• 认证: JWT令牌
• 前端: HTML5, CSS3, Vanilla JavaScript
• 桌面: Electron（计划中）
• 文档: Swagger/OpenAPI 3.0
• 依赖管理: Go Modules

• 火山引擎对象存储TOS API文档
• TOS Go SDK文档
• Gin Web框架文档
• Swagger/OpenAPI文档

Apache-2.0

• 感谢 Jinpu Hu 对本项目的前端架构建议

• 感谢 Weibin Ma 对 ai 相关技术的讲解

• 感谢 claude code 和 instcopilot 提供 ai 相关能力