環境変数

Yurucommuの動作をカスタマイズするための環境変数一覧です。

必須環境変数

変数名	説明	例
`APP_URL`	インスタンスの公開URL（末尾スラッシュなし）	`https://yurucommu.example.com`

認証設定

認証は AUTH_PASSWORD_HASH、 ENCRYPTION_KEY、および各 OAuth プロバイダのシークレットで有効になります。

変数名	説明	備考
`AUTH_PASSWORD_HASH`	PBKDF2ハッシュ化パスワード	パスワード認証を使う場合に設定
`ENCRYPTION_KEY`	セッションやトークンの暗号化キー	64文字の16進数文字列（`openssl rand -hex 32`）
`GOOGLE_CLIENT_ID`	Google OAuthのクライアントID	公開設定可
`GOOGLE_CLIENT_SECRET`	Google OAuthのクライアントシークレット	Secretで設定
`X_CLIENT_ID`	X/Twitter OAuthのクライアントID	公開設定可
`X_CLIENT_SECRET`	X/Twitter OAuthのクライアントシークレット	Secretで設定

ローカルBunサーバー

Cloudflare を使わずにローカルで起動する場合は bun run dev:server または bun run start を使います。どちらも src/backend/server.ts を起動し、起動時に MIGRATIONS_PATH の SQL を自動適用します。

変数名	説明	デフォルト
`PORT`	サーバーポート	`3000`
`DATABASE_PATH`	SQLite データベースの保存先	`./data/yurucommu.db`
`STORAGE_PATH`	ファイルストレージの保存先	`./data/storage`
`ASSETS_PATH`	静的アセットの配置先	`./dist`
`MIGRATIONS_PATH`	SQL マイグレーションの配置先	`./migrations`
`APP_URL`	アプリケーションの公開URL	`http://localhost:3000`

Takos連携（オプション）

外部認証システム「Takos」と連携する場合の設定：

変数名	説明
`TAKOS_URL`	TakosサーバーのURL
`TAKOS_CLIENT_ID`	OAuthクライアントID
`TAKOS_CLIENT_SECRET`	OAuthクライアントシークレット
`ENABLE_TAKOS_PROXY`	`true` にすると `/api/takos/*` proxy を有効化
`ENABLE_TAKOS_TOOLS`	`true` にすると `/.takos/tools/:name` tool endpoint を有効化

wrangler.tomlでの設定

環境変数は wrangler.toml の [vars] セクションで設定します：

[vars]
APP_URL = "https://yurucommu.example.com"
TAKOS_URL = "https://takos.example.com"

# シークレットは bunx wrangler secret put で設定
# AUTH_PASSWORD_HASH, ENCRYPTION_KEY などはコードに含めない

シークレットの設定

パスワードなどの機密情報は bunx wrangler secret put で設定します：

# パスワードハッシュを設定
bunx wrangler secret put AUTH_PASSWORD_HASH

# 暗号化キーを設定
bunx wrangler secret put ENCRYPTION_KEY

# Takos連携用シークレット
bunx wrangler secret put TAKOS_CLIENT_SECRET

設定の補足

環境ごとに値を切り替える場合でも、AUTH_PASSWORD_HASH や ENCRYPTION_KEY などの認証情報は secret で管理します。

設定の確認

現在の設定を確認するには：

# wrangler.tomlの内容を確認
cat wrangler.toml

# シークレットの一覧（値は表示されない）
bunx wrangler secret list