メインコンテンツへスキップ

OpenBSD httpd について

    NetBSD の bozohttpd を紹介しましたので、今回は OpenBSD の httpd を紹介したいと思います。

    はじめに

    OpenBSD には、httpd という HTTP サーバーが含まれます。名前は、ただの "httpd" です。実にそっけなく、一般的なプログラム名なのでちょっと困ります。特に Apache の実行ファイルも同じ "httpd" なので注意が必要です。OpenHttpd とかにしてくれたら良かったのですが…。私は、名前のせいでこの httpd の存在にずっと気づかず、Apache をインストールしていました。

    bozohttpd ほどではありませんが、使い方は簡単です。base system に含まれますので、インストール作業は不要です。


    設定

    doas(1) の設定は終わっているものとして説明します。doas は最小限、/etc/examples/doas.conf を /etc/doas.conf にコピーすれば使えます。それだけで、ユーザーが wheel グループに追加してあれば、sudo と同じく、ユーザーパスワードを入力するだけで root 権限で作業できます。

    httpd の設定ファイルは /etc/httpd.conf です。これがないと httpd を起動できませんので準備します。最小の設定は次のとおりです。

    /etc/httpd.conf

    server "default" {
        listen on * port 80
        root "/htdocs"
    }

    設定の確認は次のコマンドで行います。

    $ doas httpd -n
    configuration OK

    この設定で、ブラウザで http://ホスト名/ にアクセスすると、/var/www/htdocs のファイルを読めるようになります。ちなみに、httpd は /var/www に chroot されるようになっていて、/var/www 以下しかアクセスできないようになっています。

    次に、httpd を有効化し、起動します。

    $ doas rcctl enable httpd
    $ doas rcctl start httpd

    FreeBSD/NetBSD だと /etc/rc.conf で xxx_enable="YES" にしますが、OpenBSD では rcctl(RC Control)コマンドで設定します。rcctl enable すると、/etc/rc.conf.local に設定が書き込まれることによって有効化されます。

    これで、/var/www/htdocs に HTML ファイルを置けば、ブラウザから読むことができます。

    サービスを止めるには、次のコマンドを使います。

    $ doas rcctl stop httpd


    httpd の特徴

    bozohttpd は機能を絞ることによって、お手軽・簡単・軽くて速いといった特徴を持っていましたが、httpd はこれとは違い、高機能でありながらシンプルでセキュアという、OpenBSD 由来のツール共通の特徴を持っています。

    httpd は、OpenBSD 独自のシステムコール pledge と unveil を使うことで、高いセキュリティを実現しています。

    Pledge, and Unveil, in OpenBSD

    pledge と unveil は、簡単に言うと、使えるシステムコールとアクセスできるファイルを制限してセキュリティを確保する仕組みです。つまりシステムコールレベルで sandbox を実現していると言えます。ファイルシステムの見える範囲の制限は、シンプルに chroot によって行われます。UNIX 哲学に忠実な役割分担とモダンなセキュリティの組み合わせです。

    httpd の詳細については、man page の httpd(8) と httpd.conf(5) をご参照ください。

    なお、CGI には、FastCGI が採用されているけれど、名前は、slowcgi(8) です。slow だけど速い。リクエストのたびにプロセスを立ち上げるのではなく、常駐してプロセスを使い回すことによって大幅な高速化を実現しています。
    HTTPS/TLS にも、acme-client(1) で対応していますし、その他多くの機能を持っています。


    httpd は、本格的に HTTP サーバーを運用するのにも十分な機能を備えています。試しに WordPress を立ち上げてみました。

    httpd + php-fpm + MariaDB で WordPress を動かす手順を紹介します。

    WordPress を httpd で立ち上げる

    1. 必要なパッケージをインストール

    PHP のバージョンは、現時点(2026年6月)では 8.4 がおすすめです。

    $ doas pkg_add mariadb-server php php-mysqli

    途中で次のように聞かれます。

    Ambiguous: choose package for php
    Ambiguous: choose package for php-mysqli

    それぞれ php-8.4.x と php-mysqli-8.4.x を選択します。

    インストールが完了すると、次のようなメッセージが表示されます。

    The following new rcscripts were installed: /etc/rc.d/mysqld /etc/rc.d/php84_fpm

    2. MariaDB の立ち上げ

    初期化します。

    $ doas mariadb-install-db

    起動設定をします。

    $ doas rcctl enable mysqld
    $ doas rcctl start mysqld

    確認します。

    $ rcctl check
    mysqld mysqld(ok)

    3. WordPress 用データベース作成

    MariaDB に入ります。

    $ doas mysql

    データベースとユーザーを作成します。

    CREATE DATABASE wordpress; CREATE USER 'wpuser'@'127.0.0.1' IDENTIFIED BY 'password';
    GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'127.0.0.1';
    FLUSH PRIVILEGES;
    EXIT;

    Linux などでの WordPress の設定例だと 'localhost' になっていることが多いと思いますが、ここは '127.0.0.1' を指定します。理由は後述します。

    4. mysqli の設定

    $ doas cp /etc/php-8.4.sample/mysqli.ini /etc/php-8.4/

    サンプルファイルを /etc/php-8.4 に持ってくるだけです。編集せずそのままで大丈夫

    5. PHP-FPM の有効化

    設定ファイルをコピーします。

    $ doas cp /etc/php-8.4.ini /etc/php.ini

    php-fpm を起動します。

    $ doas rcctl enable php84_fpm
    $ doas rcctl start php84_fpm

    確認します。

    $ rcctl check php84_fpm
    php84_fpm(ok)

    6. WordPress のインストール

    日本語版をダウンロードして展開して /var/www にコピーします。所有者をwww ユーザー、wwwグループにしておきます。

    $ ftp https://ja.wordpress.org/latest-ja.tar.gz
    $ tar zxf latest-ja.tar.gz
    $ doas cp -R wordpress /var/www/
    $ doas chown -R www:www /var/www/wordpress

    wp-config.php を準備します。doas は -u user で root ではなく、他のユーザー権限でコマンドを実行することができます。-u www で実行しておけば、あとで chown www をしなくて済みます。

    $ doas -u www cp /var/www/wordpress/wp-config-sample.php /var/www/wordpress/wp-config.php
    $ doas -u www vi /var/www/wordpress/wp-config.php

    次の項目を編集します。

    define('DB_NAME', 'wordpress');
    define('DB_USER', 'wpuser');
    define('DB_PASSWORD', 'password');
    define('DB_HOST', '127.0.0.1');

    それぞれ任意の名前やパスワードにします。これらは、wordpress にブラウザからアクセスする際に使用します。DB_HOST は 'localhost' でなく、'127.0.0.1' です。

    DB_HOST に 'localhost' ではなく '127.0.0.1' を指定する理由について説明します。
    PHP の mysqli 拡張では、DB_HOST に localhost を指定した場合は Unix ドメインソケット経由で接続し、127.0.0.1 を指定した場合は TCP/IP で接続します。
    OpenBSD httpd は /var/www に chroot する仕様上、mariadb の ソケット経由での接続が失敗することがあります。このため、DB_HOST には '127.0.0.1' を指定することで、TCP/IP で接続します。
    MariaDB のユーザー登録で '127.0.0.1' にしたのも、これに合わせるためです。

    wp-config.php には平文でパスワードが書かれているので、パーミッションの設定を忘れずに確認しておきましょう。パーミッションは 400 または 440 に設定します。

    $ doas chmod 440 /var/www/wordpress/wp-config.php
    $ ls -l /var/www/wordpress/wp-config.php
    -r--r----- 1 www www 3024 Jun 16 12:00 wp-config.php


    7. httpd.conf の設定

    $ doas vi /etc/httpd.conf

    次の内容に編集します。(php-fpm に関しては、socket で大丈夫です。)

    server "default" {
        listen on * port 80
        root "/wordpress"
        directory index index.php
        location "*.php" {
            fastcgi socket "/run/php-fpm.sock"
        }
    }

    設定を確認して再起動します。

    $ doas httpd -n
    configuration OK
    $ doas rcctl restart httpd
    httpd(ok)
    httpd(ok)

    8. WordPress のセットアップ

    ブラウザで次の URL にアクセスしてセットアップを完了させます。

    http://ホスト名/wp-admin/install.php

    まとめ

    このように、OpenBSD には Apache や Nginx に匹敵する本格的な HTTP サーバーが base system に組み込まれています。
    httpd は、セキュリティ強化のために OpenBSD 独自の pledge と unveil を利用しているので、他の OS への移植はされていません。
    httpd を利用するには OpenBSD そのものの導入が必要になりますが、よりセキュアな HTTP サーバーを必要とするなら、OpenBSD の導入を検討してみてはいかがでしょうか?

    あなたへのおすすめ