urldb/README.md

# 🚀 urlDB - 老九网盘资源数据库

<div align="center">

![Go Version](https://img.shields.io/badge/Go-1230?logo=go&logoColor=white)
![Vue Version](https://img.shields.io/badge/Vue-334FC08D?logo=vue.js&logoColor=white)
![Nuxt Version](https://img.shields.io/badge/Nuxt-300.8+-00DC82?logo=nuxt.js&logoColor=white)
![License](https://img.shields.io/badge/License-GPL%20v3-blue.svg)
![PostgreSQL](https://img.shields.io/badge/PostgreSQL-15+-336791go=postgresql&logoColor=white)

**一个现代化的网盘资源数据库，支持多网盘自动化转存分享，支持百度网盘，阿里云盘，夸克网盘， 天翼云盘，迅雷云盘，123云盘，115网盘，UC网盘 **

🌐 [在线演示](https://pan.l9.lc) | 📖 [文档](http://doc.l9.lc/) | 🐛 [问题反馈](https://github.com/ctwj/urldb/issues) | ⭐ [给个星标](https://github.com/ctwj/urldb)

### 支持的网盘平台

| 平台 | 录入 | 转存 | 分享 |
|------|-------|-----|------|
| 百度网盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| 阿里云盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| 夸克网盘 | ✅ 支持 | ✅ 支持 | ✅ 支持 |
| 天翼云盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| 迅雷云盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| UC网盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| 123云盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |
| 115网盘 | ✅ 支持 | 🚧 开发中 | 🚧 开发中 |

</div>

---

## 🔔 温馨提示

📌 **本项目仅供技术交流与学习使用**，自身不存储或提供任何资源文件及下载链接。

📌 **请勿将本项目用于任何违法用途**，否则后果自负。

📌 如有任何问题或建议，欢迎交流探讨！ 😊

> **免责声明**：本项目由 Trae AI 辅助编写。由于时间有限，仅在空闲时维护。如遇使用问题，请优先自行排查，感谢理解！

---

## ✨ 功能特性

### 🎯 核心功能
- **📁 多平台网盘支持** - 支持夸克网盘、阿里云盘、百度网盘、UC网盘
- **🔍 公开API** - 支持API数据录入，资源搜索
- **🏷️ 自动预处理** - 系统自动处理资源， 对数据进行有效性判断
- **📊 自动转存分享** - 有效资源，如果属于支持类型将自动转存分享
- **📱 多账号管理** - 同平台支持多账号管理

## 🏗️ 技术架构

### 后端技术栈
- **🦀 Golang 10.23+** - 高性能后端语言
- **🌿 Gin** - 轻量级Web框架
- **🗄️ PostgreSQL** - 关系型数据库
- **🔧 GORM** - ORM框架
- **🔐 JWT** - 身份认证

### 前端技术栈
- **⚡ Nuxt.js 3** - Vue.js全栈框架
- **🎨 Vue 3** - 渐进式JavaScript框架
- **📝 TypeScript** - 类型安全的JavaScript
- **🎨 Tailwind CSS** - 实用优先的CSS框架
- **🔧 Pinia** - 状态管理

---

## 🚀 快速开始

### 环境要求

- **Docker** 和 **Docker Compose**
- 或者本地环境：
  - **Go** 1.23+
  - **Node.js** 18+
  - **PostgreSQL** 15+
  - **pnpm** (推荐) 或 npm

### 方式一：Docker 部署（推荐）

```bash
# 克隆项目
git clone https://github.com/ctwj/urldb.git
cd urldb

# 使用 Docker Compose 启动
docker compose up --build -d

# 访问应用
# 前端: http://localhost:3030
# 后端API: http://localhost:8080
```

### 方式二：本地开发

#### 1. 克隆项目
```bash
git clone https://github.com/ctwj/urldb.git
cd urldb
```

#### 2. 后端设置
```bash
# 复制环境变量文件
cp env.example .env

# 编辑环境变量
vim .env

# 安装Go依赖
go mod tidy

# 启动后端服务
go run main.go
```

#### 3. 前端设置
```bash
# 进入前端目录
cd web

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev
```

#### 4. 数据库设置
```sql
-- 创建数据库
CREATE DATABASE url_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/                   # 项目文档
├── 📁 nginx/                  # Nginx配置
│   ├── 📄 nginx.conf         # 主配置文件
│   └── 📁 conf.d/            # 站点配置
├── 📄 main.go                # 主程序入口
├── 📄 Dockerfile             # Docker配置
├── 📄 docker-compose.yml     # Docker Compose配置
├── 📄 docker-start-nginx.sh  # Nginx启动脚本
└── 📄 README.md              # 项目说明
```

---

## 🔧 配置说明

### 环境变量配置

```bash
# 数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=your_password
DB_NAME=url_db

# 服务器配置
PORT=8080
```

### Docker 服务说明

| 服务 | 端口 | 说明 |
|------|------|------|
| server | 3030 | 应用 |
| postgres | 5431 | PostgreSQL 数据库 |

### 镜像构建

```
docker build -t ctwj/urldb-frontend:1.0.7 --target frontend .
docker build -t ctwj/urldb-backend:1.0.7 --target backend .
docker push ctwj/urldb-frontend:1.0.7
docker push ctwj/urldb-backend:1.0.7
```

---

## 📚 API 文档

### 公开统计

提供，批量入库和搜索api，通过 apiToken 授权

> 📖 完整API文档请访问：`http://doc.l9.lc/`

## 🤝 贡献指南

我们欢迎所有形式的贡献！

## 📄 许可证

本项目采用 [GPL License](LICENSE) 许可证。

---

## 🙏 致谢

感谢以下开源项目的支持：

- [Gin](https://github.com/gin-gonic/gin) - Go Web框架
- [Nuxt.js](https://nuxt.com/) - Vue.js全栈框架
- [Tailwind CSS](https://tailwindcss.com/) - CSS框架
- [GORM](https://gorm.io/) - Go ORM库

---

## 📞 联系我们

- **项目地址**: [https://github.com/ctwj/urldb](https://github.com/ctwj/urldb)
- **问题反馈**: [Issues](https://github.com/ctwj/urldb/issues)
- **邮箱**: 510199617@qq.com

---

<div align="center">

**如果这个项目对您有帮助，请给我们一个 ⭐ Star！**

Made with ❤️ by [老九]

</div>