{"id":13459162,"url":"https://github.com/aliyun/oss-browser","last_synced_at":"2025-05-14T18:03:11.710Z","repository":{"id":41566674,"uuid":"81035045","full_name":"aliyun/oss-browser","owner":"aliyun","description":"OSS Browser 提供类似windows资源管理器功能。用户可以很方便的浏览文件，上传下载文件，支持断点续传等。","archived":false,"fork":false,"pushed_at":"2024-07-26T03:55:51.000Z","size":20960,"stargazers_count":3376,"open_issues_count":154,"forks_count":463,"subscribers_count":55,"default_branch":"develop","last_synced_at":"2025-04-11T10:00:31.086Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aliyun.png","metadata":{"files":{"readme":"README-CN.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":"2017-02-06T01:14:02.000Z","updated_at":"2025-04-10T13:38:05.000Z","dependencies_parsed_at":"2024-01-09T07:26:08.414Z","dependency_job_id":"08e5ae35-3572-40a8-ac9f-318798653b51","html_url":"https://github.com/aliyun/oss-browser","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Foss-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Foss-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Foss-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Foss-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aliyun","download_url":"https://codeload.github.com/aliyun/oss-browser/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198452,"owners_count":22030964,"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","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":[],"created_at":"2024-07-31T09:01:07.310Z","updated_at":"2025-05-14T18:03:06.697Z","avatar_url":"https://github.com/aliyun.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","JavaScript (485)","0x02 工具 :hammer_and_wrench:"],"sub_categories":["1 云服务工具"],"readme":"# OSS Browser\n\nOSS Browser 提供类似 windows 资源管理器功能。用户可以很方便的浏览文件，上传下载文件，支持断点续传等。\n\n本工具使用开源框架 Angular 1.x + [Electron](http://electron.atom.io/)制作。\n\n\u003e Electron 框架可以让你使用 JavaScript，HTML 和 CSS 构建跨平台的桌面应用程序。它是基于 node.js 和 Chromium 开源项目。Electron 可以打包出跨平台的程序，运行在 Mac，Windows 和 Linux 上。\n\n## 1. 支持平台\n\nWindows7 above, Linux and Mac,不建议使用 windows XP 平台和 windows Server 平台\n\n## 2. 客户端下载：\n\n最新版本`1.19.0`，下载地址如下，解压即可使用。\n\n\u003e [\u003ch4\u003eWindow x32 版下载\u003c/h4\u003e](https://oss-attachment.oss-cn-zhangjiakou.aliyuncs.com/ossbrowser/1.19.0/oss-browser-win32-ia32.zip)\n\n\u003e [\u003ch4\u003eWindow x64 版下载\u003c/h4\u003e](https://oss-attachment.oss-cn-zhangjiakou.aliyuncs.com/ossbrowser/1.19.0/oss-browser-win32-x64.zip)\n\n\u003e [\u003ch4\u003eMac zip 版下载\u003c/h4\u003e](https://oss-attachment.oss-cn-zhangjiakou.aliyuncs.com/ossbrowser/1.19.0/oss-browser-darwin-x64.zip)\n\n\u003e [\u003ch4\u003eUbuntu x64 版\u003c/h4\u003e](https://oss-attachment.oss-cn-zhangjiakou.aliyuncs.com/ossbrowser/1.19.0/oss-browser-linux-x64.zip)\n\n\u003e [\u003ch4\u003eUbuntu x32 版\u003c/h4\u003e](https://oss-attachment.oss-cn-zhangjiakou.aliyuncs.com/ossbrowser/1.19.0/oss-browser-linux-ia32.zip)\n\n其他版本暂不提供，可以自行 build。\n\n\u003e [所有版本下载](all-releases.md)\n\n## 3. 功能介绍:\n\n```\n功能Map\n  |-- 登录：支持AK登录和授权码登录。\n  |-- Bucket管理，新建bucket，删除bucket，bucket权限修改，碎片管理。\n       |-- 文件管理：目录（包括bucket）和文件的增删改查， 复制, 文件预览等。\n             |-- 文件传输任务管理： 上传下载，断点续传。\n  |-- 地址栏功能（支持oss://协议URL，浏览历史前进后退，保存书签）\n  |-- 授权功能： 简化RAM Policy授权。\n  |-- 生成授权码： STS临时授权。\n```\n\n### (1) [AK 登录](docs/aklogin.md)\n\n![AK登录](preview/login.png)\n\n- 子用户登录可以指定预设 OSS 路径，配合子用户授权使用。\n\n### (2) Bucket 列表\n\n![Bucket列表](preview/bucket-list.png)\n\n### (3) 文件列表 (支持拖拽上传)\n\n![文件列表](preview/file-list.png)\n\n### (4) [授权给子用户 \u0026 子用户登录](docs/aklogin.md)\n\n![授权给子用户](preview/subuser-grant.png)\n\n![子用户登录](preview/login-subak1.png)\n\n### (5) [临时授权 \u0026 授权码登录](docs/authToken.md)\n\n![临时授权](preview/genToken2.png)\n\n![临时授权2](preview/genToken3.png)\n\n![授权码登录](preview/token-login.png)\n\n### (6) 归档 bucket 支持\n\n![新建归档bucket](preview/create-archive-bucket.png)\n\n![restore](preview/need-restore.png)\n\n- 归档 bucket 下所有文件均为 Archive 存储类型, 需要解冻才能访问。\n\n### (7) 支持自定义域名（cname 方式）访问（1.9.0 版本开始支持）\n\n![cname模式](preview/cname.png)\n\n- cname 模式需要用户在 oss 控制台上进行域名和 bucket 的绑定，使用 cname 模式 ossbrowser 上所有 object 的操作都会走自定义域名方式\n\n### (7) 支持请求付费者模式访问（1.9.0 版本开始支持）\n\n![requestPay](preview/requestpay.png)\n\n## 4. 开发环境搭建\n\n\u003e 如果你要在此基础上开发，请按照以下步骤进行。\n\n### (1) 安装 node.js 最新版本\n\n官网: https://nodejs.org/\n\n### (2) 安装 cnpm\n\n官网: https://cnpmjs.org/\n\ncnpm 是 npm（node 包管理工具）的中国镜像，可以提高下载依赖包的效率。\n\n### (3) 如果使用 windows 系统，需要安装下列软件：\n\n- 需要安装 gitbash:\n\n请自行下载安装。\n\n- 需要安装 windows-build-tools:\n\n```\ncnpm i -g windows-build-tools\n```\n\n- 还需要下载 make.exe，放到 `C:\\windows\\` 目录下\n\n[make.exe(64 位版本)](https://github.com/aliyun/oss-browser/raw/develop/tools/make-x64.zip)\n\n[make.exe(32 位版本)](https://github.com/aliyun/oss-browser/raw/develop/tools/make-x32.zip)\n\n### (4) 下载代码\n\n```\ngit clone git@github.com:aliyun/oss-browser.git\n```\n\n安装依赖:\n\n```\nmake i\n```\n\n### (5) 运行\n\n```\nmake run  # 开发模式运行, command+option+i 可用打开调试界面, win或linux按 F12.\n```\n\n开发模式下，会自动监听源码,如有修改,会自动 build 前端代码到 dist 目录。\n\n### (6) 打包\n\n```\nmake build  # build前端代码到dist目录\n```\n\n```\nmake win64  # 打包win64程序， 可选: mac, linux64,linux32,win32,win64,all.\n```\n\n## 5. 代码结构\n\n```\noss-browser/\n |-- app/                 # 前端代码, 采用angular1.x + bootstrap3.x\n |-- custom/              # 自定义图标，名称等。请看custom/Readme.md\n |-- node/                # 前端调用的 node 模块\n     |-- crc64/           # crc校验模块，用来校验文件完整性\n     |-- ossstore/        # 上传下载job类\n     |-- i18n/            # 国际化\n |-- vendor/              # 前端 aliyun-sdk 依赖\n |-- node_modules         # node端依赖的模块\n |-- dist                 # 前端临时build出的代码\n |-- build                # electron build 出的应用\n |-- gulpfile.js          # 项目管理文件\n |-- package.json         # 项目描述文件\n |-- main.js              # 程序入口\n```\n\n## 6. 自定义 build\n\n请看这里: [自定义 build](custom/)\n\n## 7. 关于贡献\n\n- 如有建议或发现 bug，请直接开 issue 或者提 PR，PR 必须 merge 请求到 dev 分支,我们会统一把 dev 分支合并到 master 并发布，感谢广大开发者参与。\n\n## 8. 注意事项\n\n- OSS Browser 使用过程中，如果遇到问题可打开调试面板进行问题初步排查，可通过单击 OSS Browser 工具左上角图标连续 10 次弹出调试面板,针对每个操作 OSS Browser 埋的都有关键操作信息，同时控制台会实时同步错误信息,如果用户无法理解错误日志信息。请 issue 截图反馈@luozhang002 进行排查\n- OSS Browser 工具使用过程中尽量不要开本地代理或者 VPN 相关\n- 开发者如果是通过本地编译 github 仓库生产的 oss browser 工具，想要进行主进程和渲染进程相关代码的调试可以参考文档[debug](debug.md)\n\n## 9. 开源 LICENSE\n\n[Apache License 2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyun%2Foss-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliyun%2Foss-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyun%2Foss-browser/lists"}