nimg 文件服务器,NImg: NImg 是基于ZImg的nodejs实现

Nimg

NImg 是基于ZImg的nodejs实现。

去掉了ZImg中 memcached的缓存功能，图片上传处理接口使用json数据格式。不兼容ZImg的文件存储。

环境要求：

操作系统：任何能安装 nodejs 的操作系统

node版本：>=v0.10

ImageMagick版本：>=6.8.7

python版本:>=2.6

##使用##

-- 使用前确保node环境及ImageMagick已安装好

#下载NImg

wget https://github.com/ofpay/nimg/archive/master.zip -O nimg.zip

#解压

uzip nimg.zip

#安装依赖模组

cd nimg-master

npm install

#修改配置,确保图片存储及上传目录有足够的权限

vi config.js

exports.tmproot='/node/temp';//上传临时目录，

exports.imgroot='/node/img';//图片存储目录，

exports.errorlog='/node/log/error.log';//程序错误日志，记录

exports.port=9000;//http端口号

exports.appname='NImg';

exports.maxFileSize=1024*1024;//上传最大限制单位字节1024kb1mb

exports.maxSide=800;//最大截图边长

exports.minSide=30;//最小截图边长

//支持图像文件类型

exports.imgtypes={

"gif":"image/gif",

"jpeg":"image/jpeg",

"jpg":"image/jpeg",

"png":"image/png"

};

#启动

sh nimg.sh start

#查看控制台输出

tailf nohup.out

#关闭

sh nimg.sh stop

api

###名词解释###

userpath 用户目录，NImg支持多用户系统，使用userpath来区分用户目录

md5 根据图片信息得到md5值

t 图像类型，Nimg支持的目前有4种： jpg|jpeg|png|gif

w 图像宽度

h 图像高度

url 图像访问路径，上传时由接口返回

原图url：{userpath}/{md5}.{t} or {userpath}/{md5}-0-0.{t}

等比例缩放图url: {userpath}/{md5}-{w}-{h}.{t}

强制缩放图url: {userpath}/{md5}-{w}-{h}-f.{t}

根据高边等比例缩放url: {userpath}/{md5}-0-{h}-s.{t}

根据宽边等比例缩放url: {userpath}/{md5}-{w}-0-s.{t}

act 图像处理命令

del 删除图像,不需要参数

tleft 左旋90度

tright 右旋90度

resize 缩放，注意：此操作是对当前资源做出修改，不生成新文件

info 返回图片信息，高度，宽度，图片大小

param 命令参数

调用resize时，需要. 等比例缩放示例: 500X500 强制缩放:500X500!

act 目录处理命令

tsize 获取目录下所有文件大小字节数

###说明###

1.图片访问地址 限制：无

method:get

返回： 图像文件

2.上传api 限制：内网调用

可选参数：act(图像预处理),param(预处理参数)

示例：

裁图：

act=crop

param=wxh+x+y 例如：151x189+174+0

缩图：

act=resize

param=wxh[!] 例如：100x100(等比例) 200x200！(强制)

旋转：

act=rotate

param=[-]r 例如：90 (右旋90度) -50(左旋50度)

method:post

成功返回

{

"code":200,

"msg":"upload success!",

"data":{

"t":"gif",

"userpath":"01",

"md5":"d6da9ccfcf52211eba99722207ee3d9a",

"url":"01/d6da9ccfcf52211eba99722207ee3d9a.gif"

}

}

失败返回

{

"code":300,

"msg":"filetype error,not supported txt"

}

3.图像处理api 限制：内网调用

method:get

成功返回

{

"code":200,

"msg":"exec ok!"

}

失败返回

{

"code":301,

"msg":"exec fail"

}

4.目录管理api 限制：内网调用

成功返回

{

"code":200,

"msg":"success!",

"data":{

"userpath":"854899",

"total":32515395

}

}

###api错误代码对照表###

编码

说明

200

操作成功

300

上传错误

301

处理错误

404

资源不存在