手動デプロイ
インストーラーがやっていることを、手で行う手順です。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/typress2. 設定ファイル
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 typressunit ファイルには細かいハードニングが入っています。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 でメモリを使い果たす既知の問題があります。ソースからビルドも参照。