11.1. Lesson: QGISサーバーをインストールする

The goal for this lesson: To learn how to install QGIS Server on Debian Stretch. With negligible variations you can also follow it for any Debian based distribution like Ubuntu and its derivatives.


In Ubuntu you can use your regular user, prepending sudo to commands requiring admin permissions. In Debian you can work as admin (root), without using sudo.

11.1.1. moderate Follow Along: パッケージからインストールする

In this lesson we're going to do only the install from packages as shown here .


apt install qgis-server
# if you want to install server plugins, also:
apt install python-qgis

QGIS Server should be used in production without QGIS Desktop (with the accompanying X Server) installed on the same machine.

11.1.2. moderate Follow Along: QGISサーバー実行可能ファイル

QGISサーバー実行可能ファイルは、 qgis_mapserv.fcgi です。 /usr/lib/cgi-bin/qgis_mapserv.fcgi のような何かを出力する find / -name 'qgis_mapserv.fcgi' を実行して、どこにインストールされたかを確認できます。

この時点では、コマンドラインのテストを行いたい場合は、オプションで /usr/lib/cgi-bin/qgis_mapserv.fcgi コマンドを実行できます、出力は何かこのようなはずである:

QFSFileEngine::open: No file name specified
Warning 1: Unable to find driver ECW to unload from GDAL_SKIP environment variable.
Warning 1: Unable to find driver ECW to unload from GDAL_SKIP environment variable.
Warning 1: Unable to find driver JP2ECW to unload from GDAL_SKIP environment variable.
Warning 1: Unable to find driver ECW to unload from GDAL_SKIP environment variable.
Warning 1: Unable to find driver JP2ECW to unload from GDAL_SKIP environment variable.
Content-Length: 206
Content-Type: text/xml; charset=utf-8

<ServiceExceptionReport version="1.3.0" xmlns="https://www.opengis.net/ogc">
 <ServiceException code="Service configuration error">Service unknown or unsupported</ServiceException>


11.1.3. Follow Along: HTTPサーバー構成


In this lesson we're going to use the Apache HTTP server, colloquially called Apache.

First we need to install Apache by running the following command in a terminal:

apt install apache2 libapache2-mod-fcgid

You can run QGIS server on your default website, or configure a virtualhost specifically for this, as follows.

/etc/apache2/sites-available ディレクトリ中に qgis.demo.conf と呼ばれるファイルを、以下の内容で作成してみましょう:

<VirtualHost *:80>
  ServerAdmin [email protected]
  ServerName qgis.demo

  DocumentRoot /var/www/html

  # Apache logs (different than QGIS Server log)
  ErrorLog ${APACHE_LOG_DIR}/qgis.demo.error.log
  CustomLog ${APACHE_LOG_DIR}/qgis.demo.access.log combined

  # Longer timeout for WPS... default = 40
  FcgidIOTimeout 120

  FcgidInitialEnv LC_ALL "en_US.UTF-8"
  FcgidInitialEnv LANG "en_US.UTF-8"

  # QGIS log (different from apache logs) see https://docs.qgis.org/testing/en/docs/user_manual/working_with_ogc/ogc_server_support.html#qgis-server-logging
  FcgidInitialEnv QGIS_SERVER_LOG_FILE /var/log/qgis/qgisserver.log

  FcgidInitialEnv QGIS_DEBUG 1

  # default QGIS project
  SetEnv QGIS_PROJECT_FILE /home/qgis/projects/world.qgs

  # QGIS_AUTH_DB_DIR_PATH must lead to a directory writeable by the Server's FCGI process user
  FcgidInitialEnv QGIS_AUTH_DB_DIR_PATH "/home/qgis/qgisserverdb/"
  FcgidInitialEnv QGIS_AUTH_PASSWORD_FILE "/home/qgis/qgisserverdb/qgis-auth.db"

  # See https://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/supported_data.html#pg-service-file
  SetEnv PGSERVICEFILE /home/qgis/.pg_service.conf
  FcgidInitialEnv PGPASSFILE "/home/qgis/.pgpass"

  # Tell QGIS Server instances to use a specific display number
  FcgidInitialEnv DISPLAY ":99"

  # if qgis-server is installed from packages in debian based distros this is usually /usr/lib/cgi-bin/
  # run "locate qgis_mapserv.fcgi" if you don't know where qgis_mapserv.fcgi is
  ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
  <Directory "/usr/lib/cgi-bin/">
    AllowOverride None
    Options +ExecCGI -MultiViews -SymLinksIfOwnerMatch
    Order allow,deny
    Allow from all
    Require all granted

 <IfModule mod_fcgid.c>
 FcgidMaxRequestLen 26214400
 FcgidConnectTimeout 60


You can do the above in a linux Desktop system by pasting and saving the above configuration after doing nano /etc/apache2/sites-available/qgis.demo.conf.


高度な構成 セクションの構成オプションのいくつかのサーバーで説明されているを参照してください。


mkdir /var/log/qgis/
chown www-data:www-data /var/log/qgis

mkdir /home/qgis/qgisserverdb
chown www-data:www-data /home/qgis/qgisserverdb


WWW-data は、Debianベースのシステム上のApacheのユーザーであり、それらの場所やファイルへのアクセス権を持っているようにApacheを必要としています。 chown www-data... コマンド www-data にそれぞれのディレクトリとファイルの所有者を変更します。

これで 仮想ホスト を有効にできますので、 fcgid mod がまだ有効になっていない場合は有効にして apache2 サービスを再起動します:

a2enmod fcgid
a2ensite qgis.demo
systemctl restart apache2


(Linuxのデスクトップに含まれる)Xサーバーを実行せずにQGISサーバーをインストールし、また、 GetPrint コマンドを使用する場合、偽のX Serverをインストールし、それを使用するQGISサーバーに指示する必要があります。次のコマンドを実行して、それを行うことができます。


apt install xvfb


sh -c \
"echo \
Description=X Virtual Frame Buffer Service

ExecStart=/usr/bin/Xvfb :99 -screen 0 1024x768x24 -ac +extension GLX +render -noreset

WantedBy=multi-user.target' \
> /etc/systemd/system/xvfb.service"

xvfb.service の状態を有効にし、開始し、チェックします:

systemctl enable xvfb.service
systemctl start xvfb.service
systemctl status xvfb.service

In the above configuration file there's a FcgidInitialEnv DISPLAY ":99" that tells QGIS Server instances to use display no. 99. If you're running the Server in Desktop then there's no need to install xvfb and you should simply comment with # this specific setting in the configuration file. More info at https://www.itopen.it/qgis-server-setup-notes/.

Now that Apache knows that he should answer requests to http://qgis.demo we also need to setup the client system so that it knows who qgis.demo is. We do that by adding qgis.demo in the hosts file. We can do it with sh -c "echo ' qgis.demo' >> /etc/hosts". Replace with the IP of your server.


Remember that both the myhost.conf and /etc/hosts files should be configured for our setup to work. You can also test the access to your QGIS Server from other clients on the network (e.g. Windows or macOS machines) by going to their /etc/hosts file and point the myhost name to whatever IP the server machine has on the network. You can be sure that that specific IP is not as that's the local IP, only accessible from the local machine. On *nix machines the hosts file is located in /etc, while on Windows it's under the C:\Windows\System32\drivers\etc directory. Under Windows you need to start your text editor with administrator privileges before opening the hosts file.

私たちは、 curl http://qgis.demo/cgi-bin/qgis_mapserv.fcgi を使用して、コマンドラインからのHTTPリクエストと一緒にインストールされたQGISサーバーのいずれかをテストできます、出力はこうなるべき:

<ServiceExceptionReport version="1.3.0" xmlns="https://www.opengis.net/ogc">
<ServiceException code="Service configuration error">Service unknown or unsupported</ServiceException>


curl can be installed with apt install curl.

これでApache が構成されました。

Also, from your web browser you can check the capabilities of the server:


11.1.4. moderate Follow Along: 別の仮想ホストを作成

QGISサーバーを指す別のApacheの仮想ホストを作成してみましょう。好きな名前を選択できます( coco.bangosuper.duper.trainingexample.com、など)が、単純化のために myhost を使用するつもりです。

  • Let's set up the myhost name to point to the localhost IP by adding x to the /etc/hosts with the following command: sh -c "echo ' myhost' >> /etc/hosts" or by manually editing the file with gedit /etc/hosts.

  • ターミナルで ping myhost コマンドを実行することによって、 myhost がlocalhostを指していることを確認できます。

[email protected]:~$ ping myhost
PING myhost ( 56(84) bytes of data.
64 bytes from localhost ( icmp_seq=1 ttl=64 time=0.024 ms
64 bytes from localhost ( icmp_seq=2 ttl=64 time=0.029 ms
  • curl http://myhost/cgi-bin/qgis_mapserv.fcgi したり、DebianのボックスブラウザからURLにアクセスすることによって、 myhost サイトからQGISサーバーにアクセスできるかどうか試してみましょう。おそらく得られるのは:

<title>404 Not Found</title>
<h1>Not Found</h1>
<p>The requested URL /cgi-bin/qgis_mapserv.fcgi was not found on this server.</p>
<address>Apache/2.4.25 (Debian) Server at myhost Port 80</address>
  • Apache doesn't know that he's supposed to answer requests pointing to the server named myhost. In order to setup the virtual host the simplest way would be to make a myhost.conf file in the /etc/apache2/sites-available directory that has the same content as qgis.demo.conf except for the ServerName line that should be ServerName myhost. You could also change where the logs go as otherwise the logs for the two virtual hosts would be shared but this is optional.

  • Let's now enable the virtual host with a2ensite myhost.conf and then reload the Apache service with service apache2 reload.

  • 再度 http://myhost/cgi-bin/qgis_mapserv.fcgi URLにアクセスするために試してみると、すべてが今稼働していることに気づくでしょう!

11.1.5. In Conclusion


11.1.6. What's Next?

Now that you've installed QGIS Server and it's accessible through the HTTP protocol, we need to learn how to access some of the services it can offer. The topic of the next lesson is to learn how to access QGIS Server WMS services.