typress
An editorial workshop.EN

設定(環境変数)

ここからは開発者・運用者向けです。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