環境変数 (HTTP サーバー) ​

サーバーの全設定は環境変数で行えます。Docker / Kubernetes / CI / systemd で扱いやすい形式です。CLI 固有の注意点がある変数 （CHROMIUM_PATH の自動インストール絡みなど）はサーバーでも 読むため重複掲載しています。CLI 側の詳細は CLI → 環境変数 を参照してください。

設定方法 ​

シェル ​

export PORT=8080
export CONCURRENCY=4
export API_KEY=s3cret
chartjs2img serve

Docker ​

docker run -p 8080:8080 \
  -e PORT=8080 \
  -e API_KEY=s3cret \
  -e CONCURRENCY=4 \
  chartjs2img

docker-compose ​

services:
  chartjs2img:
    build: .
    ports:
      - "3000:3000"
    environment:
      API_KEY: s3cret
      CONCURRENCY: 8
      CACHE_MAX_ENTRIES: 2000
      CACHE_TTL_SECONDS: 7200
      MAX_RENDER_TIME_SECONDS: 45

systemd ​

[Service]
Environment=PORT=3000
Environment=API_KEY=s3cret
Environment=CONCURRENCY=8
ExecStart=/usr/local/bin/chartjs2img serve

チューニング指針 ​

CONCURRENCY ​

使える CPU コアに合わせます。1 レンダリングにつき 1 ブラウザタブ ＋ 50-150 MB のメモリを使います。上げすぎると OOM やページ タイムアウトが出て、下げすぎるとクライアントがキューで待ちます。

目安:

• 2 コア → CONCURRENCY=2
• 8 コア → CONCURRENCY=6（I/O と OS の余裕を残す）
• 32 コア → CONCURRENCY=16（CPU より先にメモリが律速）

GET /health の renderer.concurrency.pending を観察して、上限を 上げるか水平スケールするかを判断します。

CACHE_MAX_ENTRIES / CACHE_TTL_SECONDS ​

同一リクエストは激安、多様なリクエストは効きにくい。 X-Cache-Hit: true/false を観察して判断。

• ~50 個のチャートを 1 日に何度も表示するダッシュボード → キャッシュ 大きめ、TTL 長め。
• アドホックな one-off → キャッシュ小さめ、TTL 短め。
• ステートレス水平スケールアウト → CACHE_MAX_ENTRIES=0 にして CDN 側でキャッシュ（キャッシュ 参照）。

MAX_RENDER_TIME_SECONDS ​

本当に遅いレンダリング（巨大データ、CDN コールドスタート）がある ときのみ上げてください。止まったチャートを早期失敗させたいなら 下げます。

PAGE_TIMEOUT_SECONDS ​

セーフティネットは、render の finally が何らかの理由で走らなかった 場合にのみ発火します。導出デフォルトを上書きする必要はまずありま せん。サーバーログに Safety net fired after Xms が出ていて実際は ハングしていないなら、レンダラーのバグなので issue を立ててください。

関連 ​

• CLI → 環境変数 — ワンショット render と重複 する変数の CLI 側の注意点。
• 認証 — API_KEY の使い方。
• キャッシュ — CACHE_MAX_ENTRIES と CACHE_TTL_SECONDS の挙動。