セルフホスト PostgreSQL に Hyperdrive する

すばる / su8ru

2026-06-03 | Cloudflare Workers Tech Talks in Hokkaido #2 - #workers_tech

https://s.su8.run/260603-workers

自己紹介

すばる / su8ru

• 北海道大学工学部情エレ 4 年
• サークル：HUIT ex-部長 / Hupass
• Twitter：@su8ru_n , GitHub: @su8ru
• すきなもの：ヰ世界情緒
• 最近のニュース：就職先が決まりました

北大生による、北大生のための時間割アプリ

―― バックエンドを Django から Hono へ移行中

ことのはじまり

• 既存のインフラ (VPS) を踏まえて、@hono/node-server 前提で開発していた
• せっかく Hono なので、バックエンドも Workers にデプロイしたい

Hupass の次世代バックエンドを Hono の Node Adapter 使って書いてたけど、原理的には Workers デプロイできるよな……と思っていろいろやったらできて感動
Cloudflare Hyperdrive すげ〜〜〜〜（？）

— すばる ❄ (@su8ru_n) April 24, 2026

技術選定

Hupass ではユーザーの時間割をデータベースに保存しているので、RDB がほしい

-> どこに置く？

• Cloudflare D1 (SQLite based)
• Supabase, Neon, etc. (PostgreSQL based)
  • Hyperdrive との組み合わせでよく見る
• セルフホスト PostgreSQL
  • 現状に最も近い

技術選定（つづき）

シラバス検索という要件

1. 膨大なシラバスデータを一度に同期する場面がある
   データと DB を近くに置けるとうれしい（現状 50MB 程度なので考えすぎ？）
2. SQL レベルでのスコアリングによる複雑な検索を導入したい
   例えば pg_search は Neon でも使えるが、日本語全文検索とかを考えると……

-> セルフホスト PostgreSQL が最も無難で潰しが効く

セルフホスト Postgres を Workers から叩くには

1. TLS による暗号化 (required)
2. Cloudflare Hyperdrive によるキャッシュ (optional)
3. Cloudflare Tunnel による経路の安全化 (optional; まだできてない)

1. TLS による暗号化

• Postgres で TLS を有効 (ssl=on) にするには、サーバー証明書と秘密鍵が必要
• HTTPS であれば Caddy 等の便利サーバーソフトウェアがあるが……

-> 古典的に certbot で証明書を発行する

Tunnel 張るなら TLS なしでもいいかな……と思ったけど、Hyperdrive で必須だった

certbot/dns-cloudflare:latest を compose.yaml に用意してあげたうえで発行

docker compose run --rm certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /run/secrets/cloudflare.ini \
  --dns-cloudflare-propagation-seconds 60 \
  --cert-name hupass-postgres \
  --email admin@example.com \
  --agree-tos \
  --no-eff-email \
  -d db.example.com

docker compose run --rm --entrypoint sh certbot -c '
set -eu

CERT=/etc/letsencrypt/live/hupass-postgres

install -m 0644 \
  "$CERT/fullchain.pem" \
  /out/postgres-certs/server.crt

install -m 0600 \
  "$CERT/privkey.pem" \
  /out/postgres-certs/server.key

chown 999:999 \
  /out/postgres-certs/server.crt \
  /out/postgres-certs/server.key
'

満を持して

2. Cloudflare Hyperdrive

Why Cloudflare Hyperdrive?

• Hyperdrive がなくても、Workers から Postgres に接続はできる
• いまのままだと、Workers が立ち上がるたびに接続が走ってしまう

-> Hyperdrive を通すと、接続を維持してくれる！

さらにクエリの結果をキャッシュしてくれたりもするらしい（うれしい）

pnpm dlx wrangler hyperdrive create pirka-echalote-direct \
--connection-string="postgres://hupass:secret@198.51.100.1:65536/hupass"

  "hyperdrive": [
    {
      "binding": "HYPERDRIVE",
      "id": "<hyperdrive-no-id>",
      "localConnectionString": "postgresql://hupass:secret@localhost:5432/hupass"
    },
  ],

今後の展望

3. Cloudflare Tunnel

Why Cloudflare Tunnel?

• ここまでだと、Hyperdrive <-> Origin 間は public internet
  • さっき create hyperdrive するときに渡した IP も生 IP
• Cloudflare Access および Tunnel と組み合わせることができる

まとめ

• セルフホスト PostgreSQL にも Hyperdrive できる
  • ただし TLS 周りの設定が大変なので覚悟は必要
  • もしかして GCP とかだと備え付けだったりしますか…？
• Cloudflare Hyperdrive を使うと Origin DB との接続を維持できる
• そういえば：Hono で開発することで気軽にデプロイ先を変えられてすごい

宣伝

Hupass のスポンサーを募集中です！でも私は卒業してしまう……