Skip to content

Latest commit

 

History

History
195 lines (119 loc) · 6.56 KB

README-CN.md

File metadata and controls

195 lines (119 loc) · 6.56 KB
Raw

OSS Browser

OSS Browser 提供类似 windows 资源管理器功能。用户可以很方便的浏览文件，上传下载文件，支持断点续传等。

本工具使用开源框架 Angular 1.x + Electron制作。

Electron 框架可以让你使用 JavaScript，HTML 和 CSS 构建跨平台的桌面应用程序。它是基于 node.js 和 Chromium 开源项目。Electron 可以打包出跨平台的程序，运行在 Mac，Windows 和 Linux 上。

1. 支持平台

Windows7 above, Linux and Mac,不建议使用windows XP平台和windows Server平台

2. 客户端下载：

最新版本1.9.5，下载地址如下，解压即可使用。

Window x32 版下载

Window x64 版下载

Mac zip 版下载

Ubuntu x64 版

Ubuntu x32 版

其他版本暂不提供，可以自行 build。

所有版本下载

3. 功能介绍:

功能Map
  |-- 登录：支持AK登录和授权码登录。
  |-- Bucket管理，新建bucket，删除bucket，bucket权限修改，碎片管理。
       |-- 文件管理：目录（包括bucket）和文件的增删改查， 复制, 文件预览等。
             |-- 文件传输任务管理： 上传下载，断点续传。
  |-- 地址栏功能（支持oss://协议URL，浏览历史前进后退，保存书签）
  |-- 授权功能： 简化RAM Policy授权。
  |-- 生成授权码： STS临时授权。

(1) AK 登录

AK登录

  • 子用户登录可以指定预设 OSS 路径，配合子用户授权使用。

(2) Bucket 列表

Bucket列表

(3) 文件列表 (支持拖拽上传)

文件列表

(4) 授权给子用户 & 子用户登录

授权给子用户

子用户登录

(5) 临时授权 & 授权码登录

临时授权

临时授权2

授权码登录

(6) 归档 bucket 支持

新建归档bucket

restore

  • 归档 bucket 下所有文件均为 Archive 存储类型, 需要解冻才能访问。

(7) 支持自定义域名（cname方式）访问（1.9.0版本开始支持）

cname模式

  • cname模式需要用户在oss控制台上进行域名和bucket的绑定，使用cname模式ossbrowser上所有object的操作都会走自定义域名方式

(7) 支持请求付费者模式访问（1.9.0版本开始支持）

requestPay

4. 开发环境搭建

如果你要在此基础上开发，请按照以下步骤进行。

(1) 安装 node.js 最新版本

官网: https://nodejs.org/

(2) 安装 cnpm

官网: https://cnpmjs.org/

cnpm 是 npm（node 包管理工具）的中国镜像，可以提高下载依赖包的效率。

(3) 如果使用 windows 系统，需要安装下列软件：

  • 需要安装 gitbash:

请自行下载安装。

  • 需要安装 windows-build-tools:
cnpm i -g windows-build-tools
  • 还需要下载 make.exe，放到 C:\windows\ 目录下

make.exe(64 位版本)

make.exe(32 位版本)

(4) 下载代码

git clone git@github.com:aliyun/oss-browser.git

安装依赖:

make i

(5) 运行

make run  # 开发模式运行, command+option+i 可用打开调试界面, win或linux按 F12.

开发模式下，会自动监听源码,如有修改,会自动 build 前端代码到 dist 目录。

(6) 打包

make build  # build前端代码到dist目录

make win64  # 打包win64程序， 可选: mac, linux64,linux32,win32,win64,all.

5. 代码结构

oss-browser/
 |-- app/                 # 前端代码, 采用angular1.x + bootstrap3.x
 |-- custom/              # 自定义图标，名称等。请看custom/Readme.md
 |-- node/                # 前端调用的 node 模块
     |-- crc64/           # crc校验模块，用来校验文件完整性
     |-- ossstore/        # 上传下载job类
     |-- i18n/            # 国际化
 |-- vendor/              # 前端 aliyun-sdk 依赖
 |-- node_modules         # node端依赖的模块
 |-- dist                 # 前端临时build出的代码
 |-- build                # electron build 出的应用
 |-- gulpfile.js          # 项目管理文件
 |-- package.json         # 项目描述文件
 |-- main.js              # 程序入口

6. 自定义 build

请看这里: 自定义 build

7. 关于贡献

  • 如有建议或发现 bug，请直接开 issue或者提PR，PR必须merge请求到dev分支,我们会统一把dev分支合并到master并发布，感谢广大开发者参与。

8. 注意事项

  • OSS Browser使用过程中，如果遇到问题可打开调试面板进行问题初步排查，可通过单击OSS Browser工具左上角图标连续10次弹出调试面板,针对每个操作OSS Browser埋的都有关键操作信息，同时控制台会实时同步错误信息,如果用户无法理解错误日志信息。请issue截图反馈@luozhang002进行排查
  • OSS Browser工具使用过程中尽量不要开本地代理或者VPN相关
  • 开发者如果是通过本地编译github仓库生产的oss browser工具，想要进行主进程和渲染进程相关代码的调试可以参考文档debug

9. 开源 LICENSE

Apache License 2.0

10. Mac升级到10.15 以上打包问题修复

Mac 新系统不在支持32位程序，打包windows包的wine需要使用64位系统，导致无法打包windows的包。 修复方案

  1. brew install homebrew/cask/wine-stable
  2. mv /usr/local/bin/wine /usr/local/bin/wine-old && mv /usr/local/bin/wine64 /usr/local/bin/wine
  3. 下载 "https://github.com/electron/rcedit/releases/download/v1.1.1/rcedit-x64.exe", 重命为 "rcedit.exe" 然后替换 "node_modules/rcedit/bin/rcedit.exe"