蓝眼云盘

在线 Demo (体验账号： [email protected] 密码：123456)

后端 tank 地址

前端 tank-front 地址

简介

蓝眼云盘是 蓝眼系列开源软件 之一，也是蓝眼系列其他软件的基础服务软件。蓝眼博客具有以下几大特色：

1. 软件体积小，跨平台，运行简单

• 蓝眼云盘[安装包](( https://github.com/eyebluecn/tank/releases)6M 左右，在windows linux mac OS操作系统中均可安装运行；

• 蓝眼云盘为绿色软件，将安装包解压缩，修改配置文件后即可一行命令立即运行。

2. 使用方便，核心功能齐全

• 蓝眼云盘主要支持 pc web 端，同时手机 web 也具有不错的响应性支持。

• 蓝眼云盘实现了云盘（如：百度云盘，微云)的核心功能：文件夹管理，文件管理，上传文件，下载文件，文件分享等。

• 蓝眼云盘提供能账号管理系统，超级管理员可以管理用户，查看用户文件，普通用户只能查看自己的文件，修改自己的资料。上面提供的体验账号就是一个普通用户的账号。

3. 支持接口编程

• 蓝眼云盘提供了编程接口，实现了云存储（如：七牛云，阿里云 OSS）的核心功能，可以使用编程接口上传文件，作为其他网站、系统、app 的资源存储器。可以在下载图片时对图片做缩放裁剪处理，可以有效地节省客户端流量。

• 蓝眼系列开源软件之二的《蓝眼博客》正是使用蓝眼博客作为第三方资源存储器。蓝眼博客中的所有图片，附件均是存储在蓝眼云盘中。

4. 前后端分离，文档丰富

• 项目后端使用 golang 开发，前端使用 vue 套件开发。

• 蓝眼云盘有详细的后台 api 文档，对于学习前端的童鞋而言可以快速部署一个正式而又具有丰富接口的后端供学习使用。

• 后端技术栈使用 golang，没有使用任何 web 框架；初始化安装，生命周期控制，路由管理，路由匹配，日志管理，依赖注入，错误处理，panic 拦截，打包，安装脚本等功能全采用纯手动打造，绿色环保，因此代码更精炼，更具有探讨学习的价值。

如果您觉得蓝眼云盘对您有帮助，请不要吝惜您的 star

软件截图

安装

** a) 准备工作 **

1. 一台 windows/linux 服务器，当然你可以使用自己的电脑充当这台服务器

2. 安装好 Mysql 数据库

3. 在这里下载服务器对应的安装包

4. 在服务器上解压缩，修改配置文件conf/tank.json，各项说明如下：

{
   //服务器运行的端口，默认 6010。如果配置为 80，则可直接用 http 打开
  "ServerPort": 6010,
  //日志是否需要打印到控制台，默认 false，主要用于调试
  "LogToConsole": false,
  //Mysql 端口，默认 3306
  "MysqlPort": 3306,
  //Mysql 主机
  "MysqlHost": "127.0.0.1",
  //Mysql 数据库名称
  "MysqlSchema": "tank",
  //Mysql 用户名，建议为蓝眼云盘创建一个用户，不建议使用 root
  "MysqlUserName": "tank",
  //Mysql 密码
  "MysqlPassword": "tank123",
  //超级管理员用户名，只能是字母和数字
  "AdminUsername": "admin",
  //超级管理员邮箱，作为登录的账号
  "AdminEmail": "[email protected]",
  //超级管理员密码
  "AdminPassword": "123456"
}

** b) 运行 **

• windows 平台直接双击应用目录下的tank.exe。

• linux 平台执行

cd 应用目录路径
./tank

如果你希望关闭 shell 窗口后，应用依然运行，请使用以下脚本启动和停止

# 启动应用
cd 应用目录路径 /service
./startup.sh

# 停止应用
cd 应用目录路径 /service
./shutdown.sh

** c) 验证 **

浏览器中打开 http://127.0.0.1:6010 (127.0.0.1 请使用服务器所在 ip，6010 请使用tank.json中配置的ServerPort) 可以看到登录页面，并且使用配置文件中的邮箱和密码登录成功后可以看到全部文件（见上文截图）即表示安装成功。

使用源代码自行打包

前端项目打包

1. clone tank-front

2. 安装依赖项

npm install

1. 执行打包命令

npm run build

1. 通过前面三步可以在dist文件夹下得到打包后的静态文件，将dist目录下的所有文件拷贝到后端项目的build/html文件夹下。（下文的工程目录中也有说明）

后端项目打包

1. clone tank

2. 安装 Golang，环境变量GOPATH配置到工程目录，建议工程目录结构如下：

golang                       #环境变量 GOPATH 所在路径
├── bin                      #编译生成的可执行文件目录
├── pkg                      #编译生成第三方库
├── src                      #golang 工程源代码
│   ├── github.com           #来自 github 的第三方库
│   ├── golang.org           #来自 golang.org 的第三方库
│   ├── tank                 #clone 下来的 tank 根目录
│   │   ├── build            #用来辅助打包的文件夹
│   │   │   ├── conf         #默认的配置文件
│   │   │   ├── doc          #文档
│   │   │   ├── html         #前端静态资源，从项目 tank-front 编译获得
│   │   │   ├── pack         #打包的脚本
│   │   │   ├── service      #将 tank 当作服务启动的脚本
│   │   ├── dist             #运行打包脚本后获得的安装包目录
│   │   ├── rest             #golang 源代码
      

1. 准备项目依赖的第三方库

• golang.org/x
• github.com/disintegration/imaging
• github.com/json-iterator/go
• github.com/go-sql-driver/mysql
• github.com/jinzhu/gorm
• github.com/nu7hatch/gouuid

其中golang.org/x国内无法下载，请从这里下载，并按上文推荐的目录结构放置。其余依赖项均可通过安装脚本自动下载。

1. 打包

• windows 平台双击运行 tank/build/pack/build.bat，成功之后可在tank/dist下看到tank-x.x.x文件夹，该文件夹即为最终安装包。

• linux 平台运行如下命令：

cd tank/build/pack/
./build.sh

成功之后可在tank/dist下看到tank-x.x.x.linux-amd64.tar.gz

利用得到的安装包即可参考上文的安装一节进行安装。

相关文档

蓝眼云盘后端 api

蓝眼云盘编程接口

Contribution

感谢所有蓝眼云盘的贡献者 @zicla，@seaheart，@yemuhe，@hxsherry

如果您也想参与进来，请尽情的 fork, star, post issue, pull requests

License

MIT

Copyright (c) 2017-present, eyeblue.cn

注： 原文发布于蓝眼博客 http://blog.eyeblue.cn/home/article/8953d493-f80a-4be0-bde2-50d3c5747430