AUXPI集合多家 API 的新一代图床
AUXPI —— 集合多家 API 的新一代图床
本项目使用 beego + vue + element-ui 进行开发
功能 特色
- 支持 web 上传图片
- 支持 API 上传图片
- 支持分发,控制反转
- 各种自由定制请看下面的截图
项目截图
支持拖拽对首页的菜单进行排序和开关控制
图片链接按照权重进行异步分发
首页有几个可视化的图表,方便分析
分发原理
开发人员 && 折腾用户
如果您想要从源代码中构建 auxpi,您可以按照下面的教程进行构建,如果您仅仅想使用 auxpi,这一段您可以跳过
请注意你,请确保您的电脑上有 Go 环境。
从源码中构建
使用脚本构建
在 最近一次更新 中加入了批量编译打包的脚本,您可以使用此脚本进行代码的构建
bash build.sh all # 编译所有平台的程序 bash build.sh mac # 编译 mac 程序 bash build.sh windows # 编译 Windows 程序 bash build.sh linux #编译 linux 程序 bash build.sh all 2.2.0 clear # 编译程序,分别打包所有的平台的项目,2.2.0 为版本号,清空编译以后文件,只保留压缩包 bahs build.sh help #查看帮助
打包前端
cd resource yarn install yarn run build
使用 Bee 工具运行程序
cd $GOPATH/src git clone git@github.com:aimerforreimu/AUXPI.git cd AUXPI/ bee run auxpi
交叉编译
#Mac/Windows环境编译成 Linux 程序 GOOS=linux GOARCH=amd64 bee pack #Mac/Linux 环境编译 Windows 程序 GOOS=windows GOARCH=amd64 bee pack #Windows/Linux 编译 Mac 程序 GOOS=darwin GOARCH=amd64 bee pack
更多交叉编译请参考 Go 交叉编译
二次开发规范
如果这个项目让您感觉还不错,您想二次开发一下或者想为这个项目提交 PR
1.命名规范
-
函数,私有变量必须采用小驼峰方式进行命名 即
sendMail(),userInfo -
共有变量需要使用大驼峰方式命名
-
结构体,接口必须使用大驼峰方式进行命名
2.代码组织
最好请按照这个下面说明的结构去组织您的代码
-
中间件请存放在
middleware文件夹中 -
api 请按照版本号放在
controller/api/v(0-9)/中,所有 api 除去auth都不能进行模板引擎的渲染和操作,只允许输出json -
如果需要渲染模板引擎,请直接在
controller/下面建立对应的 controller -
utils下面的各种工具文件不允许与models下面的文件耦合在一起,如果要为models编写工具,请放到tools下 -
all.go中只允许写入经常被引入,需要格式化成json,xml等格式的结构体
.
├── LICENSE
├── README.md
├── auxpiAll
├── bootstrap
├── build
├── build.sh
├── conf
├── controllers
├── install.sh
├── log
├── main.go
├── middleware
├── models
├── pem
├── resource
├── routers
├── server
├── static
├── tests
├── tools
├── utils
└── views
API 上传
API 上传实例
图片上传 V1 接口
| 功能 | 图片上传接口 |
|---|---|
| HTTP 请求方式 | POST |
| URL | http://yourname/api/v1/upload |
请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| image | File | 是 | 表单名称,上传图片 |
| token | String | 是 | 认证所必须的 token ,如果站在没有开启则留空即可 |
| apiSelect | String | 是 | 所选择的 API 类型 |
apiSelect可选参数
| apiSelect 可选参数 | 参数说明 |
|---|---|
| SouGou | 搜狗图床 |
| Sina | 新浪图床 |
| Smms | SMMS 图床 |
成功上传返回
{
"code": 200,
"msg": "上传成功",
"data": {
"name": "Snipaste_2018-08-28_01-17-58.png",
"url": "https://img04.sogoucdn.com/app/a/100520146/0dcb98aadb59c6b29dc0832eb7cc094a"
}
}
{
"code": 200,
"msg": "上传成功",
"data": {
"name": "Snipaste_2018-08-28_01-17-58.png",
"url": "https://i.loli.net/2018/11/05/5be038b1b4af6.png"
}
}
失败返回值
上传出错返回值
{
"code": 500,
"msg": "上传失败"
}
API 未开启返回值
{
"code": 405,
"msg": "Method not allowed"
}
Token 验证失败返回值
{
"code": 403,
"msg": "Forbidden"
}
选择文件为空返回值
{
"code": 500,
"msg": "No files were uploaded."
}
文件太大返回值
{
"code": 500,
"msg": "File is too large."
}评论
