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

🔔 温馨提示

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

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

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

免责声明：本项目由 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 部署（推荐）

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

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

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

方式二：本地开发

1. 克隆项目

git clone https://github.com/ctwj/urldb.git
cd urldb

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 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              # 项目说明

🔧 配置说明

版本管理

项目使用GitHub进行版本管理，支持自动创建Release和标签。

版本管理脚本

# 显示当前版本信息
./scripts/version.sh show

# 更新版本号
./scripts/version.sh patch    # 修订版本 (1.0.0 -> 1.0.1)
./scripts/version.sh minor    # 次版本 (1.0.0 -> 1.1.0)
./scripts/version.sh major    # 主版本 (1.0.0 -> 2.0.0)

# 发布版本到GitHub
./scripts/version.sh release

# 生成版本信息文件
./scripts/version.sh update

# 查看帮助
./scripts/version.sh help

自动发布流程

更新版本号: 修改 VERSION 文件
同步文件: 更新 package.json、docker-compose.yml、README.md
创建Git标签: 自动创建版本标签
推送代码: 推送代码和标签到GitHub
创建Release: 自动创建GitHub Release

版本API接口

GET /api/version - 获取版本信息
GET /api/version/string - 获取版本字符串
GET /api/version/full - 获取完整版本信息
GET /api/version/check-update - 检查GitHub上的最新版本

版本信息页面

访问 /version 页面查看详细的版本信息和更新状态。

详细文档

查看 GitHub版本管理指南了解完整的版本管理流程。

环境变量配置

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

# 服务器配置
PORT=8080

Docker 服务说明

服务	端口	说明
frontend	3000	Nuxt.js 前端应用
backend	8080	Go API 后端服务
postgres	5432	PostgreSQL 数据库

📚 API 文档

公开统计

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

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

🤝 贡献指南

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

📄 许可证

本项目采用 GPL License 许可证。

🙏 致谢

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

Gin - Go Web框架
Nuxt.js - Vue.js全栈框架
Tailwind CSS - CSS框架
GORM - Go ORM库

📞 联系我们

项目地址: https://github.com/ctwj/urldb
问题反馈: Issues
邮箱: 510199617@qq.com

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

Made with ❤️ by [老九]

README.md Unescape Escape

🚀 urlDB - 网盘资源数据库

支持的网盘平台