187 lines
6.5 KiB
Markdown
187 lines
6.5 KiB
Markdown
[](https://github.com/eyebluecn/tank)
|
||
|
||
[English Version](./README_EN.md)
|
||
|
||
# 蓝眼云盘（3.0.0）
|
||
|
||
[在线Demo](https://tank.eyeblue.cn) (体验账号： demo 密码：123456)
|
||
|
||
[文档](https://tank-doc.eyeblue.cn/)
|
||
|
||
### 软件截图
|
||
|
||
#### PC端截图
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
#### 手机端截图
|
||
|
||
|
||
|
||
[安装文档](https://tank-doc.eyeblue.cn/zh/basic/install.html)
|
||
|
||
## Windows
|
||
1. 安装MySQL(使用UTF-8编码)
|
||
2. 下载最新版本的蓝眼云盘，[去下载](./download.md)
|
||
3. 解压，双击根目录下的`tank.exe`运行
|
||
4. 打开 `http://127.0.0.1:6010` 看到安装引导页面即表示软件安装成功。接着按照UI引导安装蓝眼云盘即可。
|
||
|
||
|
||
## Linux
|
||
1. 安装MySQL(使用UTF-8编码)
|
||
2. 下载最新版本的蓝眼云盘，[去下载](./download.md)
|
||
3. 解压，运行根目录下`tank`
|
||
```shell
|
||
./tank
|
||
```
|
||
4. 打开 `http://127.0.0.1:6010` 看到安装引导页面即表示软件安装成功。接着按照UI引导安装蓝眼云盘即可。
|
||
|
||
## macOS
|
||
1. 安装MySQL(使用UTF-8编码)
|
||
2. 下载最新版本的蓝眼云盘，[去下载](./download.md)
|
||
3. 解压，运行根目录下`tank`
|
||
```shell
|
||
./tank
|
||
```
|
||
4. 打开 `http://127.0.0.1:6010` 看到安装引导页面即表示软件安装成功。接着按照UI引导安装蓝眼云盘即可。
|
||
|
||
## docker
|
||
|
||
|
||
1. Docker中启动mysql
|
||
```shell
|
||
docker run --name dockermysql -p 13306:3306 -e MYSQL_ROOT_PASSWORD=123456 -e MYSQL_DATABASE=tank -e MYSQL_USER=tank -e MYSQL_PASSWORD=tank123 -v ~/data/dockermysql:/var/lib/mysql -d mysql:5.7
|
||
```
|
||
::: tip 提示
|
||
容器名称为`dockermysql`，占用宿主13306端口，root密码123456，创建了一个`tank`数据库，用户名`tank`，密码`tank123` ，将文件挂载于宿主的`~/data/dockermysql`文件夹。
|
||
:::
|
||
|
||
2. Docker中启动蓝眼云盘
|
||
```shell
|
||
docker run --name tank -p 6010:6010 --link dockermysql:mysql -v ~/data/dockermatter:/data/matter -d eyeblue/tank:3.0.0
|
||
```
|
||
::: tip 提示
|
||
容器名称为`tank`，占用宿主6010端口，链接数据库为`mysql`，即通过`mysql`可以访问到步骤1中mysql的地址，将文件挂载于宿主的`~/data/dockermatter`文件夹。
|
||
:::
|
||
|
||
3. 打开 `http://127.0.0.1:6010` 看到安装引导页面即表示软件安装成功。
|
||
|
||
::: tip 提示
|
||
MySQL Host => `mysql`
|
||
|
||
MySQL 端口 => `3306`
|
||
|
||
MySQL 库名 => `tank`
|
||
|
||
MySQL 用户名 => `tank`
|
||
|
||
MySQL 密码 => `tank123`
|
||
:::
|
||
|
||
|
||
### 使用源代码自行打包
|
||
|
||
|
||
**前端项目打包**
|
||
1. clone  [tank-front](https://github.com/eyebluecn/tank-front)
|
||
|
||
2. 安装依赖项
|
||
```
|
||
npm install
|
||
```
|
||
3. 执行打包命令
|
||
```
|
||
npm run build
|
||
```
|
||
4. 通过前面三步可以在`dist`文件夹下得到打包后的静态文件，将`dist`目录下的所有文件拷贝到后端项目的`build/html`文件夹下。（下文的工程目录中也有说明）
|
||
|
||
**后端项目打包**
|
||
|
||
1. clone  [tank](https://github.com/eyebluecn/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源代码目录
|
||
│ │ │ ├── ... #golang源代码 不同文件用前缀区分
|
||
│ │ ├── .gitignore #gitignore文件
|
||
│ │ ├── CHNAGELOG #版本变化日志
|
||
│ │ ├── DOCKERFILE #构建Docker的文件
|
||
│ │ ├── LICENSE #证书说明文件
|
||
│ │ ├── main.go #程序入口文件
|
||
│ │ ├── README.md #README文件
|
||
```
|
||
|
||
3. 准备项目依赖的第三方库
|
||
|
||
- 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 的方式从 [这里](https://github.com/eyebluecn/golang.org)下载。其余依赖项均会通过`go get`的方式下载。
|
||
|
||
4. 打包
|
||
|
||
- 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)
|
||
|
||
[快速使用Let's Encrypt开启个人网站的https](https://blog.eyeblue.cn/home/article/9f580b3f-5679-4a9d-be6f-4d9f0dd417af)
|
||
|
||
[Docker 化你的开源项目](https://blog.eyeblue.cn/home/article/510f9316-9ca1-40fe-b1b3-5285505a527d)
|
||
|
||
### 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
|