QGIS Server使用记录

0. 简述

关于QGIS Server相关的文档很少,我也没有找到其源码在哪里,所以有些问题也不知道怎么解决,只能慢慢摸索。

这里只记录了在windows 10上安装使用的过程,在linux下过程也差不多,但是简单多了,很多缺失的东西可以直接命令安装。

我这里使用了最高版本的,但是最好还是使用长期版本,没有这么多问题。

参考:

1. 下载QGIS桌面64位版本

也可以不下载,使用OSGeo4W在线安装程序,只安装qgis-server但我测试这个安装不全。我安装是最新的3.2.3版本。

QGIS Server使用记录

使用在线安装的时候,下载站点最好选择http://download.osgeo.org,这个网站下载最快。

下载地址: https://qgis.org/downloads/QGIS-OSGeo4W-3.2.3-1-Setup-x86_64.exe

安装的时候最好不要安装在C盘(win10下会很多地方有权限问题),安装路径中也最好不要有空格,原因后面会提到。

2. 下载安装QGIS Server程序

下载地址:http://download.osgeo.org/osgeo4w/x86_64/release/qgis/qgis-server/

这里没有找到32位版本程序的下载,只能下载64位版本。下载的版本要与桌面版本一致。

下载之后解压到QGIS的安装目录即可,压缩包内的目录结构与QGIS安装目录结构是对应的。

然后复制一份httpd.d目录下的httpd_qgis.conf.tmpl文件,改名为httpd_qgis.conf

QGIS Server使用记录

然后编辑这个新文件

  • 将里面的@osgeo4w@替换为QGIS的安装目录
  • @grassversion@替换为grass的版本号
  • @windir@替换为windows的目录。

    或者直接运行一下QGIS安装目录下的etc/postinstall下的qgis-server.bat脚本即可。

    修改的结果大致如下:

    QGIS Server使用记录

3. 下载安装Apache服务器

qgis server实质上是一个cgis程序,所以需要Apache服务器来调用。

Apache下载地址:https://www.apachelounge.com/download/

下载后直接解压即可,注意不要解压到有空格的目录。

解压之后修改conf目录下在httpd.conf

首先修改最前面的SVRROOT变量值

Define SRVROOT "C:/Apache24"
ServerRoot "${SRVROOT}"

然后在最后位置,把httpd_qgis.conf包含进去

include "C:/Program Files/QGIS 3.2/httpd.d/*.conf"

因为qgis server是一个fastcgi程序,所以这里需要下载apache的fastcgi模块

下载地址:https://www.apachelounge.com/download/

注意要下载与apache对应的版本。

下载之后解压到apache目录下的modules目录下即可。

4、使用及问题处理

完成上面的步骤之后,可以启动apache安装目录下的bin/httpd.exe程序了。

如果没有报错,则可以获取一下GetCapabilities试试

QGIS Server使用记录

这里我在httpd.conf中修改了端口,所以访问的是8080端口。

Forbidden

You don't have permission to access /qgis/qgis_mapserv.fcgi.exe on this server.

这里可以看到,返回了403错误,这里说明这个文件是存在的,只是被apache禁止访问了。

这里修改下apache的httpd.conf文件

<Directory />
AllowOverride none
Require all denied
</Directory>

修改为

<Directory />
AllowOverride none
Require all granted
</Directory>

或者修改httod_qgis.conf文件,添加Require all granted即可。

重启httpd.exe后继续测试,这时候发现返回的错误码变成了503

QGIS Server使用记录

这时候可以打开apache的日志看看错误的原因。

QGIS Server使用记录

这里可以看到,还是这个路径中有空格的原因。

这个问题两个解决办法

  • 一是把qgis_mapserv.fcgi.exe程序文件复制到Apache安装目录下的cgi-bin目录中,然后访问http://127.0.0.1:8080/cgi-bin/qgis_mapserv.fcgi.exe?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities
  • 二是重新安装qgis到没有空格的路径中去。

然后继续测试,还可以遇到问题。

如下:

QGIS Server使用记录

这个问题也很好解决,这是因为qgis_mapserv.fcgi.exe编译的时候依赖的这些动态库并没有打包到里面来,需要自己去下载过来。同样缺失的还有QtXml4.dllQtCore4.dllQtGui4.dllQtNetwork4.dllQtSvg4.dll,这些dll在QGIS2.18的安装目录下可以找到。我这里打包上传一下,地址在这里qgis_mapserv.fcgi.exe-depends.7z。也可以使用OSGeo4W在线安装程序下载。

继续测试,这里还会碰到问题:

QGIS Server使用记录

offscreen插件是Qt用于离屏渲染的,在Qt5.1版本才提供。

打开httpd_qgis.conf文件,可以看到在定义Qt插件路径变量QT_PLUGIN_PATH的值的时候,里面对应路径是qt4的,这里只需要把4改为5即可。

修改完成之后,重启httpd.exe继续测试。

经过上面处理之后,qgis_mapserv.fcgi.exe确实能够被调用运行了,这个通过ProcessMinitor可以监测到调用过程。

按照网上一些资料的说法,将QGIS的工程文件xxx.qgs放入qgis_mapserv.fcgi.exe所在目录,就可以用于提供默认的服务,不必指定map选项参数。但是我测试GetCapabilities的结果没有成功,程序执行后返回500错误,也就是qgis_mapserv.fcgi.exe程序没有正确返回对应的XML内容,在请求的时候添加map=xxx.qgsmap=xxx也都是失败的。因为没有相关的文档和源码,这个还需要继续测试。

上一篇:zookeeper安装步骤


下一篇:【CSS3】css3:box-sizing属性