fdsnws

提供 FDSN 网络服务

描述

fdsnws 从 SeisComP3 数据库或记录源提供 FDSN 网络服务。有效服务：

如果fdsnws启动，默认监听8080端口，如果配置可更改该端口。

数据选择

• MiniSEED 格式的时序数据
• 请求类型 HTTP-GET 和 HTTP-POST

URL

• http://localhost:8080/fdsnws/dataselect/1/query
• http://localhost:8080/fdsnws/dataselect/1/queryauth
• http://localhost:8080/fdsnws/dataselect/1/version
• http://localhost:8080/fdsnws/dataselect/1/application.wadl

示例

http://localhost:8080/fdsnws/dataselect/1/query?net=GE&sta=BKNI&cha=BH?&start=2013-04-11T00:00:00&end=2013-04-11T12:00:00

POST 请求可通过curl命令：

sysop@host:~$ curl -X POST --data-binary @request.txt "http://localhost:8080/fdsnws/dataselect/1/query"

注释

• quality参数不会生效
• minimumlength参数不会生效
• longestonly参数不会生效
• 仅通过queryauth方法授权访问受限台网和台站

台站

• 台网，台站，通道，响应元数据
• 请求类型： HTTP-GET 和 HTTP-POST
• 台站可被（如地理区域或时间）过滤，信息深度级是可选择的

URL

• http://localhost:8080/fdsnws/station/1/query
• http://localhost:8080/fdsnws/station/1/version
• http://localhost:8080/fdsnws/station/1/application.wadl

示例

http://localhost:8080/fdsnws/station/1/query?net=GE&level=sta

注释

• 加载fdsnxml和staxml插件，允许支持FDSNXML或StationXML
• updatedafter请求参数不会生效
• includeavailability请求参数不会生效
• matchtimeseries全球参数不会生效
• formatted默认false
• 请求参数附加值：
  • 格式
    • 标准：[xml, text]
    • 附加：[fdsnxml (=xml), stationxml, sc3ml]
    • 默认：xml

事件

• 提供地震初动和震级估算
• 请求类型：HTTP-GET
• 事件可被（如震源、时间和震级）过滤

URL

• http://localhost:8080/fdsnws/event/1/query
• http://localhost:8080/fdsnws/event/1/catalogs
• http://localhost:8080/fdsnws/event/1/contributors
• http://localhost:8080/fdsnws/event/1/version
• http://localhost:8080/fdsnws/event/1/application.wadl

示例

http://localhost:8080/fdsnws/event/1/query?start=2013-04-18&lat=55&lon=11&maxradius=10

注释

• updatedafter请求参数不会生效
• 附加的请求参数：
  • includepicks默认false
  • includecomments默认true
  • formatted默认false
• 请求参数附加值：
  • 格式：
    • 标准：[xml, text]
    • 附加：[qml (=xml), qml-rt, sc3ml, csv]
    • 默认：xml

更改服务端口

欲使 FDSN 网络服务监听 80 端口，需要：

• 以 root 权限运行 SeisComP3（不建议）
• 使用代理网络服务器，如 Apache（mod-proxy）
• 配置并使用 Authbind
• 设置防火墙重定向规则

Authbind

authbind允许一个不能或不该以 root 运行的程序，以可控方式绑定至低序号端口。下例显示如何为sysop 用户安装并设置 authbind：

sysop@host:~$ sudo apt-get install authbind
sysop@host:~$ sudo touch /etc/authbind/byport/80
sysop@host:~$ sudo chown sysop /etc/authbind/byport/80
sysop@host:~$ sudo chmod 500 /etc/authbind/byport/80

一旦正确配置authbind，FDSN 网络服务可被启动：

sysop@host:~$ authbind --deep seiscomp exec fdsnws

防火墙

所有主流 Linux 分发包都有防火墙，应用iptables内核函数。下例添加一条规则，将端口 8080 重定向至 80：

sysop@host:~$ sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to 8080

配置

etc/defaults/global.cfg
etc/defaults/fdsnws.cfg
etc/global.cfg
etc/fdsnws.cfg
~/.seiscomp3/global.cfg
~/.seiscomp3/fdsnws.cfg