oss-server 对象存储系统 项目简介
oss-server 对象存储系统(Simple OSS Server)项目介绍oss-server是针对项目开发时提供的小型对象存储系统,开发者在针对文件上传时业务剥离,同时方便文件迁移，为满足单个项目，多个系统的情况下，提供统一的oss服务oss-server主要提供功能：上传功能文件在线管理功能(包括文件的预览、内部上传、删除、更名)权限管理(上传api权限用户维护、oss-server登录系统维护)oss-server使用tomcat+nginx的方式，tomcat提供上传对象存储的能力，nginx提供在线访问的能力oss不提供文件相关日志存储功能，是纯技术中间件server端主要配置(application.properties)如下：#素材存储路径 -- 以/结尾
material.root=/home/material/
#素材下载路径根目录,该目录是nginx读取目录,可以使用域名
material.invokingRoot=http://192.168.0.7/使用以上配置，服务端nginx配置如下：server{
listen 80;
server_name 192.168.0.7;
charset utf-8;
location / {
root /home/material/;
}
}该配置只是简单配置nginx访问路径,server_name可以是域名.管理员预览输入访问路径：http://ip:port/输入application.properties配置文件中的用户名密码:#验证用户名 密码
oss.security.userName=admin
oss.security.password=adminA123oss-server提供以下两种提交方式base64字符串格式提交该方式是后端需要将文件转换成base64字符串,提交给oss-server，该方式oss-server提供了java版的sdk，具体可参看oss-server-sdk-java程序请求接口：/oss/material/uploadByBinary接口类型：post请求类型：application/json;请求参数：{
"project": "",
"files": [
{
"original_name": "test.png",
"file": "文件流base64字符串",
"media_type": "png"
}
]
}字段说明：参数说明project项目名称，oss-server会根据该名称创建项目目录,方便后续程序迁移files上传文件数组original_name文件原始名称file文件流base64字符串media_type文件格式类型响应json{
"code": "8200",
"message": "Success",
"data": [{
"id": "1a4c705d260647cc9be951ead3a449e6",
"url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",
"store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"
}]
}响应参数说明参数说明code错误码,8200为成功message错误信息data上传成功后文件返回信息id文件唯一标识url文件在线访问urlstore文件静态存储路径form表单直接提交该方式前端可直接通过form提交上传,后端不需要提供中转请求接口：/oss/material/{project}/uploadMaterial接口类型：post请求参数：参数说明project项目名称，oss-server会根据该名称创建项目目录,方便后续程序迁移module模块名称，可为空,很多情况下,我们希望分模块来存储我们的上传资源，这个时候，可以使用该module字段，例如：/product/wechat,此时,oss生成的全路径是：{project}/product/wechat/...file上传文件名称，可以是数组多个文件响应json{
"code": "8200",
"message": "Success",
"data": [{
"id": "1a4c705d260647cc9be951ead3a449e6",
"url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",
"store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"
}]
}form表单代码示例如下 Title软件架构后端框架：SpringBoot 2.0.2.RELEASE后端模块：freemarker前端框架：layer+Bootstrap安装教程下载源码：git clone https://gitee.com/xiaoym/oss-server.git修改application.properties配置文件,主要修改以下oss对外域名路径已经上传存储路径#素材存储路径 -- 以/结尾
material.root=/home/material/
#素材下载路径根目录
material.invokingRoot=http://192.168.0.7/3、打包：mvn package4、运行jar包：java -jar oss-server-0.0.1-SNAPSHOT.jar参与贡献Fork 本项目新建 Feat_xxx 分支提交代码新建 Pull Request
material.root=/home/material/
#素材下载路径根目录,该目录是nginx读取目录,可以使用域名
material.invokingRoot=http://192.168.0.7/使用以上配置，服务端nginx配置如下：server{
listen 80;
server_name 192.168.0.7;
charset utf-8;
location / {
root /home/material/;
}
}该配置只是简单配置nginx访问路径,server_name可以是域名.管理员预览输入访问路径：http://ip:port/输入application.properties配置文件中的用户名密码:#验证用户名 密码
oss.security.userName=admin
oss.security.password=adminA123oss-server提供以下两种提交方式base64字符串格式提交该方式是后端需要将文件转换成base64字符串,提交给oss-server，该方式oss-server提供了java版的sdk，具体可参看oss-server-sdk-java程序请求接口：/oss/material/uploadByBinary接口类型：post请求类型：application/json;请求参数：{
"project": "",
"files": [
{
"original_name": "test.png",
"file": "文件流base64字符串",
"media_type": "png"
}
]
}字段说明：参数说明project项目名称，oss-server会根据该名称创建项目目录,方便后续程序迁移files上传文件数组original_name文件原始名称file文件流base64字符串media_type文件格式类型响应json{
"code": "8200",
"message": "Success",
"data": [{
"id": "1a4c705d260647cc9be951ead3a449e6",
"url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",
"store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"
}]
}响应参数说明参数说明code错误码,8200为成功message错误信息data上传成功后文件返回信息id文件唯一标识url文件在线访问urlstore文件静态存储路径form表单直接提交该方式前端可直接通过form提交上传,后端不需要提供中转请求接口：/oss/material/{project}/uploadMaterial接口类型：post请求参数：参数说明project项目名称，oss-server会根据该名称创建项目目录,方便后续程序迁移module模块名称，可为空,很多情况下,我们希望分模块来存储我们的上传资源，这个时候，可以使用该module字段，例如：/product/wechat,此时,oss生成的全路径是：{project}/product/wechat/...file上传文件名称，可以是数组多个文件响应json{
"code": "8200",
"message": "Success",
"data": [{
"id": "1a4c705d260647cc9be951ead3a449e6",
"url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",
"store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"
}]
}form表单代码示例如下 Title软件架构后端框架：SpringBoot 2.0.2.RELEASE后端模块：freemarker前端框架：layer+Bootstrap安装教程下载源码：git clone https://gitee.com/xiaoym/oss-server.git修改application.properties配置文件,主要修改以下oss对外域名路径已经上传存储路径#素材存储路径 -- 以/结尾
material.root=/home/material/
#素材下载路径根目录
material.invokingRoot=http://192.168.0.7/3、打包：mvn package4、运行jar包：java -jar oss-server-0.0.1-SNAPSHOT.jar参与贡献Fork 本项目新建 Feat_xxx 分支提交代码新建 Pull Request