{"id":24350839,"url":"https://github.com/zzhow1024/magicshare","last_synced_at":"2026-03-06T03:31:35.904Z","repository":{"id":272268949,"uuid":"915646127","full_name":"ZZHow1024/MagicShare","owner":"ZZHow1024","description":"MagicShare is a cross-platform intranet file sharing tool. MagicShare 是一款跨平台的内网文件分享工具。","archived":false,"fork":false,"pushed_at":"2025-05-12T16:00:33.000Z","size":3351,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T16:39:54.535Z","etag":null,"topics":["java","javafx","javascript","magic-share","springboot","vuejs","zzhow"],"latest_commit_sha":null,"homepage":"https://www.zzhow.com/MagicShare","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZZHow1024.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,"zenodo":null}},"created_at":"2025-01-12T12:36:07.000Z","updated_at":"2025-05-12T15:39:53.000Z","dependencies_parsed_at":"2025-02-07T12:21:52.194Z","dependency_job_id":"4d7ba010-40c6-4d5f-ade9-3eb22f34e836","html_url":"https://github.com/ZZHow1024/MagicShare","commit_stats":null,"previous_names":["zzhow1024/magicshare"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ZZHow1024/MagicShare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZZHow1024%2FMagicShare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZZHow1024%2FMagicShare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZZHow1024%2FMagicShare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZZHow1024%2FMagicShare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZZHow1024","download_url":"https://codeload.github.com/ZZHow1024/MagicShare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZZHow1024%2FMagicShare/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30160848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T22:39:40.138Z","status":"online","status_checked_at":"2026-03-06T02:00:08.268Z","response_time":250,"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":["java","javafx","javascript","magic-share","springboot","vuejs","zzhow"],"created_at":"2025-01-18T14:06:19.241Z","updated_at":"2026-03-06T03:31:35.869Z","avatar_url":"https://github.com/ZZHow1024.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 神奇分享_**MagicShare**（中文说明）\n\n[**English**](./README_EN.md)\n\n---\n\nWebsite:\n\n[神奇分享_MagicShare（中文说明） | ZZHow](https://www.zzhow.com/MagicShare)\n\nSource Code:\n\nhttps://github.com/ZZHow1024/MagicShare\n\nReleases:\n\nhttps://github.com/ZZHow1024/MagicShare/releases\n\n---\n\n## 它是什么？\n\nMagicShare 是一款跨平台的内网文件分享工具，发送方使用桌面客户端选择需要分享的文件，接收方使用 Web 页面下载分享的文件。\n\n---\n\n## 技术路线\n\n![TechnicalRoute.png](./TechnicalRoute.png)\n\n- 编程语言：**Java** 和 **JavaScript**\n\n---\n\n## 许可证\n\n该项目根据 GNU 通用公共许可证 v3.0 获得许可 - 有关详细信息，请参阅 [LICENSE](https://github.com/ZZHow1024/MagicShare/blob/main/LICENSE) 文件。\n\n---\n\n## 用户许可协议\n\n**使用本软件前，请仔细阅读：**\n\n- 合法使用：本软件仅限于合法文件分享，严禁分享任何侵犯版权、涉及色情、暴力、欺诈、违法或其他有害内容的文件。\n- 个人责任：您对分享内容的合法性负全部责任，请确保您拥有分享文件的合法授权。\n- 风险提示：本软件无法保证所分享文件的安全性，请您自行检查文件的安全性。\n- 免责声明：软件作者不对因使用本软件造成的任何直接或间接损失承担责任。\n\n使用 MagicShare 须同意并遵守以上内容。\n\n---\n\n## 使用说明\n\n下载地址：\n\nhttps://github.com/ZZHow1024/MagicShare/releases\n\n### 桌面客户端\n\n- 确定您使用的操作系统。\n    - Linux：\n        - 选择 .deb安装包（Debian, Ubuntu） / .rpm（Red Hat, Fedora, SUSE）安装包。\n    - macOS：\n        - 确定您使用的 Mac 的芯片(Apple Silicon / Intel)。\n        - 选择 .dmg磁盘镜像 / .pkg安装包。\n    - Windows：\n        - 选择 .zip压缩包 / .exe安装包 / .msi安装包。\n    - 通用：\n        - 选择 .jar包（计算机需要配置好 JRE）\n- 下载对应的文件。\n- Linux 和 macOS 需要执行安装操作后再运行，Windows 可直接运行 .zip 压缩包中的 .exe 可执行程序或选择 .exe 安装包与 .msi 安装包执行安装操作，.jar 包可直接通过 `java -jar` 命令运行。\n- 启动 MagicShare 并认真阅读启动页说明，同意 “用户许可协议” 可继续使用。\n- 在 MagicShare 的主界面右下方可以选择语言。\n    - 当前支持中文（简体 / 繁体）与英文。\n- 选择是否启用连接密码\n    - 若希望启用连接密码，需勾选“启用密码”并自定义 3~10 位的密码。\n    - 若不希望启用连接密码，需取消勾选“启用密码”。\n- 自定义端口后单击 “启动服务” 按钮\n    - 若提示 “启动成功”，则表示服务正常启动，可将 ”分享URL“ 提供给接收方。\n    - 若提示 ”端口被占用“，请尝试更换端口号。\n    - 若提示 “端口号错误”，请检查自定义的端口号是否为 1~65535 的整数。\n- 将待分享的文件添加进分享列表中\n    - 方式一：拖拽待分享的文件/文件夹至软件主界面上半部分。\n    - 方式二：单击 “选择文件夹” 按钮选择待分享的文件夹。\n    - 方式三：在 “分享的文件/文件夹” 文本输入框中输入待分享的文件/文件夹路径，按下 “Enter” 键。\n- 在软件右上方可查看当前连接数。\n- 按下 “停止服务” 按钮可立即终止分享。\n- 按下 “清空分享列表” 按钮可立即清空分享列表。\n\n### Web端\n\n- 打开浏览器，访问 ”分享URL“。\n- 启动 MagicShare 并认真阅读启动页说明，同意 “用户许可协议” 可继续使用。\n- 在 MagicShare 的主界面右下方可以选择语言。\n    - 当前支持中文（简体 / 繁体）与英文。\n- 下载文件\n    - 单击 ”快速下载“ 使用浏览器下载器通过 HTTP 协议快速下载文件。\n    - 单击 ”加密下载“ 使用 MagicShare 加密下载器通过 WebSocket 协议并使用 RSA+AES 混合加密下载文件，不支持同时加密下载多个文件。\n- 单击 “查看加密下载进度” 按钮，页面下方将弹出加密下载进度抽屉。\n\n---\n\n## 依赖项\n\n该项目需要以下库：\n\n- [**Vue.js**](https://github.com/vuejs)** 及配套组件**：**用于构建 Web 前端程序。\n- [**Spring Boot**](https://github.com/spring-projects/spring-boot)** 及配套组件：用于构建 Web 后端程序。\n- [**OpenJFX**](https://openjfx.io/)：用于构建图形用户界面的 JavaFX 库。\n\n---\n\n## 各版本功能介绍\n\n- MagicShare1.0.0\n    - 自定义端口启动服务。\n    - 按文件夹/文件路径查找文件并生成列表。\n    - Web 网页下载文件。\n        - 支持通过 HTTP 协议快速下载文件\n        - 支持通过 WebSocket 协议并使用 RSA+AES 混合加密下载文件\n- MagicShare2.0.0\n    - 当前连接数显示。\n    - 自定义连接密码。\n    - 支持多语言。\n        - 中文（简体/繁体）\n        - 英文\n\n---\n\n## 各版本主界面\n\n### MagicShare2.0.0\n\n![MagicShare2.0.0-Desktop-ZH](https://lively-brook-dc1.notion.site/image/attachment%3A138de23b-f7c8-4c8e-8d39-7aec8d577d4d%3AMagicShare2.0.0-Desktop-ZH.png?table=block\u0026id=24e96980-87c2-4fc8-8035-af74d7e96be0\u0026spaceId=4b165318-6383-451c-8845-110b786c9f0a\u0026width=1420\u0026userId=\u0026cache=v2)\n\nMagicShare2.0.0-Desktop-ZH\n\n![MagicShare2.0.0-Web-ZH](https://lively-brook-dc1.notion.site/image/attachment%3Abdaae023-be5d-4c78-970a-49e835b5f90b%3AMagicShare2.0.0-Web-ZH.png?table=block\u0026id=c391b6ab-fc8c-4657-8f8d-bc718423e298\u0026spaceId=4b165318-6383-451c-8845-110b786c9f0a\u0026width=1420\u0026userId=\u0026cache=v2)\n\nMagicShare2.0.0-Web-ZH\n\n### MagicShare1.0.0\n\n![MagicShare1.0.0-Desktop](https://lively-brook-dc1.notion.site/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4b165318-6383-451c-8845-110b786c9f0a%2Fcc029b9b-e911-4cd4-b9c7-4b0853fa6d04%2FMagicShare1.0.0-Desktop.png?table=block\u0026id=17fe64bd-e40f-8066-8c2d-f5f8b1ab0a23\u0026spaceId=4b165318-6383-451c-8845-110b786c9f0a\u0026width=1420\u0026userId=\u0026cache=v2)\n\nMagicShare1.0.0-Desktop\n\n![MagicShare1.0.0-Web](https://lively-brook-dc1.notion.site/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4b165318-6383-451c-8845-110b786c9f0a%2Fa457bfec-f826-4936-8721-75fc46632fc2%2FMagicShare1.0.0-Web.png?table=block\u0026id=17fe64bd-e40f-80d7-9c7c-fca929d6904d\u0026spaceId=4b165318-6383-451c-8845-110b786c9f0a\u0026width=1420\u0026userId=\u0026cache=v2)\n\nMagicShare1.0.0-Web\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzhow1024%2Fmagicshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzzhow1024%2Fmagicshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzhow1024%2Fmagicshare/lists"}