我开源了一个私人云盘——蓝眼云盘

时间 2019-11-10

标签开源一个人云繁體版

原文原文链接

蓝眼云盘

在线Demo (体验帐号： demo@tank.eyeblue.cn 密码：123456)html

后端tank地址前端

前端tank-front地址vue

简介

蓝眼云盘是蓝眼系列开源软件之一，也是蓝眼系列其余软件的基础服务软件。蓝眼博客具备如下几大特点：mysql

1. 支持dockerlinux

蓝眼云盘的docker镜像已经发布到了Docker Hub，能够一行指令运行。

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

蓝眼云盘安装包 6M左右，在windows linux mac OS操做系统中都可安装运行；
蓝眼云盘为绿色软件，将安装包解压缩，修改配置文件后便可一行命令当即运行。

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

蓝眼云盘主要支持pc web端，同时手机web也具备不错的响应性支持。
蓝眼云盘实现了云盘（如：百度云盘，微云 )的核心功能：文件夹管理，文件管理，上传文件，下载文件，文件分享等。
蓝眼云盘提供能帐号管理系统，超级管理员能够管理用户，查看用户文件，普通用户只能查看本身的文件，修改本身的资料。上面提供的体验帐号就是一个普通用户的帐号。

4. 支持接口编程golang

蓝眼云盘提供了编程接口，实现了云存储（如：七牛云，阿里云OSS ）的核心功能，可使用编程接口上传文件，做为其余网站、系统、app的资源存储器。能够在下载图片时对图片作缩放裁剪处理，能够有效地节省客户端流量。
蓝眼系列开源软件之二的《蓝眼博客》正是使用蓝眼博客做为第三方资源存储器。蓝眼博客中的全部图片，附件均是存储在蓝眼云盘中。

5. 先后端分离，文档丰富web

项目后端使用golang开发，前端使用vue套件开发。
蓝眼云盘有详细的后台api文档，对于学习前端的童鞋而言能够快速部署一个正式而又具备丰富接口的后端供学习使用。
后端技术栈使用 golang，没有使用任何web框架；初始化安装，生命周期控制，路由管理，路由匹配，日志管理，依赖注入，错误处理，panic拦截，打包，安装脚本等功能全采用纯手动打造，绿色环保，所以代码更精炼，更具备探讨学习的价值。

若是您以为蓝眼云盘对您有帮助，请不要吝惜您的star sql

软件截图

PC端截图

手机端截图

Docker方式运行

蓝眼云盘在运行时依赖mysql数据库，所以最好的方式是使用docker-compose来运行，若是你对docker-compose不熟悉，能够参考这篇文章：《Docker Compose 项目》

1.准备 docker-compose.yml 文件
docker-compose.yml描述了镜像启动的数据卷，环境变量，启动方式，依赖项等。该文件位于项目的根目录下，内容以下：

#docker-compose版本，这里的3不要动
version: "3"
services:

   # 数据库的镜像信息
   # 使用mysql:5.7的镜像
   db:
     image: mysql:5.7
     volumes:
       # 数据库文件存放在宿主机的`~/data/mysql`位置，若是宿主机目录不存在，则会自动建立
       - ~/data/mysql:/var/lib/mysql
     # 若是启动失败，则老是会重启。由于镜像有依赖的状况，不停重启能够保证依赖项启动成功后本身再运行
     restart: always
     environment:
       # 指定root密码为`tank123`，而且建立一个新数据库`tank`，同时用户名和密码为`tank` `tank123`
       MYSQL_ROOT_PASSWORD: tank123
       MYSQL_DATABASE: tank
       MYSQL_USER: tank
       MYSQL_PASSWORD: tank123

   # 蓝眼云盘的镜像信息
   # 依赖 mysql:5.7 的镜像
   tank:
     image: eyeblue/tank:1.0.2
     depends_on:
       - db
     ports:
       # 端口映射关系，宿主机端口:镜像端口
       - "6010:6010"
     # 若是启动失败，则老是会重启。由于镜像有依赖的状况，不停重启能够保证依赖项启动成功后本身再运行
     restart: always
     environment:
       # mysql的端口
       TANK_MYSQL_PORT: 3306
       # Mysql的主机，和services的第一个节点一致。
       TANK_MYSQL_HOST: db
       # 数据库
       TANK_MYSQL_SCHEMA: tank
       # 数据库的用户名
       TANK_MYSQL_USERNAME: tank
       # 数据库的密码
       TANK_MYSQL_PASSWORD: tank123
       # 超级管理员的昵称。只能是英文或数字
       TANK_ADMIN_USERNAME: admin
       # 超级管理员邮箱，做为登陆帐号
       TANK_ADMIN_EMAIL: admin@tank.eyeblue.cn
       # 超级管理员密码，做为登陆密码
       TANK_ADMIN_PASSWORD: 123456
     volumes:
       # 日志文件存放在宿主机的`~/data/tank/log`位置，若是宿主机目录不存在，则会自动建立
       - ~/data/tank/log:/data/log
       # 上传文件存放在宿主机的`~/data/tank/matter`位置，若是宿主机目录不存在，则会自动建立
       - ~/data/tank/matter:/data/matter

2.运行项目
首先保证当前目录是docker-compose.yml所在的目录，而后执行如下指令便可运行蓝眼云盘：

$ docker-compose up -d

3.验证

因为数据库启动须要必定的时间，所以大约20s后，打开浏览器访问http://127.0.0.1:6010，若是看到登陆界面则表示运行成功。

4.中止项目

方法一：使用如下命令来中止蓝眼云盘

$ docker-compose stop

方法二：固然你也能够用中止容器的方式来中止蓝眼云盘

$ docker container ls

CONTAINER ID        IMAGE                COMMAND                  CREATED             STATUS              PORTS                    NAMES
f5f64735fc53        eyeblue/tank:1.0.2   "/go/bin/tank"           20 minutes ago      Up 13 seconds       0.0.0.0:6010->6010/tcp   tank_tank_1
3a859cad3e7e        mysql:5.7            "docker-entrypoint.s…"   20 minutes ago      Up 14 seconds       3306/tcp                 tank_db_1

$ docker container stop f5
$ docker container stop 3a

若是你比较关心如何使用docker来构建蓝眼云盘，请参考《Docker 化你的开源项目》

常规安装

a) 准备工做

一台windows/linux服务器，固然你可使用本身的电脑充当这台服务器
安装好Mysql数据库
在这里下载服务器对应的安装包
在服务器上解压缩，修改配置文件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": "admin@tank.eyeblue.cn",
  //超级管理员密码
  "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) 能够看到登陆页面，而且使用配置文件中的邮箱和密码登陆成功后能够看到所有文件（见上文截图）即表示安装成功。

使用源代码自行打包

前端项目打包

clone tank-front
安装依赖项

npm install

执行打包命令

npm run build

经过前面三步能够在dist文件夹下获得打包后的静态文件，将dist目录下的全部文件拷贝到后端项目的build/html文件夹下。（下文的工程目录中也有说明）

后端项目打包

clone tank
安装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源代码

准备项目依赖的第三方库

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国内没法下载，默认会经过git clone 的方式从这里下载。其他依赖项均会经过go get的方式下载。

打包

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

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

Contribution

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

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

License

MIT

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