GeoServer是一种开源的、支持ocg协议的地图服务软件，支持跨源数据图层的发布，底层依赖的其实是geotools的实现。GeoServer中原本就支持GeoTiff格式数据的图层发布，但功能比较局限，主要是它只支持本地tiff的发布。在GeoServer的官网中有一款插件，可以实现对Amazon S3协议中的tiff进行加载、发布。本文介绍的就是如何使用该款插件。
- GeoServer安装
GeoServer的安装有多种方式，常用的有两种：war包和exe应用程序。如果使用war包，需要自己部署tomcat；应用程序则比较傻瓜式，且比较稳定，但只能在windows系统中使用。本文使用的是应用程序安装包，GeoServer版本为2.15.0。安装方法官网基本都有介绍，这里略去不提。 - s3-geotiff插件安装
这个插件比较神奇，它目前（2019.03.25）还不是正式发布的插件，而是Community modules中的一项，根据官网所言，这些模块不是官方发布的，同时也是实验性的作品。可能多多少少会有些bug，不过我想基本功能应该可以使用。
适合最新版本的s3-geotiff插件在这个目录里，旧版本的应该能在其上层目录中找到，下载适合自己的版本就好。由于我用的GeoServer是目前最新版本（2.15.0），因此我下载了community-latest目录里的2.16-SNAPSHOT版本。
下载下来是一个zip压缩包，里边全是jar包。假设GeoServer的安装目录是GEOSERVER_HOME，那么只要把这些jar包全部复制到以下目录即可：
GEOSERVER_HOME/webapps/geoserver/WEB_INF/lib
如果使用的是war包安装法，那么把GEOSERVER_HOME替换成tomcat的根目录就行。
- 使用插件
jar包复制完后插件就已经安装好了，现在，如果启动GeoServer，在浏览器打开localhost:8080/geoserver，然后点进数据存储->添加新的数据存储，可以看见多了这么一个东西：
GeoServer插件效果
这就说明插件已经安装成功了。但现在能加载的数据源有限，应该只限于amazon s3上的公共数据，而私有数据，以及其他基于s3协议实现的文件系统（比如Minio）里的数据，还无法访问，仔细翻阅官网的说明文档，还需要进行一些配置才能使用。
所以，现在先把服务关掉，等配置完再重启把~ - Obs配置
基于项目原因，我这边使用的是华为云Obs文件存储服务，它是基于S3协议实现的，理论上可以通过该插件读取。且我还需要读取私有数据，因此得指定ak、sk、endpoint等参数。
首先需要自己新建一个配置文件，在里面对以上参数进行指定，大致如下：
obs.s3.endpoint=obs.cn-north-1.myhwclouds.com
obs.s3.user=你的sk
obs.s3.password=你的sk
每一行最前面的obs可以替换成任何你喜欢的字母，比如prefix，这与最终选择数据源时填写的路径有关。
然后，就是要想办法让这个文件生效，偏偏这点在官网里没有说明。但是，在没有指定配置文件的情况下点击s3插件，后台会报出这么一个提示：
Properties are missing! The system property 's3.properties.location' should be set and contain the path to the s3.properties file.
也就是说，需要有一个环境变量s3.properties.location，其值为我们刚刚创建的那个配置文件的路径。这样就好办了，大概可以直接在系统环境变量里把这东西加进去（我自己没试过），我这边是修改了geoserver启动时的批处理命令startup.bat。exe安装目录下的startup.bat原本大概是这样的：
for /f "delims=" %%i in ('dir /b/s "%~dp0..\webapps\geoserver\WEB-INF\lib\marlin*.jar"') do set MARLIN_JAR=%%i
if not "%MARLIN_JAR%" == "" set MARLIN_ENABLER=-Xbootclasspath/a:"%MARLIN_JAR%" -Dsun.java2d.renderer=org.marlin.pisces.MarlinRenderingEngine
call "MyJavaHome" %MARLIN_ENABLER% -DGEOSERVER_DATA_DIR="MyGeoServerDataDirectory" -Xmx512m -DSTOP.PORT=8079 -DSTOP.KEY=geoserver -Djetty.base="MyGeoServerHome" -Djetty.logs="MyGeoServerHome\logs" -jar "MyGeoServerHome\start.jar" --module=http jetty.port=8080
在命令的最后面加上一条-Ds3.properties.location="MyS3PropertiesPath"即可：
for /f "delims=" %%i in ('dir /b/s "%~dp0..\webapps\geoserver\WEB-INF\lib\marlin*.jar"') do set MARLIN_JAR=%%i
if not "%MARLIN_JAR%" == "" set MARLIN_ENABLER=-Xbootclasspath/a:"%MARLIN_JAR%" -Dsun.java2d.renderer=org.marlin.pisces.MarlinRenderingEngine
call "MyJavaHome" %MARLIN_ENABLER% -DGEOSERVER_DATA_DIR="MyGeoServerDataDirectory" -Xmx512m -DSTOP.PORT=8079 -DSTOP.KEY=geoserver -Djetty.base="MyGeoServerHome" -Djetty.logs="MyGeoServerHome\logs" -jar "MyGeoServerHome\start.jar" --module=http jetty.port=8080 -Ds3.properties.location="MyS3PropertiesPath"
批处理命令中的路径都要用双引号括起来。如果用的是war包安装，据说需要修改TOMCAT_HOME/bin目录下的catalina.bat文件，在里面添加一条set CATALINA_OPTS="MyS3PropertiesPath"，虽然我自己还是没试过就是了（跑）。
-
发布图层
这样一来配置就完成了，重新启动GeoServer，点进新增的S3GeoTiff里，长这样：
S3GeoTiff界面
其他都随意，就是那个连接参数需要注意一下。官网里说填写格式是这样的：
prefix://bucket/key?useAnon=true&awsRegion=CN_NORTH_1
prefix就是配置文件里每一行的头一个单词，在我的配置文件中就是obs，这个是用来与默认的s3区分，告诉GeoServer不要去亚马逊s3去找，而是去我们自己定义的endpoint域名下去找，也可以是Minio的http://ip:port模式。useAnon这个参数好像是指定是否要使用用户的认证参数，不用的话就是用默认的连接证书，由于我们需要访问私有数据，因此该参数应该设置为true。后面的awsRegion根据情况设置即可，我的Obs地区是CN_NORTH_1，不设置的话默认好像是US_EAST_1。这里比较恶心的是，region要全用大写字母，且用下划线做连接符，比如不能按照一般的写成cn-north-1形式。这也是我根据后台报错和查看源码得出来的结果（希望正式发布能把这个问题改改掉）。
组织好自己的URL后填进去，保存->发布->预览一气呵成，结果如下：
图层预览
最后再吐槽一下，这个插件一次只能选择单个tiff文件为对象，不能选择多个或一个文件夹（和原生的GeoTiff加载一样），用着还是不那么方便。有机会的话可以试着改改它的代码，有机会的话。
网友评论