mirror of
https://github.com/ctwj/urldb.git
synced 2025-11-25 03:15:04 +08:00
0134b728d333a459e7754e85688cb774edecd242
🚀 panResManage - 网盘资源管理系统
✨ 功能特性
🎯 核心功能
- 📁 多平台网盘支持 - 支持夸克网盘、阿里云盘、百度网盘、UC网盘
- 🔍 智能搜索 - 全文搜索、标签筛选、分类浏览
- 📊 数据统计 - 资源统计、搜索分析、热门关键词
- 🏷️ 标签系统 - 灵活的标签管理和资源分类
🛠️ 管理功能
- 📦 批量操作 - 批量添加、导入、管理资源
- 🔄 自动处理 - 待处理资源自动转存和分享
- 📈 热播剧管理 - 热门影视资源自动更新
- ⚙️ 系统配置 - 灵活的系统参数配置
🎨 用户体验
- 📱 响应式设计 - 支持桌面端和移动端
- 🌙 深色模式 - 支持明暗主题切换
- ⚡ 高性能 - 基于Go的高并发后端
- 🎯 现代化UI - 基于Tailwind CSS的美观界面
🏗️ 技术架构
后端技术栈
- 🦀 Golang 10.23+ - 高性能后端语言
- 🌿 Gin - 轻量级Web框架
- 🗄️ PostgreSQL - 关系型数据库
- 🔧 GORM - ORM框架
- 🔐 JWT - 身份认证
前端技术栈
- **⚡ Nuxt.js 3 - Vue.js全栈框架
- 🎨 Vue 3 - 渐进式JavaScript框架
- 📝 TypeScript - 类型安全的JavaScript
- 🎨 Tailwind CSS - 实用优先的CSS框架
- 🔧 Pinia - 状态管理
开发工具
- 🐳 Docker - 容器化部署
- 📦 pnpm - 快速包管理器
- 🔍 Air - Go热重载工具
🚀 快速开始
环境要求
- Go1.23+
- Node.js 18+
- PostgreSQL 15+
- pnpm (推荐) 或 npm
方式一:Docker 部署(推荐)
# 克隆项目
git clone https://github.com/ctwj/panResManage.git
cd panResManagepan.git
cd l9pan
# 使用 Docker Compose 启动
docker-compose up -d
# 访问应用
open http://localhost:8080
方式二:本地开发
1. 克隆项目
git clone https://github.com/ctwj/panResManage.git
cd panResManage
2 后端设置
# 复制环境变量文件
cp env.example .env
# 编辑环境变量
vim .env
# 安装Go依赖
go mod tidy
# 启动后端服务
go run main.go
3 前端设置
# 进入前端目录
cd web
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev
4. 数据库设置
-- 创建数据库
CREATE DATABASE res_db;
📁 项目结构
l9pan/
├── 📁 common/ # 通用功能模块
│ ├── 📄 pan_factory.go # 网盘工厂模式
│ ├── 📄 alipan.go # 阿里云盘实现
│ ├── 📄 baidu_pan.go # 百度网盘实现
│ ├── 📄 quark_pan.go # 夸克网盘实现
│ └── 📄 uc_pan.go # UC网盘实现
├── 📁 db/ # 数据库层
│ ├── 📁 entity/ # 数据实体
│ ├── 📁 repo/ # 数据仓库
│ ├── 📁 dto/ # 数据传输对象
│ └── 📁 converter/ # 数据转换器
├── 📁 handlers/ # API处理器
├── 📁 middleware/ # 中间件
├── 📁 utils/ # 工具函数
├── 📁 web/ # 前端项目
│ ├── 📁 pages/ # 页面组件
│ ├── 📁 components/ # 通用组件
│ ├── 📁 composables/ # 组合式函数
│ └── 📁 stores/ # 状态管理
├── 📁 docs/ # 项目文档
├── 📄 main.go # 主程序入口
├── 📄 Dockerfile # Docker配置
├── 📄 docker-compose.yml # Docker Compose配置
└── 📄 README.md # 项目说明
🔧 配置说明
环境变量配置
# 数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=your_password
DB_NAME=res_db
# 服务器配置
PORT=8080
支持的网盘平台
| 平台 | 状态 | 功能 |
|---|---|---|
| 夸克网盘 | ✅ 支持 | 转存、分享 |
| 阿里云盘 | 🚧 开发中 | 转存、分享 |
| 百度网盘 | 🚧 开发中 | 转存、分享 |
| UC网盘 | 🚧 开发中 | 转存、分享 |
📚 API 文档
公开统计
提供,批量入库和搜索api,通过 apiToken 授权
📖 完整API文档请访问:
http://p.l9.lc/doc.html
🤝 贡献指南
我们欢迎所有形式的贡献!
如何贡献
1Fork 本仓库2 创建 功能分支 (git checkout -b feature/AmazingFeature)
3** 更改 (git commit -mAdd some AmazingFeature')
4. 推送 到分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request
📄 许可证
本项目采用 MIT License 许可证。
MIT License
Copyright (c) 2024 L9Pan
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
🙏 致谢
感谢以下开源项目的支持:
- Gin - Go Web框架
- Nuxt.js - Vue.js全栈框架
- Tailwind CSS - CSS框架
- GORM - Go ORM库
📞 联系我们
- 项目地址: https://github.com/ctwj/panResManage
- 问题反馈: Issues
- 邮箱: 510199617@qq.com
如果这个项目对您有帮助,请给我们一个 ⭐ Star!
Made with ❤️ by [老九]
Languages
Go
47.1%
Vue
45.8%
TypeScript
5.8%
Shell
1%