164 lines
6.6 KiB
Markdown
164 lines
6.6 KiB
Markdown
|
||
|
||
# 蓝眼云盘
|
||
|
||
##### [在线Demo](http://tank.eyeblue.cn) (体验账号： demo@tank.eyeblue.cn 密码：123456)
|
||
|
||
##### [配套前端tank-front](https://github.com/eyebluecn/tank-front)
|
||
|
||
### 简介
|
||
蓝眼云盘是 [蓝眼系列开源软件](https://github.com/eyebluecn) 中的第一个
|
||
|
||
- 可用于快速搭建私人云盘，可以简单理解为在自己服务器上部署一个[百度云盘](https://pan.baidu.com/)。
|
||
- 蓝眼云盘提供了[编程接口](https://github.com/eyebluecn/tank/blob/master/build/doc/alien_zh.md)，可以使用编程接口上传文件，作为其他网站、系统、app的资源存储器，可以当作单机版的[七牛云](https://www.qiniu.com)或[阿里云OSS](https://www.aliyun.com/product/oss)使用。在即将发布的[《蓝眼博客》](https://github.com/eyebluecn/blog)软件中将会有详细的使用。
|
||
- 蓝眼云盘有详细的[后台api文档](https://github.com/eyebluecn/tank/blob/master/build/doc/api_zh.md)，对于学习前端的童鞋而言可以快速部署一个正式而又具有丰富接口的后端供学习使用。
|
||
- 蓝眼云盘还提供了账号管理系统，超级管理员可以管理用户，查看用户文件，普通用户只能查看自己的文件，修改自己的资料。上面提供的体验账号就是一个普通用户的账号。
|
||
|
||
蓝眼云盘力求小而精，可以作为团队内部或个人私有的云盘使用，亦可当作专门处理图片，音频，视频等二进制文件的第三方编程辅助工具，同时也可作为学习资源使用。
|
||
|
||
如果您觉得蓝眼云盘对您有帮助，请不要吝惜您的star :smile:
|
||
|
||
### 使用安装包安装
|
||
|
||
#### a) 准备工作
|
||
|
||
1. 一台windows/linux服务器，当然你可以使用自己的电脑充当这台服务器
|
||
|
||
2. [安装好Mysql数据库](https://www.mysql.com/downloads/)
|
||
|
||
3. [在这里](https://github.com/eyebluecn/tank/releases)下载服务器对应的安装包
|
||
|
||
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": "admin@tank.eyeblue.cn",
|
||
//超级管理员密码
|
||
"AdminPassword": "123456"
|
||
}
|
||
|
||
```
|
||
|
||
#### b) 运行
|
||
|
||
- windows平台直接双击应用目录下的`tank.exe`。
|
||
|
||
- linux平台执行
|
||
|
||
```
|
||
cd 应用目录路径
|
||
./tank
|
||
```
|
||
|
||
如果你希望关闭shell窗口后，应用依然运行，请使用以下脚本启动和停止
|
||
```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`) 可以看到以下登录页面：
|
||
|
||
|
||
|
||
使用上方配置文件中的邮箱和密码登录后可以看到如下界面：
|
||
|
||
|
||
### 使用源代码自行打包
|
||
|
||
#### a) 准备工作
|
||
|
||
1. 一台windows/linux服务器，当然你可以使用自己的电脑充当这台服务器
|
||
|
||
2. Mysql数据库
|
||
|
||
3. clone本项目
|
||
|
||
4. 安装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源代码
|
||
|
||
```
|
||
|
||
5. 准备项目依赖的第三方库
|
||
|
||
- 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`国内无法下载，请从[这里](https://github.com/eyebluecn/golang.org)下载，并按上文推荐的目录结构放置。其余依赖项均可通过安装脚本自动下载。
|
||
|
||
#### b) 打包
|
||
|
||
- 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](https://github.com/eyebluecn/tank/blob/master/build/doc/api_zh.md)
|
||
|
||
[蓝眼云盘编程接口](https://github.com/eyebluecn/tank/blob/master/build/doc/alien_zh.md)
|
||
|
||
### Contribution
|
||
|
||
感谢所有蓝眼云盘的贡献者 [@zicla](https://github.com/zicla)，[@seaheart](https://github.com/seaheart)，[@yemuhe](https://github.com/yemuhe)，[@hxsherry](https://github.com/hxsherry)
|
||
|
||
如果您也想参与进来，请尽情的fork, star, post issue, pull requests
|
||
|
||
### License
|
||
|
||
[MIT](http://opensource.org/licenses/MIT)
|
||
|
||
Copyright (c) 2017-present, eyeblue.cn |