スタンドアロンデプロイメント

スタンドアロンデプロイメントは GPT-Load の最もシンプルなデプロイメント方法で、個人ユーザーや小規模チームがすぐに始められます。軽量なクイックスタートから完全機能のオプションデプロイメントまでサポートします。

クイックスタート

軽量デプロイメント

SQLiteデータベースとメモリストレージを使用し、個人使用やクイック体験に最適

システム要件

  • Docker 20.10+ と Docker Compose
  • Linux/macOS/Windows オペレーティングシステム
  • 最低128MBメモリと1GBディスク容量

インストール手順

🚨

重要なセキュリティ警告

デプロイメント前にデフォルトの管理キーを変更する必要があります。そうしないと深刻なセキュリティリスクがあります!

セキュリティキー要件:

  • 最低20文字
  • 大文字、小文字、数字、特殊記号を含む
  • 辞書の単語や個人情報の使用を避ける
  • 推奨形式:sk-prod-[32文字のランダム文字列]

⚠️ 弱いキーを使用すると、悪意のあるシステムアクセスにつながり、データ漏洩やサービス悪用を引き起こす可能性があります!

1

作業ディレクトリの作成

# ディレクトリを作成して移動
mkdir -p gpt-load && cd gpt-load
2

セキュリティパラメータのダウンロードと設定

# Docker Compose設定をダウンロード
wget https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/docker-compose.yml

# 環境変数設定をダウンロード
wget -O .env https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/.env.example
⚠️
必須実行:管理キーの変更

すぐに編集 .env ファイルで、次を変更:

AUTH_KEY=sk-123456

安全なキーに置き換える:

AUTH_KEY=sk-prod-AbCdEfGh123456$#@!XyZabc789012
注意:独自のランダムキーを生成してください。上記のサンプルキーは使用しないでください!
3

サービスの開始

# GPT-Loadサービスを開始
docker compose up -d
4

デプロイメントの検証

管理インターフェースにアクセス:

http://localhost:3001
🔐

カスタム管理キーでログイン

つまり、 .env ファイルに設定されたAUTH_KEY の値

💡

セキュリティのヒント:管理キーを安全に保管し、ログ、ドキュメント、またはコードに平文で保存しないでください。

一般的なコマンド

ステータス確認

docker compose ps

ログ表示

docker compose logs -f

サービス再起動

docker compose down && docker compose up -d

バージョン更新

docker compose pull && docker compose down && docker compose up -d

オプションデプロイメント

パフォーマンス向上

MySQL/PostgreSQLデータベースとRedisキャッシュを設定してシステムパフォーマンスと信頼性を向上

データベース設定

MySQL設定

1. docker-compose.yml を編集し、MySQLサービスのコメントアウトを解除:

depends_on: mysql: condition: service_healthy restart: true mysql: image: mysql:8.2 container_name: gpt-load-mysql restart: always environment: MYSQL_ROOT_PASSWORD: 123456 MYSQL_DATABASE: gpt-load volumes: - ./data/mysql:/var/lib/mysql healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 5s retries: 10

2. .env ファイルでデータベース接続を設定:

DATABASE_DSN=root:123456@tcp(mysql:3306)/gpt-load?charset=utf8mb4&parseTime=True&loc=Local

PostgreSQL設定

1. docker-compose.yml を編集し、PostgreSQLサービスのコメントアウトを解除:

depends_on: postgres: condition: service_healthy restart: true postgres: image: "postgres:16" container_name: gpt-load-postgres environment: POSTGRES_USER: postgres POSTGRES_PASSWORD: 123456 POSTGRES_DB: gpt-load volumes: - ./data/postgres:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres -d "] interval: 5s timeout: 5s retries: 10

2. .env ファイルでデータベース接続を設定:

DATABASE_DSN=postgres://postgres:123456@postgres:5432/gpt-load?sslmode=disable

Redis設定

1. 編集docker-compose.yml、Redisサービスのコメントアウトを解除:

depends_on: redis: condition: service_healthy restart: true redis: image: redis:latest container_name: gpt-load-redis restart: always healthcheck: test: ["CMD", "redis-cli", "ping"] interval: 5s timeout: 3s retries: 3

2. .env ファイルでRedis接続を設定:

REDIS_DSN=redis://redis:6379/0

サービスの再起動

設定完了後、すべてのサービスを再起動:

# サービス停止
docker compose down

# サービス再起動
docker compose up -d

トラブルシューティング

よくある問題

管理インターフェースにログインできない

正しい管理キーを使用しているか確認してください:

  • .envファイルのAUTH_KEYが変更されていることを確認
  • サービス再起動後に新しいキーが有効になります:docker compose restart
  • キーは大文字小文字を区別します、正確な入力を確認してください

ポート競合

ポート3001が使用されている場合、.envファイルで変更できます:

PORT=3002

データベース接続失敗

データベースサービスが正常に動作しているか確認:

docker compose logs mysql

メモリ不足

システムに十分なメモリリソースがあることを確認してください。データベースサービスを有効にした後、最低1GBの利用可能メモリを推奨

次のステップ

デプロイメント完了後、以下ができます:

  • プロキシキーの設定とAIサービスグループの管理
  • AIサービスプロバイダのAPIキーの追加と管理
  • システム設定とパフォーマンスパラメータの調整
  • APIプロキシサービスの使用開始