Files
maestro/.env.caddy.example
T
oss-sync 57702b4f34
CI / build-and-test (push) Canceled after 0s
sync: update from private repo (2336949a)
2026-09-17 11:29:31 +00:00

64 lines
3.9 KiB
Bash

# ---------------------------------------------------------------------------
# Caddy リバースプロキシ用の設定
#
# cp .env.caddy.example .env.caddy
#
# 読み込むのは docker-compose.caddy.yml の caddy サービスだけ。
# ベースの .env とは意図的に分けてある — .env は maestro サービスの env_file
# なので、Cloudflare のトークンをそちらに書くとエージェントが動くコンテナの
# 環境変数に入り、Bash ツールから読めてしまう。
#
# このファイル (.env.caddy) は .gitignore 済み。実際の値をコミットしないこと。
#
# 【重要】使わないキーは「行ごとコメントアウトしたまま」にすること。
# NG: GATEWAY_HOSTNAME= ← 等号だけの空行。空文字が設定された扱いになる
# OK: # GATEWAY_HOSTNAME=... ← 未設定。Caddyfile 側の既定値が効く
# Caddyfile の既定値つき置換 ({$NAME:既定値}) は「未設定のとき」だけ既定値に
# 落ちる。空文字を入れると空文字がそのまま入り、起動しない (GATEWAY_HOSTNAME)
# か、黙って別の動きになる (GATEWAY_UPSTREAM_PORT は 80 番へ中継)。
# ---------------------------------------------------------------------------
# --- Cloudflare -------------------------------------------------------------
# API トークン。ダッシュボードの My Profile → API Tokens → Create Token から
# 「Custom token」で作る。権限は次の 2 つだけに絞ること:
# Zone / Zone : Read
# Zone / DNS : Edit
# Zone Resources は対象のゾーン 1 つだけを選ぶ (All zones にしない)。
# Global API Key は使わない (アカウント全体の権限を持つため)。
#
# これは必須のキーなので空の行のまま置いてある (上の「コメントアウトのまま」は
# 使わないキーの話)。空のまま起動すると
# `API token '' appears invalid` で止まるので、黙って進むことはない。
CLOUDFLARE_API_TOKEN=
# --- ホスト名 ---------------------------------------------------------------
# 下の 2 つは自分のドメインに必ず書き換えること (CHANGE-ME.example のままだと
# 存在しない名前で証明書を要求し続ける)。
#
# ワイルドカード証明書の対象。*.<この値> の証明書を 1 枚取る。
# 先頭のドットやアスタリスクは付けない。空文字にすると *. という成立しない
# 名前で発行を要求し続ける (Caddy は警告を出さない)。
# 例: MAESTRO_BASE_DOMAIN=example.com → *.example.com
# MAESTRO_BASE_DOMAIN=home.example.com → *.home.example.com
MAESTRO_BASE_DOMAIN=CHANGE-ME.example
# MAESTRO を出すホスト名。MAESTRO_BASE_DOMAIN の 1 つ下の階層にすること。
MAESTRO_HOSTNAME=maestro.CHANGE-ME.example
# --- AAO ゲートウェイ (使っていないなら、下の 2 行はコメントアウトのまま) ---
# ゲートウェイ (OpenAI 互換の中継口) も HTTPS で出す場合だけ、# を外して書く。
# コメントアウトしたままなら、この経路は無効のまま起動する。
#
# 【注意】`GATEWAY_HOSTNAME=` と等号だけ書くと Caddy が起動しない
# (module value cannot be null)。使わないなら # を外さないこと。
# MAESTRO_BASE_DOMAIN の 1 つ下の階層にすること。別ドメインや 2 階層下だと
# 証明書もサイトの照合も覆わず、そのホスト名は無反応になる (警告は出ない)。
# GATEWAY_HOSTNAME=gateway.CHANGE-ME.example
# ゲートウェイの待ち受けポート。config.yaml の gateway.listen_port を既定
# (4000) から変えている場合だけ、# を外して同じ値を書く。
#
# 【注意】`GATEWAY_UPSTREAM_PORT=` と等号だけ書くと、エラーも警告も出ないまま
# 80 番へ中継され、502 になる。既定のままなら # を外さないこと。
# GATEWAY_UPSTREAM_PORT=4000