{"id":19059632,"url":"https://github.com/zhoucheng133/virtual-directory","last_synced_at":"2025-09-25T11:45:50.494Z","repository":{"id":187676819,"uuid":"677352470","full_name":"Zhoucheng133/virtual-directory","owner":"Zhoucheng133","description":"文件分享工具","archived":false,"fork":false,"pushed_at":"2024-12-24T10:35:13.000Z","size":16125,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-22T01:44:08.235Z","etag":null,"topics":["filesharing","filesystem","virtualdisk"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zhoucheng133.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-11T11:04:57.000Z","updated_at":"2024-12-24T10:35:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"2647fdcb-ec7d-46cc-b1e5-da6f182f7a11","html_url":"https://github.com/Zhoucheng133/virtual-directory","commit_stats":null,"previous_names":["zhoucheng133/virtual-directory"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/Zhoucheng133/virtual-directory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhoucheng133%2Fvirtual-directory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhoucheng133%2Fvirtual-directory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhoucheng133%2Fvirtual-directory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhoucheng133%2Fvirtual-directory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zhoucheng133","download_url":"https://codeload.github.com/Zhoucheng133/virtual-directory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhoucheng133%2Fvirtual-directory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272793018,"owners_count":24993830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["filesharing","filesystem","virtualdisk"],"created_at":"2024-11-09T00:11:07.992Z","updated_at":"2025-09-25T11:45:45.463Z","avatar_url":"https://github.com/Zhoucheng133.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Virtual Directory\n\n\u003cimg src='build/icon.png' width=100 /\u003e\n\n![License](https://img.shields.io/badge/License-MIT-dark_green)\n\nUI网页端项目[在这里](https://github.com/Zhoucheng133/virtual-dir-page)\n\n## 经过测试的系统\n-  macOS 15\n-  Windows 11\n\n## 效果图\n\n### 服务端：\n\n![服务端截图](demo/demo1.png)\n\n### 客户端：\n\n![客户端截图](demo/demo2.png)\n\n### 视频预览\n\n![视频预览截图](demo/demo3.png)\n\n## 使用说明\n\n- 一般步骤：\n  1. 打开软件选择需要分享的目录\n  2. 选择是否要添加访问权限，即需要登录之后才能进行访问和操作\n  3. （如果选择了需要账户密码登录使用）设定用户名和密码\n  4. 输入合适的端口号，默认为`8081`，**注意不是所有的端口号都能使用**\n  5. 点击`启动服务`\n  6. 在局域网内可以通过`IPv4`地址访问到虚拟目录网站\n  7. 注意，如果你希望在局域网内/公网中访问到页面，**务必保证没有被防火墙拦截**\n\n- 使用WebDAV\n  1. 访问的客户端需要有可以连接WebDAV的工具，例如iOS端的Documents或者安卓端的ES文件管理器等\n  2. 勾选启用WebDAV服务，启动服务\n  3. 在Documents或其他可以访问WebDAV服务的软件中连接到WebDAV即可，地址为`\u003cip地址\u003e:\u003c端口号\u003e/dav`\n\n## 常见问题\n\n- 点击启动服务出现错误弹窗\n  1. 端口不允许，很多端口已经被系统占用，因此你不能使用这些端口\n  2. 分享了系统目录或者需要权限访问的目录，在Windows上这可能包括所有硬盘的根目录\n- 在局域网内无法访问到页面\n  - 很大概率是防火墙的问题，你可以先尝试在服务端机器上尝试是否可以正确打开，如果在服务端上可以正常打开，那你可能需要修改防火墙设置或者关闭防火墙，在Windows上在这里：`控制面板-\u003e所有控制面板项-\u003eWindows Defender 防火墙-\u003e允许的应用`，你需要手动将Virtual Directory添加到允许的应用\n- 视频/图片/音频无法预览\n  - 很大概率是编码问题，即便你使用第三方的播放器或者图片查看器可以正确打开，但是在网页端能够预览的编码格式有限\n\n## 更新日志\n\n### v4.1.3 (2024/12/24)\n- 添加了对macOS系统的支持\n- 修复一个问题\n\n\u003cdetails\u003e\n\u003csummary\u003e过往的版本\u003c/summary\u003e\n\n### v4.1.2 (2024/8/9)\n- 添加播放器中文支持\n\n### v4.1.1 (2024/7/30)\n- 修复Windows图标显示问题\n\n### v4.1.0 (2024/7/17)\n- 添加了WebDAV功能\n- 精简了一部分代码\n\n### v4.0.6 (2024/7/13)\n- 添加了分享路径合法性检查\n\n### v4.0.5 (2024/7/9)\n- 重构了下载逻辑\n\n### v4.0.4 (2024/7/3)\n- 修复无法下载单个文件的问题\n\n### v4.0.3 (2024/6/5)\n- 添加查看ip地址\n- 修复了一些错别字\n- 调整了一下界面\n\n- ### v4.0.2 (2024/5/11)\n  - 添加权限设置，包括读取，写入和删除的权限\n  - ~~添加简易模式（只允许上传）~~\n  \n- ### v4.0.1 (2024/5/10)\n  - (更新内容相较于v3.2.4)\n  - 使用Vue3+Vite+Electron重构\n  - 修复特殊字符问题\n  - 修复页面语言识别问题\n  - 修复无法拖拽上传的问题\n  - 改进了运行效率\n  - 改进了服务端界面布局\n\n- ### v4.0.0 Beta (2024/5/8) \n  - 使用Vue3+Vite+Electron重构\n  - 改进启动速度\n\n- ### v3.2.4 (2023/12/30)\n  - 修复在预览界面下载错误的问题\n\n- ### v3.2.3 (2023/12/18)\n  - 修复文件压缩完成才能下载的问题\n  - 修复预览图片时客户端读写压力过大的问题\n\n- ### v3.2.2 (2023/12/16)\n  - 大幅提高网格视图下预览图片的效率\n  - 修复无法下载单个文件夹的问题\n\n- ### v3.2.1 (2023/12/14)\n  - 添加网格视图\n  - 添加文件夹/文件混合下载功能\n\n- ### v3.2.0 (2023/12/3)\n  - 添加了文件夹下载的功能\n  - 修复上传文件的身份认证问题\n\n- ### v3.1.1 (2023/12/1)\n  - 更新身份验证策略\n  - 修复页面切换问题\n  - 修复含有特殊字符图片无法预览的问题\n\n- ### v3.1.0 (2023/11/30)\n  - 添加多文件下载\n  - 添加显示已经上传的文件大小\n  - 添加对m4a的支持\n  - 改进标题栏和工具栏\n  - 改进排序规则\n  - 改进下载按钮\n  - 修复上传失败后没有刷新页面的问题\n  - 修复右键菜单删除文件的错误\n\n- ### v3.0.0 (2023/11/26)\n  - 使用Webpack重新开发了客户端页面\n  - 改进图标的显示\n  - 使用客户端页面登录\n  - 添加查看上传进度功能\n  - 右键菜单添加了下载按钮\n  - 修复视频需要加载完成才能播放的问题\n  - 修复多选时右键菜单识别错误\n\n- ### v2.1.0 (2023/9/11)\n  - 添加一些文件的预览功能\n  - 对于不识别的文件直接下载\n\n- ### v2.0.5 (2023/8/21)\n  - 添加拖拽上传功能\n  - 修复出错没有提示的bug\n\n- ### v2.0.4 (2023/8/2)\n  - 添加懒加载\n  - 修复网格布局错误\n\n- ### v2.0.3 (2023/7/28)\n  - 超长文件名简写\n  - 支持图片缩略图\n  - 增加点击路径跳转\n  - 增加文件显示方式\n  - 调整页面布局\n\n- ### v2.0.2 (2023/7/26)\n  - 解决视频无法跳转进度条的问题\n  - 新标签页打开文件\n  - 修改程序逻辑\n\n- ### v2.0.1 (2023/7/23)\n  - 支持上传多个文件\n  - ~~支持上传目录~~\n  - 解决上传失败没有提示的bug\n  - 添加全选按钮\n  - 兼容Linux系统\n\n- ### v2.0 (2023/7/21)\n  - 增加上传文件的功能\n  - 增加删除文件的功能\n  - 增加重命名文件/文件夹功能\n  - 修改样式表的一些bug\n  - 添加右键菜单\n  - 弹窗适配移动端\n\n- ### v1.0.5 (2023/7/12)\n  - 完善浏览器端界面\n  - 浏览器端界面添加了很多文件图标\n\n- ### v1.0.4 (2023/7/8)\n  - 完善启动判定\n  - 增加对Apple Silicon的支持\n\n- ### v1.0.3 (2023/7/7)\n  - 避免Windows用户选中系统文件夹\n  - 避免macOS用户选中根目录\n  - 解决重复调用函数的问题\n  - 在macOS上点击红色按钮修改为退出（原先为关闭窗口）\n\n- ### v1.0.2 (2023/7/6)\n  - 解决下载文件名乱码的问题\n  - 解决下载文件时无法获取文件大小和剩余时间的问题\n  - 增加记住上一次输入的功能\n\n- ### v1.0.1 (2023/7/5)\n  - 增加图标\n  - 改进Windows界面\n  - 对IPv6不支持的情况做提示\n  - 启动失败提示\n\n- ### v1.0 (2023/7/5)\n  - 第一个版本\n\u003c/details\u003e\n\n## 关于配置\n如果你希望在自己的电脑中配置该项目，以下为操作步骤：\n\n你需要安装`Node.js`，至少需要`Node.js@18`，本人开发环境的版本是`Node.js@18.20.2`，并且安装了`yarn`包管理器\n\n```bash\nnpm install yarn -g\n```\n\n通过下面的命令来安装所需要的依赖：\n```bash\ncd [本项目地址]\nyarn install\n```\n\n如果你希望打包，可以使用下面的命令\n```bash\nyarn run build\n# 如果是Windows系统\nyarn run electron-builder --win\n# 如果是macOS系统\nyarn run electron-builder --mac\n# 如果是Linux系统 (不确保可以正确地运行在Linux系统上)\nyarn run electron-builder --linux\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhoucheng133%2Fvirtual-directory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhoucheng133%2Fvirtual-directory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhoucheng133%2Fvirtual-directory/lists"}