关于索引的远程控制

只要您的网站发生更改，您就可以运行脚本或项目，请求搜索自动机使用远程控制运行索引。

使用远程控件对进行索引

远程控制索引请求通常来自位于您服务器上的脚本或项目。

该机器人执行的索引步骤与从Index菜单手动启动的步骤相同。 要提交远程控制请求，请配置必要的密码和响应字符串。

如何发出远程控制请求

要发出远程控制请求，请根据数据中心位置使用以下格式示例：

或

搜索以适当的HTTP响应形式返回数据。 完整响应由HTTP状态、HTTP响应头、空行和响应字符串组成。

例如，假定您执行以下远程控制请求：

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index

以下是服务器的响应：

Status: 200 OK 
Content-type: text/plain 
OK

或者，假设您执行以下远程控制状态请求：

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status

来自服务器的响应可能如下所示：

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:58:58-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "status": 1, 
    "message": "ok" 
}

要获取与此索引操作关联的日志列表的前十行及其状态，使用以下查询:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=10

来自服务器的响应：

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:59:30-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "offset": 672, 
    "lines": [ 
        "07/25 16:40:07 PST   ======== Starting manual crawl of account sp99999999. ========", 
        "07/25 16:40:08 PST   Loading existing data", 
        "07/25 16:40:08 PST   Downloading entrypoint https://www.atomz.com/", 
        "07/25 16:40:08 PST   Robots.txt exclude mask: https://www.atomz.com/snap", 
        "07/25 16:40:08 PST   Exclude mask: regexp ^https://www.atomz.com/$", 
        "07/25 16:40:08 PST   Include mask: https://www.atomz.com/", 
        "07/25 16:40:08 PST   Downloading https://www.atomz.com/style.css", 
        "07/25 16:40:09 PST   Ignoring https://www.atomz.com/style.css, document type 'text/css'.", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/privacy.html", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/terms.html" 
    ], 
    "status": 1, 
    "message": "ok" 
}

记下offset值。 此值标识日志文件中读取中断时的文件偏移位置。 要读取文件中的​下一行​十行，您应在发送到服务器的请求中包括&sp_offset=672。

使用sp_offset，您可以有效地翻阅日志文件。

要获取日志的​最后​十行以及状态，请将计数指定为负数。 例如，指定sp_lines=，其值为-10，如下所示：

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=-10

来自服务器的响应：

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T11:01:14-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "lines": [ 
        "07/25 16:40:20 PST   End Time: 07/25/2017 16:40:20 PST", 
        "07/25 16:40:20 PST   Elapsed Time: 13 seconds", 
        "07/25 16:40:20 PST   Pages Crawled: 3 pages", 
        "07/25 16:40:20 PST   Pages Indexed: 3 pages", 
        "07/25 16:40:20 PST   Words/Bytes Indexed: 2373 words/ 20618 bytes", 
        "07/25 16:40:20 PST   Errors: 0", 
        "07/25 16:40:20 PST   *** Index Summary ***", 
        "07/25 16:40:20 PST   Total Pages: 3", 
        "07/25 16:40:20 PST   --------------------------------------------------------------------", 
        "07/25 16:40:20 PST   ======== Finish manual crawl of account sp99999999: Done. ========" 
    ], 
    "status": 1, 
    "message": "ok" 
}

请注意，此处没有返回任何offset值，因为此操作在文件末尾完成，并且没有其他行可供读取。

为索引配置远程控制

只要您的网站发生更改，您就可以使用远程控制从您的服务器运行脚本或项目，请求搜索自动机运行索引。

为索引配置远程控制

1. 在产品菜单上，单击​Index > Remote Control。

2. 在Remote Control页面上，设置每个配置字段选项，以便能够自动提交来自服务器的索引请求以索引您的网站。

   选项	描述
   远程控制密码	指定远程控制密码。 密码区分大小写，长度至少为六个字符，并且必须至少包含一个字母。 建议您还至少包含一个数字。 请勿使用网站搜索/促销登录密码。 您的密码将用于每个远程控制请求。
   确定响应字符串	允许您指定OK响应文本字符串（如果请求的索引操作成功开始）。 在这种情况下，搜索自动机会将您的OK响应字符串返回到服务器。
   优先级响应字符串	如果在发出远程请求时正在执行另一个索引操作，则搜索机器人无法执行所请求的索引。 在这种情况下，您的优先级响应文本字符串将返回到服务器。
   错误响应字符串	允许您指定错误响应文本字符串。如果密码不正确，或发生其他错误。 在这种情况下，搜索自动机会将您的“错误”响应字符串返回给服务器。

3. 单击 Save Changes.