Jscape使用说明

一、概述

JSCAPE MFT Server是一个独立于平台的托管文件传输服务器，它将所有的文件传输过程集中到一个简单易用的应用程序中。JSCAPE MFT服务器支持所有主要的文件传输协议，包括AS2、FTP/S、SFTP、SCP、HTTP/S、WebDAV和AFTP（加速文件传输协议）。
JSCAPE MFT Server是收费软件，提供免费安装和使用，免费版会有限制，如只允许建一个域、两个用户。
官网
https://www.jscape.com/
官方指导文档
http://files.jscape.com/secureftpserver/docs/index.html

二、使用

1、创建域

①Domains → Add → 填写名称

②选择协议

③设置日志存放目录

④设置自启动（Jscape启动后自动启动域）
选择域 → 点击Autostart（列表上Autostart勾选上表示已设置该域为自启动）

⑤设置被动模式
Services → FTP/S → 勾选上Passive port range

2、创建用户

①Domains → 选择对应的域 Edit → Users → Add

填写用户名、登录名和密码。
可以在Paths标签页设置该用户的工作空间，也就是使用该用户上传的文件最终保存的位置。
可以在IP Access标签页设置该用户允许从哪些IP登录。不设置默认为不限制。

3、创建触发器

①Domains → 选择对应的Domain → Edit → Triggers → Add

填写触发器名称，名称可以体现出触发的事件类型等信息，如：文件上传触发器。
选择事件类型，Jscape支持的事件类型很多，完整的事件类型列表参考服务。可以按照实际需要选择。文件上传事件名称为File Upload。

勾选上Run trigger asynchronous和Run actions asynchronous
②填写触发条件表达式
触发条件可以是一段表达式，表示符合当前表达式才会触发。
示例：当上传的文件是空的则不触发。表达式可以设置为GetFileSize(File)>0。
也可以定制更多个性的需求，如仅在某个时间段内才会触发。

③添加触发的Action
一个Action表示一个动作，一个触发器可以有多个Action。触发器会按顺序调用各个Action，Jscape支持的Action很多，完整的Action列表参考附录。常用的如发送一封邮件、执行一段脚本、发送一个HTTP请求等。可以按实际业务需要配置。
添加一个HTTP请求

配置HTTP请求的URL、method和Expected Response。
注：HTTP请求默认会将上传文件的相关参数发送过去，完整的参数列表参考附录。除此之外，用户也可以自定义一些参数。

4、测试上传文件

使用命令行命令或ftp客户端工具（cuteFTP、fileZilla、WinSCP等）测试是否能连接上。

三、触发器

1、执行条件表达式

//非空文件 且 过滤test用户上传的文件

GetFileSize(File)>0 AND Username!="test"

四、常见问题

1.连接不上ftp服务器

被动模式下，需要填写passive ip为jscape服务器的外网ip。

2.端口

被动模式下，可以限制通过哪些端口与客户端完成数据的传输。

3.设置定期清理触发器日志

登录Jscape → Domain → Trigger → Setting
勾选Clear recent triggers older than 后填上1天，表示只保留最近一天的日志，点击最下面的Apply生效

4.启动jscape

切换到Jscape安装目录（使用root权限启动）

./start_service.sh  

查看日志
Jscape安装目录/var/log下（需要root权限）

tail -n 1000 server_err.log  

5.生成密钥

Keys → Server Keys → Generate

6.生成管理员用户

管理员密码忘记的情况下，可以使用该方法生成一个新的管理员或者覆盖现有的管理员

cd /opt/JSCAPE_MFT_Server
 ./stop_service.sh
./js-addadmin -db -username admin -password 123456 -sa
./start_service.sh