設定(環境変数)
ここからは開発者・運用者向けです。typress は設定ファイルを持たず、すべて環境変数で受け取ります。インストーラーを使った場合は /etc/typress/typress.env に書かれていて、systemd が読み込みます。
主な環境変数
TYPRESS_MASTER_KEY: 32 バイトの鍵(base64url)。2 段階認証のシークレットや AI の API キーなどの暗号化に使います。本番(NODE_ENV=production)では必須です。無くすと暗号化したものが読めなくなるので、データとは別の場所に控えてください。TYPRESS_PUBLIC_ORIGIN: 公開 URL(例:https://blog.example.com)。CSRF 対策、Cookie、RSS やサイトマップの絶対 URL に使います。既定はhttp://localhost:ポート。TYPRESS_DATA_DIR: データベースやメディアを置くフォルダ。既定は./data。TYPRESS_PORT: 待ち受けるポート。既定は 4321。NODE_ENV:productionで本番モード(Cookie の Secure、HSTS など)。TYPRESS_PLUGIN_SANDBOX: プラグインの閉じ込め。auto(既定、使えれば使う)、required(使えなければプラグインを起動しない)、off。
その他
TYPRESS_ADMIN_ORIGIN: 管理画面を別ドメインにする場合。既定は公開 URL と同じ。TYPRESS_COOKIE_DOMAIN: Cookie のドメイン。TYPRESS_MAX_UPLOAD_BYTES: アップロードの上限。既定は 5 GiB、0 で無制限。TYPRESS_SUDO_WINDOW_MS/TYPRESS_SUDO_MAX_MS: 本人確認が続く時間(既定 20 分)と上限(既定 1 時間)。TYPRESS_TRUSTED_PROXY_HOPS: 前段のプロキシの段数(0〜8、既定 0)。レート制限で使う送信元 IP の判定に使います。TYPRESS_UPDATE_KEYS:typress admin self-updateで信頼する公開鍵(カンマ区切り)。
設定ファイルの例
# /etc/typress/typress.env (root:typress 0640)
TYPRESS_MASTER_KEY=<openssl rand 32 | base64 | tr '+/' '-_' | tr -d '=' の出力>
TYPRESS_DATA_DIR=/var/lib/typress
TYPRESS_PORT=4321
TYPRESS_PUBLIC_ORIGIN=https://blog.example.com
NODE_ENV=production
TYPRESS_PLUGIN_SANDBOX=required