https://github.com/xxcheng123/cloudpan189-share
CloudPan189 Share 是一款专为天翼云盘设计的智能文件分享管理工具。该系统能够将天翼云盘的分享链接转换为标准的目录结构，并通过 WebDAV 协议提供统一的文件访问接口。
https://github.com/xxcheng123/cloudpan189-share
cloudpan189 golang strm webdav
Last synced: 5 months ago
JSON representation
CloudPan189 Share 是一款专为天翼云盘设计的智能文件分享管理工具。该系统能够将天翼云盘的分享链接转换为标准的目录结构，并通过 WebDAV 协议提供统一的文件访问接口。
- Host: GitHub
- URL: https://github.com/xxcheng123/cloudpan189-share
- Owner: xxcheng123
- License: mit
- Created: 2025-08-02T17:26:23.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-09-27T07:31:56.000Z (8 months ago)
- Last Synced: 2025-09-27T09:29:06.725Z (8 months ago)
- Topics: cloudpan189, golang, strm, webdav
- Language: Vue
- Homepage:
- Size: 1.03 MB
- Stars: 76
- Watchers: 1
- Forks: 17
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CloudPan189 Share
一个基于天翼云盘的文件分享和管理系统，提供 WebDAV 接口和 Web 管理界面。
## 🚧 提示
自动刷新有点问题，正在重构，有问题先提issue
## 🚀 项目简介
CloudPan189 Share 是一款专为天翼云盘设计的智能文件分享管理工具。该系统能够将天翼云盘的分享链接转换为标准的目录结构，并通过 WebDAV 协议提供统一的文件访问接口。
## ✨ 核心功能
**🔄 智能链接转换**
- 解析天翼云盘分享链接，转换为标准目录树结构
- 支持多层级文件夹映射，保持原有组织架构
**🌐 WebDAV 统一接口**
- 提供标准 WebDAV 协议支持，兼容主流客户端
- 统一文件访问入口，简化多链接管理流程
- 完整的文件锁定机制，确保并发安全
**💻 全功能网页端**
- 现代化文件浏览器界面，支持文件夹导航
- 支持在线下载、搜索功能
- 内置媒体播放器，支持视频、音频在线预览
**⚡ 高性能流媒体**
- 多线程并发传输，提升大文件访问速度
- 流式播放技术，实现视频无缓冲即时观看
- 智能带宽适配，确保播放流畅度
**📁 媒体目录映射**
- 将云盘文件通过strm形式映射到本地media_dir目录
- 完美兼容Emby、Jellyfin、Plex等媒体服务器
- 可自定义支持的视频格式列表
- 支持一键重建和批量管理
## 🚀 快速开始
### Docker 部署（推荐）
```sh
docker run -d \
--name cloudpan189-share \
-p 12395:12395 \
-v $(pwd)/data:/app/data \
-v $(pwd)/media_dir:/app/media_dir \
--restart unless-stopped \
xxcheng123/cloudpan189-share:latest
```
更多请参考文档：[CloudPan189 Share 快速开始文档](docs/1.quick_start.md)
### 访问系统
- Web 界面: `http://服务器IP:12395`
- WebDAV 地址: `http://服务器IP:12395/dav`
### 初始化设置
1. 首次打开会进入初始化页面
2. 登录后在"令牌管理"中添加天翼云盘令牌
3. 在"存储管理"中配置存储源
4. 开始使用文件管理功能
## 📁 WebDAV 挂载说明
### 挂载地址格式
```
http(s)://你的网站地址/dav
```
### 示例地址
```
http://localhost:12395/dav
```
### 支持的客户端
- **Windows**: 网络驱动器映射、RaiDrive、WinSCP
- **macOS**: Finder 连接服务器、Cyberduck
- **Linux**: davfs2、文件管理器（Nautilus、Dolphin）
- **移动端**: ES文件浏览器、Solid Explorer、FE文件管理器
- **专业工具**: Cyberduck、FileZilla Pro
### 挂载步骤
1. 打开支持 WebDAV 的客户端
2. 输入服务器地址：`http://你的域名或IP:端口/dav`
3. 输入认证信息（如需要）
4. 连接成功后即可像本地磁盘一样使用
### 注意事项
- 确保服务正常运行且端口可访问
- 部分客户端可能需要启用不安全连接（HTTP）
- 建议在生产环境中使用 HTTPS 协议
## 🛠️ 技术栈
### 后端
- **语言**: Go 1.24
- **框架**: Gin
- **数据库**: SQLite (GORM)
- **认证**: JWT
### 前端
- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite
- **状态管理**: Pinia
## 📦 开发部署
### 环境要求
- Go 1.24+
- Node.js 22+
- npm 或 yarn 或 pnpm
### 1. 克隆项目
```bash
git clone https://github.com/xxcheng123/cloudpan189-share.git
cd cloudpan189-share
```
### 2. 后端部署
```bash
# 安装依赖
go mod tidy
# 构建项目
make build
# 或直接运行
go run cmd/main.go
```
### 3. 前端部署
```bash
# 进入前端目录
cd fe
# 安装依赖
npm install
# 开发模式
npm run dev
# 构建生产版本
npm run build
```
### 4. 配置文件
编辑 `etc/config.yaml` 配置文件：
```yaml
port: 12395 # 服务端口
dbFile: "data/share.db" # 数据库文件路径
logFile: "logs/share.log" # 日志文件路径
mediaDir: "media_dir" # 媒体文件映射目录
```
### 5. 启动服务
```bash
# 启动后端服务
go run cmd/main.go
# 启动前端开发服务器（另一个终端）
cd fe && npm run dev
```
### 6. 访问开发环境
- 前端界面: http://localhost:5173
- 后端 API: http://localhost:12395
- WebDAV 地址: http://localhost:12395/dav
## 🔧 开发指南
### 项目结构
```
cloudpan189-share/
├── cmd/ # 主程序入口
├── configs/ # 配置管理
├── etc/ # 配置文件
├── fe/ # 前端项目
│ ├── src/
│ │ ├── api/ # API 接口
│ │ ├── components/ # 组件
│ │ ├── stores/ # 状态管理
│ │ ├── utils/ # 工具函数
│ │ └── views/ # 页面组件
├── internal/ # 内部模块
│ ├── jobs/ # 后台任务
│ ├── models/ # 数据模型
│ ├── router/ # 路由
│ └── services/ # 业务服务
└── logs/ # 日志文件
```
### API 接口
- `/api/user/*` - 用户管理
- `/api/cloudtoken/*` - 令牌管理
- `/api/storage/*` - 存储管理
- `/api/setting/*` - 系统设置
- `/dav/*` - WebDAV 接口
## ❓ 常见问题
### WebDAV 连接失败
- 检查防火墙设置，确保端口开放
- 某些客户端需要在地址末尾添加 `/`
- Windows 网络驱动器可能需要启用基本认证
### 文件播放卡顿
- 检查网络带宽和服务器性能
- 尝试降低播放质量
- 确保天翼云盘令牌有效
### 令牌失效问题
- 定期检查令牌状态
- 及时更新过期令牌
- 建议配置多个备用令牌
### Docker 相关问题
- 确保 Docker 服务正常运行
- 检查端口映射是否正确
- 数据卷挂载路径是否有权限
## 🤝 贡献
我们欢迎各种形式的贡献，包括但不限于提交 Bug 报告、功能请求、文档改进和代码贡献。请在提交之前阅读我们的贡献指南（如果可用）。
## 📄 许可证
本项目采用 MIT 许可证。详情请参阅 `LICENSE` 文件。
## 🙏 致谢
感谢所有为本项目做出贡献的开发者和社区成员。
## 💬 支持
如果您在使用过程中遇到任何问题，可以通过以下方式获得支持：
- 提交 GitHub Issue
- 查阅项目文档
- 参与社区讨论
---
⭐ 如果这个项目对您有帮助，请给它一个 Star！