環境設定
設定特点
加載方式
- • 環境変数または .env ファイルで
- • アプリケーション起動時に一度読み込み
- • 実行時に変更不可
- • 基本設定デフォルト値を提供
適用シーン
- • サーバー基本パラメータ設定
- • データベース接続情報
- • セキュリティ認証キー
- • ログと監視設定
サーバー設定
設定項目 | 環境変数 | デフォルト値 | 説明 |
---|---|---|---|
サービスポート | PORT | 3001 | HTTP サーバーリスニングポート |
サービスアドレス | HOST | 0.0.0.0 | HTTP サーバーバインドアドレス |
読み取りタイムアウト | SERVER_READ_TIMEOUT | 60 | HTTP サーバー読み取りタイムアウト(秒) |
書き込みタイムアウト | SERVER_WRITE_TIMEOUT | 600 | HTTP サーバー書き込みタイムアウト(秒) |
アイドルタイムアウト | SERVER_IDLE_TIMEOUT | 120 | HTTP 接続アイドルタイムアウト(秒) |
グレースフルシャットダウンタイムアウト | SERVER_GRACEFUL_SHUTDOWN_TIMEOUT | 10 | サービスグレースフルシャットダウン待機時間(秒) |
スレーブノードモード | IS_SLAVE | false | クラスター展開時のスレーブノード識別子 |
タイムゾーン | TZ | Asia/Shanghai | タイムゾーンを指定 |
認証・データベース設定
設定項目 | 環境変数 | デフォルト値 | 説明 |
---|---|---|---|
管理キー | AUTH_KEY | sk-123456 | 管理端のアクセス認証キー、強固なパスワードに変更してください |
データベース接続 | DATABASE_DSN | ./data/gpt-load.db | データベース接続文字列(DSN)またはファイルパス |
Redis 接続 | REDIS_DSN | - | Redis 接続文字列、空の場合はメモリストレージを使用 |
パフォーマンス・CORS設定
設定項目 | 環境変数 | デフォルト値 | 説明 |
---|---|---|---|
最大同時リクエスト | MAX_CONCURRENT_REQUESTS | 100 | システムが許可する最大同時リクエスト数 |
CORS 有効化 | ENABLE_CORS | false | クロスオリジンリソース共有を有効にするかどうか |
許可オリジン | ALLOWED_ORIGINS | - | 許可されるオリジン、カンマ区切り |
許可メソッド | ALLOWED_METHODS | GET,POST,PUT,DELETE,OPTIONS | 許可される HTTP メソッド |
許可ヘッダー | ALLOWED_HEADERS | * | 許可されるリクエストヘッダー、カンマ区切り |
認証情報許可 | ALLOW_CREDENTIALS | false | 認証情報の送信を許可するかどうか |
ログ設定
設定項目 | 環境変数 | デフォルト値 | 説明 |
---|---|---|---|
ログレベル | LOG_LEVEL | info | ログレベル:debug, info, warn, error |
ログフォーマット | LOG_FORMAT | text | ログフォーマット:text, json |
ファイルログ有効 | LOG_ENABLE_FILE | false | ファイルログ出力を有効にするかどうか |
ログファイルパス | LOG_FILE_PATH | ./data/logs/app.log | ログファイル保存パス |
プロキシ設定
優先度説明
プロキシ設定は3層優先度をサポート:グループ設定 > システム設定 > 環境設定
環境プロキシはグローバルフォールバック設定として機能し、システム設定とグループ設定のどちらもプロキシ設定がない場合のみ有効。
GPT-Load は環境変数からプロキシ設定を自動的に読み取り、上流 AI サービスプロバイダーへのリクエストに使用します。
プロキシ設定
設定項目 | 環境変数 | デフォルト値 | 説明 |
---|---|---|---|
HTTP プロキシ | HTTP_PROXY | - | HTTP リクエスト用プロキシサーバーアドレス |
HTTPS プロキシ | HTTPS_PROXY | - | HTTPS リクエスト用プロキシサーバーアドレス |
プロキシなし | NO_PROXY | - | プロキシアクセスが不要なホストまたはドメイン、カンマ区切り |
サポートされているプロトコルフォーマット
HTTP:
http://user:pass@host:port
HTTPS:
https://user:pass@host:port
SOCKS5:
socks5://user:pass@host:port
環境設定まとめ
環境設定は GPT-Load 設定システムの基盤で、アプリケーションの実行に必要なインフラストラクチャパラメータを提供する主要な役割を担っています。
- 基本サービスパラメータ:アプリケーションの起動と実行が依存するコアサービスを定義し、サーバーポート、データベース接続など。
- 管理特性:
.env
ファイルまたはオペレーティングシステムの環境変数で設定し、アプリケーション起動時にロードし、設定の安定性と一貫性を保証。 - 使用上の利点:システムに信頼性の高いデフォルト値を提供し、同時に機密情報(データベースパスワード、APIキーなど)をコードベースから分離し、セキュリティを強化。