setting_up_web_server.html (13203B)
1 <!DOCTYPE html> 2 <html> 3 <head> 4 <meta charset="utf-8"> 5 <meta name="viewport" content="width=device-width,initial-scale=1"> 6 <link rel="stylesheet" type="text/css" href="/style.css"> 7 <link rel="icon" type="image/x-icon" href="/pics/favicon.ico"> 8 <title>Webサーバーの設定</title> 9 </head> 10 <body> 11 <header> 12 <a href="/">主頁</a> | 13 <a href="/about.html">自己紹介</a> | 14 <a href="/journal">日記</a> | 15 <a href="/farm">農業</a> | 16 <a href="/kitchen">台所</a> | 17 <a href="/computer">電算機</a> | 18 <a href="/poetry">詩</a> | 19 <a href="/books">本棚</a> | 20 <a href="/gallery">絵</a> | 21 <a href="https://git.mtkn.jp">Git</a> 22 </header> 23 <main> 24 <article> 25 <h1>Webサーバーの設定</h1> 26 <time>2022-06-27</time> 27 28 <h2>はじめに</h2> 29 <p>OpenBSDでWebサーバーを公開する方法のメモ。といってもmanページが完璧なのであまり書く必要はない。ドメインのあたりの知識は適当なので間違っていたらごめんなさい。コンピュータの知識は全部独学なので多少間違った理解をしていても訂正されることがない。言葉の定義等細かいことがいいかげんになりがちである。</p> 30 31 <h2>環境</h2> 32 <ul> 33 <li>OS: OpenBSD 7.1</li> 34 <li>サーバー: httpd（OpenBSDに付属のもの）</li> 35 <li>サーバー証明書: Let's Encrypt</li> 36 <li>サーバー: さくらのVPS。ここではIPアドレスを<code><i><server_ip></i></code>とする。</li> 37 <li>ドメイン: さくらのドメイン。ここでは<code><i><server_domain></i></code>とする。</li> 38 </ul> 39 40 <h2>設定の概要</h2> 41 <dl> 42 <dt>サーバーを用意</dt> 43 <dd>サーバーはウェブサイトのデータを保存し、ブラウザからアクセスされた時にそのデータを送り返すためのものである。ここではさくらのVPSを用いた。 </dd> 44 <dt>ドメインの取得とDNSの設定</dt> 45 <dd>インターネット上のサーバー等はIPアドレスを用いて識別されているが、数字の羅列なので人間には覚えにくい。そのためドメイン名という、好きなアルファベットの文字列をIPアドレスと紐付ける。インターネットにはこのドメイン名を用いて紐付いたサーバーと通信できるような仕組みがあり、これをDomain Name System（DNS）という。ドメインはインターネット上で利用料を支払うことで購入できる。IPアドレスとドメイン名の紐付け等DNSの設定は基本的にはドメインを購入したサイトでできるはずである。</dd> 46 <dt>httpdの設定</dt> 47 <dd>VPS上でサーバー用のソフトウェアを設定、起動する。</dd> 48 <dt>証明書の発行と自動更新の設定</dt> 49 <dd>ウェブブラウザとサーバーの間で暗号化された通信を行うために必要なものである。</dd> 50 <dt>ホームページのファイルをアップロード</dt> 51 <dd>ウェブページで配信したいものをVPSにアップロードする。</dd> 52 <dt>接続の確認</dt> 53 <dd>手元のブラウザからアクセスできることを確認。</dd> 54 </dl> 55 56 <h2>サーバーを用意</h2> 57 <p>サーバーをどこかで契約する。ここではさくらのVPSを利用。</p> 58 59 <h2>ドメインの取得とDNSの設定</h2> 60 <p>ドメインを好きな場所で取得してDNSを設定する。さくらのドメインではドメインコントロールパネルのゾーン情報から設定できる。ここではサブドメインなしのものと、サブドメインがwwwのものを設定した。VPSのIPアドレスはVPSのコントロールパネルから確認できる。</p> 61 <pre><code>HOST TYPE POINTS TO TTL 62 <i><server_domain></i> A <i><server_ip></i> 3600 63 www.<i><server_domain></i> A <i><server_ip></i> 3600</code></pre> 64 <p><code>HOST</code>はサーバーのFQDN。コントロールパネル上ではサブドメインの部分だけを設定すればよい。サブドメインが無い場合は<code>@</code>と記入する。<code>TYPE</code>は設定するレコードの属性でIPv4のサブドメインを設定する場合は<code>A</code>。この他、IPv6用の<code>AAAA</code>やメールサーバー用の<code>MX</code>、サーバーの別名を登録する<code>CNAME</code>等がある。<code>POINTS TO</code>はサーバーのIPアドレス。<code>TTL</code>はDNSのキャッシュの生存時間の秒数で、DNSの登録内容を変更した際にその変更が世界中のDNSサーバーに反映されるまでにかかる最大の時間である。世界中から多くのアクセスがあるサーバーの場合、DNSの登録内容を変更する前にTTLを短かくしておかないと、キャッシュが破棄されるまでアクセス不能になる。個人のウェブページではまあそんなにアクセスもないし適当でよさそう。ここでは1時間を指定した。</p> 65 <p>この設定が反映されれば、ドメイン名からサーバーにアクセスできるようになる。</p> 66 <pre><code>$ ping <i><server_domain></i> 67 PING <i><server_domain></i> (<i><server_ip></i>): 56 data bytes 68 64 bytes from <i><server_ip></i>: icmp_seq=0 ttl=243 time=38.032 ms 69 64 bytes from <i><server_ip></i>: icmp_seq=1 ttl=243 time=27.923 ms 70 ^C</code></pre> 71 72 <h2>httpdの設定</h2> 73 <p>VPSにログインし、httpdを設定する。まずは<code>/etc/examples/</code>にある設定ファイルのサンプルを<code>/etc/</code>にコピーして必要な部分を変更する。</p> 74 <pre><code>$ doas cp /etc/examples/httpd.conf /etc/ 75 vi /etc/httpd.conf</code></pre> 76 77 <pre><code># $OpenBSD: httpd.conf,v 1.22 2020/11/04 10:34:18 denis Exp $ 78 79 server "<i><server_domain></i>" { 80 listen on * port 80 81 location "/.well-known/acme-challenge/*" { 82 root "/acme" 83 request strip 2 84 } 85 location * { 86 block return 302 "https://$HTTP_HOST$REQUEST_URI" 87 } 88 } 89 90 server "<i><server_domain></i>" { 91 listen on * tls port 443 92 tls { 93 certificate "/etc/ssl/<i><server_domain></i>.fullchain.pem" 94 key "/etc/ssl/private/<i><server_domain></i>.key" 95 } 96 location "/.well-known/acme-challenge/*" { 97 root "/acme" 98 request strip 2 99 } 100 location "*" { 101 root "/htdocs/www.<i><server_domain></i>" 102 directory auto index 103 } 104 }</code></pre> 105 <p>一つ目の<code>server</code>ディレクティブは80番ポートにアクセスがあった時の設定。80番ポートは暗号化なしのアクセスなので、二つ目の<code>location</code>ディレクティブで暗号化ありの<code>https</code>の方にリダイレクトさせるようにしている。一つ目の<code>location</code>ディレクティブは<code>acme-client</code>がサーバー証明書を発行する際にアクセスされる場所である。既定値のままにしておけばよい。二つ目の<code>server</code>ディレクティブは443番ポートにアクセスがあった時の設定。<code>tls</code>ディレクティブにおいてサーバー証明書と、暗号化に利用する鍵が設定されている。これも既定値のままでいい。<code>location</code>ディレクティブはウェブサーバーにアクセスがあった時の処理である。一つ目は80番ポートと同じく<code>acme-client</code>用。二つ目はそれ以外である。<code>root</code>（ドキュメントルート）はアクセスがあったときにどこのディレクトリからファイルを探すかを決めるもので、<code>/var/www</code>からの相対パスで記述する。ここでは<code>/htdocs/www.<i><server_domain></i></code>にしたのでウェブページのデータは<code>/var/www/htdock/www.<i><server_domain></i>/</code>というディレクトリ以下に配置することになる。</p> 106 <p>ここで一度<code>httpd</code>を<code>-n</code>オプションを付けて実行し、設定ファイルのミスがないか確認しておく。</p> 107 <pre><code>$ doas httpd -n 108 configration OK</code></pre> 109 110 <h2>証明書の発行と自動更新の設定</h2> 111 <p>httpsによる暗号化に対応するため、Let's Encryptを使って証明書を発行する。OpenBSDには<code>acme-client</code>という便利なスクリプトが付いてきてほぼ全部自動でやってくれる。まずはこの<code>acme-client</code>の設定を変更して自分のドメインの証明書を取得するようにする。</p> 112 <pre><code>$ doas cp /etc/examples/acme-client.conf /etc/ 113 $ doas vi /etc/acme-client.conf</code></pre> 114 <pre><code># 115 # $OpenBSD: acme-client.conf,v 1.4 2020/09/17 09:13:06 florian Exp $ 116 # 117 authority letsencrypt { 118 api url "https://acme-v02.api.letsencrypt.org/directory" 119 account key "/etc/acme/letsencrypt-privkey.pem" 120 } 121 122 authority letsencrypt-staging { 123 api url "https://acme-staging-v02.api.letsencrypt.org/directory" 124 account key "/etc/acme/letsencrypt-staging-privkey.pem" 125 } 126 127 authority buypass { 128 api url "https://api.buypass.com/acme/directory" 129 account key "/etc/acme/buypass-privkey.pem" 130 contact "mailto:<i><your_mail_address></i>" 131 } 132 133 authority buypass-test { 134 api url "https://api.test4.buypass.no/acme/directory" 135 account key "/etc/acme/buypass-test-privkey.pem" 136 contact "mailto:<i><your_mail_address></i>" 137 } 138 139 domain <i><server_domain></i> { 140 alternative names { secure.<i><server_domain></i> } 141 domain key "/etc/ssl/private/<i><server_domain></i>.key" 142 domain full chain certificate "/etc/ssl/<i><server_domain></i>.fullchain.pem" 143 sign with letsencrypt 144 }</code></pre> 145 <p>変更箇所は<code>contact</code>の部分のメールアドレスと、<code>domain</code>の部分のドメイン名。</p> 146 <p>続いて<code>acme-client</code>を実行して証明書を発行する。</p> 147 <pre><code>$ doas acme-client -v <i><server_domain></i></code></pre> 148 <p>次に<code>cron</code>を用いて証明書の自動更新を行うようにする。</p> 149 <pre><code>$ doas crontab -e</code></pre> 150 <pre><code>... 151 #minute hour mday month wday [flags] command 152 19 2 * * * acme-client -v <i><server_domain></i> && rcctl reload httpd 153 ... 154 </code></pre> 155 <p>ここで設定した時間は適当。サーバーが暇そうな時間にする。僕のサーバーはいつも暇。</p> 156 157 <h2>ホームページのファイルのアップロード</h2> 158 <p>ウェブページに表示させたい内容のファイルをサーバーにアップロードする。試すだけであれば適当なファイルでいい。場所は今回の設定では<code>/var/www/htdocs/www.<i><server_domain></i>/</code>以下。ただし<code>httpd.conf</code>で<code>chroot</code>や、<code>server</code>ディレクティブの<code>location</code>ディレクティブの<code>root</code>の値を変更していれば、<code><i><chroot></i>/<i><root></i>/</code>にアップロードする。ここではテストのために適当なものを置いておく。</p> 159 <pre><code>$ doas mkdir /var/www/htdocs/www.<i><server_domain></i> 160 $ echo '<h1>unko</h1>' | doas tee /var/www/htdocs/pub/index.html</code></pre> 161 162 <h2>接続の確認</h2> 163 <p>最後に<code>httpd</code>を起動して接続を確認する。まずは<code>rc.conf.local</code>に<code>httpd</code>の起動を許可するように記入。</p> 164 <pre><code>$ echo 'httpd_flags=' | doas tee -a /etc/rc.conf/local</code></pre> 165 <p>続いてrcに登録、起動。</p> 166 <pre><code>$ doas rcctl start httpd 167 $ doas rcctl enable httpd</code></pre> 168 <p>ブラウザでアクセスしてみる。</p> 169 170 <h2>おわりに</h2> 171 <p>とりあえず残したかったので書いてみたが、冒頭でも言った通り知識が曖昧であることに気づかされた。文章もいまいち分かりにくい箇所が多いがとりあえずこのまま置いておく。日記の記事ではないので気が向いたときに少しずつ改訂できればいいかな。</p> 172 173 <h2>参考文献</h2> 174 <ul> 175 <li><a href="https://man.openbsd.org/httpd">httpd(8)</a>.Openbsd manual pages.2022-06-27閲覧</li> 176 <li><a href="https://man.openbsd.org/httpd.conf">httpd.conf(5)</a>.Openbsd manual pages.2022-06-27閲覧</li> 177 <li><a href="https://man.openbsd.org/acme-client">acme-crient(1)</a>.Openbsd manual pages.2022-06-27閲覧</li> 178 <li><a href="https://man.openbsd.org/acme-client.conf">acme-crient.conf(5)</a>.Openbsd manual pages.2022-06-27閲覧</li> 179 <li><a href="https://man.openbsd.org/crontab">crontab(1)</a>.Openbsd manual pages.2022-06-27閲覧</li> 180 <li><a href="https://letsencrypt.org/">Let's Encrypt</a>.Let's Encrypt.2022-06-27閲覧</li> 181 <li><a href="https://ja.wikipedia.org/wiki/Time_to_live#DNS%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AETime_to_live">Time to live</a>.Wikipedia.2022-06-27閲覧</li> 182 </ul> 183 </article> 184 185 </main> 186 <footer> 187 <address>info(at)mtkn(dot)jp</address> 188 <a href="http://creativecommons.org/publicdomain/zero/1.0?ref=chooser-v1" rel="license noopener noreferrer">CC0 1.0</a> 189 </footer> 190 </body> 191 </html>