typress
An editorial workshop.EN

手動デプロイ

インストーラーがやっていることを、手で行う手順です。Debian / Ubuntu 以外や、構成を自分で決めたい場合に使ってください。リポジトリの packaging/ に、systemd の設定などの元ファイルがあります。

1. ユーザーとフォルダ

sudo useradd -r -s /usr/sbin/nologin -d /var/lib/typress typress
sudo mkdir -p /opt/typress /var/lib/typress /etc/typress
sudo chown typress:typress /var/lib/typress
sudo chmod 0700 /var/lib/typress
sudo install -m 0755 typress /opt/typress/typress

2. 設定ファイル

sudo cp packaging/typress.env.example /etc/typress/typress.env
sudoedit /etc/typress/typress.env   # master key と公開 URL を入れる
sudo chown root:typress /etc/typress/typress.env
sudo chmod 0640 /etc/typress/typress.env

各項目は 設定 を見てください。

3. 最初の管理者

公開サーバーでは、起動前に CLI で管理者を作っておくのが安全です(起動後に最初にアクセスした人が管理者を作れてしまうため)。インストーラーはこれを自動で行います。手動の場合は、外から届かない状態(nginx の設定前など)で起動して /admin から作ってください。

4. systemd

sudo cp packaging/typress.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now typress

unit ファイルには細かいハードニングが入っています。MemoryDenyWriteExecute は、Bun の JIT が動かなくなるため外してあります。

5. nginx と HTTPS

typress 自体は HTTPS を扱わないので、前に nginx(または Caddy)を置きます。

server {
    listen 443 ssl;
    http2 on;
    server_name blog.example.com;
    ssl_certificate     /etc/letsencrypt/live/typress/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/typress/privkey.pem;
    client_max_body_size 0;
    location / {
        proxy_pass http://127.0.0.1:4321;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto https;
    }
}

証明書は certbot で取ります。IP アドレスで運用する場合は Let's Encrypt の短期証明書(有効 6 日)を使い、packaging/typress-le-renew.timer で 12 時間ごとに更新します。

ビルドの注意

Linux 用のバイナリは、Linux の上でビルドしてください。macOS からのクロスコンパイルで作ったものは、Linux でメモリを使い果たす既知の問題があります。ソースからビルドも参照。