let5see/huobao-drama

Fork 0

Files

jiangzj 2a38411164 feat:增加docker compose部署配置国内镜像源说明

2026-01-21 16:26:17 +08:00

18 KiB

Raw Blame History

🎬 Huobao Drama - AI ショートドラマ制作プラットフォーム

Go + Vue3 ベースのフルスタック AI ショートドラマ自動化プラットフォーム

機能 • クイックスタート • デプロイ

简体中文 | English | 日本語

📖 概要

Huobao Drama は、脚本生成、キャラクターデザイン、絵コンテ作成から動画合成までの全ワークフローを自動化する AI 駆動のショートドラマ制作プラットフォームです。

🎯 主要機能

🤖 AI 駆動: 大規模言語モデルを使用して脚本を解析し、キャラクター、シーン、絵コンテ情報を抽出
🎨 インテリジェント創作: AI によるキャラクターポートレートとシーン背景の生成
📹 動画生成: テキストから動画、画像から動画モデルによる絵コンテ動画の自動生成
🔄 完全なワークフロー: アイデアから完成動画までのエンドツーエンド制作ワークフロー

🛠️ 技術アーキテクチャ

DDD（ドメイン駆動設計） に基づく明確なレイヤー構造：

├── APIレイヤー (Gin HTTP)
├── アプリケーションサービスレイヤー (ビジネスロジック)
├── ドメインレイヤー (ドメインモデル)
└── インフラストラクチャレイヤー (データベース、外部サービス)

🎥 デモ動画

AI ショートドラマ生成を体験：

サンプル作品 1

サンプル作品 2

動画 1 を見る | 動画 2 を見る

✨ 機能

🎭 キャラクター管理

✅ AI 生成キャラクターポートレート
✅ バッチキャラクター生成
✅ キャラクター画像のアップロードと管理

🎬 絵コンテ制作

✅ 自動絵コンテスクリプト生成
✅ シーン説明とショットデザイン
✅ 絵コンテ画像生成（テキストから画像）
✅ フレームタイプ選択（先頭フレーム/キーフレーム/末尾フレーム/パネル）

🎥 動画生成

✅ 画像から動画の自動生成
✅ 動画合成と編集
✅ トランジション効果

📦 アセット管理

✅ 統合アセットライブラリ管理
✅ ローカルストレージサポート
✅ アセットのインポート/エクスポート
✅ タスク進捗トラッキング

🚀 クイックスタート

📋 前提条件

ソフトウェア	バージョン	説明
Go	1.23+	バックエンドランタイム
Node.js	18+	フロントエンドビルド環境
npm	9+	パッケージマネージャー
FFmpeg	4.0+	動画処理（必須）
SQLite	3.x	データベース（内蔵）

FFmpeg のインストール

macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

Windows: FFmpeg 公式サイトからダウンロードし、環境変数を設定

インストール確認：

ffmpeg -version

⚙️ 設定

設定ファイルをコピーして編集：

cp configs/config.example.yaml configs/config.yaml
vim configs/config.yaml

設定ファイル形式（configs/config.yaml）：

app:
  name: "Huobao Drama API"
  version: "1.0.0"
  debug: true # 開発環境ではtrue、本番環境ではfalseに設定

server:
  port: 5678
  host: "0.0.0.0"
  cors_origins:
    - "http://localhost:3012"
  read_timeout: 600
  write_timeout: 600

database:
  type: "sqlite"
  path: "./data/drama_generator.db"
  max_idle: 10
  max_open: 100

storage:
  type: "local"
  local_path: "./data/storage"
  base_url: "http://localhost:5678/static"

ai:
  default_text_provider: "openai"
  default_image_provider: "openai"
  default_video_provider: "doubao"

主要設定項目：

app.debug: デバッグモードスイッチ（開発環境では true を推奨）
server.port: サービスポート
server.cors_origins: フロントエンドの許可 CORS オリジン
database.path: SQLite データベースファイルパス
storage.local_path: ローカルファイルストレージパス
storage.base_url: 静的リソースアクセス URL
ai.default_*_provider: AI サービスプロバイダー設定（API キーは Web UI で設定）

📥 インストール

# プロジェクトをクローン
git clone https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama

# Go依存関係をインストール
go mod download

# フロントエンド依存関係をインストール
cd web
npm install
cd ..

🎯 プロジェクトの起動

方法 1: 開発モード（推奨）

フロントエンドとバックエンドを分離、ホットリロード対応

# ターミナル1: バックエンドサービスを起動
go run main.go

# ターミナル2: フロントエンド開発サーバーを起動
cd web
npm run dev

フロントエンド: http://localhost:3012
バックエンド API: http://localhost:5678/api/v1
フロントエンドは API リクエストを自動的にバックエンドにプロキシ

方法 2: シングルサービスモード

バックエンドが API とフロントエンド静的ファイルの両方を提供

# 1. フロントエンドをビルド
cd web
npm run build
cd ..

# 2. サービスを起動
go run main.go

アクセス: http://localhost:5678

🗄️ データベース初期化

データベーステーブルは初回起動時に自動作成されます（GORM AutoMigrate を使用）。手動マイグレーションは不要です。

📦 デプロイ

🐳 Docker デプロイ（推奨）

方法 1: Docker Compose（推奨）

🚀 中国国内ネットワーク高速化（オプション）

中国国内のネットワーク環境では、Docker イメージのプルや依存関係のインストールが遅い場合があります。ミラーソースを設定することでビルドプロセスを高速化できます。

ステップ 1: 環境変数ファイルを作成

cp .env.example .env

ステップ 2: .env ファイルを編集し、必要なミラーソースのコメントを解除

# Docker Hub ミラーを有効化（推奨）
DOCKER_REGISTRY=docker.1ms.run/

# npm ミラーを有効化
NPM_REGISTRY=https://registry.npmmirror.com/

# Go プロキシを有効化
GO_PROXY=https://goproxy.cn,direct

# Alpine ミラーを有効化
ALPINE_MIRROR=mirrors.aliyun.com

ステップ 3: docker compose でビルド（必須）

docker compose build

重要な注意事項:

⚠️ .env ファイルのミラーソース設定を自動的に読み込むには docker compose build を使用する必要があります

❌ docker build コマンドを使用する場合は、手動で --build-arg パラメータを渡す必要があります

✅ 常に docker compose build を使用してビルドすることを推奨

パフォーマンス比較:

操作	ミラー未設定	ミラー設定後
ベースイメージのプル	5-30 分	1-5 分
npm 依存関係インストール	失敗する可能性	高速成功
Go 依存関係ダウンロード	5-10 分	30 秒-1 分

注意: 中国国外のユーザーはミラーソースを設定せず、デフォルト設定を使用してください。

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

# ログを表示
docker-compose logs -f

# サービスを停止
docker-compose down

方法 2: Docker コマンド

注意: Linux ユーザーはホストサービスにアクセスするために --add-host=host.docker.internal:host-gateway を追加する必要があります

# Docker Hubから実行
docker run -d \
  --name huobao-drama \
  -p 5678:5678 \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  huobao/huobao-drama:latest

# ログを表示
docker logs -f huobao-drama

ローカルビルド（オプション）：

docker build -t huobao-drama:latest .
docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-drama:latest

Docker デプロイの利点：

✅ デフォルト設定ですぐに使用可能
✅ 環境の一貫性、依存関係の問題を回避
✅ ワンクリック起動、Go、Node.js、FFmpeg のインストール不要
✅ 移行とスケーリングが容易
✅ 自動ヘルスチェックと再起動
✅ ファイル権限の自動処理

🔗 ホストサービスへのアクセス（Ollama/ローカルモデル）

コンテナは http://host.docker.internal:ポート番号 を使用してホストサービスにアクセスするよう設定されています。

設定手順：

ホストでサービスを起動（全インターフェースでリッスン）
```
export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
```
フロントエンド AI サービス設定
- Base URL: http://host.docker.internal:11434/v1
- Provider: openai
- Model: qwen2.5:latest

🏭 従来のデプロイ方法

1. ビルド

# 1. フロントエンドをビルド
cd web
npm run build
cd ..

# 2. バックエンドをコンパイル
go build -o huobao-drama .

生成ファイル：

huobao-drama - バックエンド実行ファイル
web/dist/ - フロントエンド静的ファイル（バックエンドに埋め込み）

2. デプロイファイルの準備

サーバーにアップロードするファイル：

huobao-drama            # バックエンド実行ファイル
configs/config.yaml     # 設定ファイル
data/                   # データディレクトリ（オプション、初回実行時に自動作成）

3. サーバー設定

# ファイルをサーバーにアップロード
scp huobao-drama user@server:/opt/huobao-drama/
scp configs/config.yaml user@server:/opt/huobao-drama/configs/

# サーバーにSSH接続
ssh user@server

# 設定ファイルを編集
cd /opt/huobao-drama
vim configs/config.yaml
# modeをproductionに設定
# ドメインとストレージパスを設定

# データディレクトリを作成し権限を設定（重要！）
# 注意: YOUR_USERを実際にサービスを実行するユーザー名に置き換え（例: www-data、ubuntu、deploy）
sudo mkdir -p /opt/huobao-drama/data/storage
sudo chown -R YOUR_USER:YOUR_USER /opt/huobao-drama/data
sudo chmod -R 755 /opt/huobao-drama/data

# 実行権限を付与
chmod +x huobao-drama

# サービスを起動
./huobao-drama

4. systemd でサービス管理

サービスファイル /etc/systemd/system/huobao-drama.service を作成：

[Unit]
Description=Huobao Drama Service
After=network.target

[Service]
Type=simple
User=YOUR_USER
WorkingDirectory=/opt/huobao-drama
ExecStart=/opt/huobao-drama/huobao-drama
Restart=on-failure
RestartSec=10

# 環境変数（オプション）
# Environment="GIN_MODE=release"

[Install]
WantedBy=multi-user.target

サービスを起動：

sudo systemctl daemon-reload
sudo systemctl enable huobao-drama
sudo systemctl start huobao-drama
sudo systemctl status huobao-drama

⚠️ よくある問題: SQLite 書き込み権限エラー

attempt to write a readonly database エラーが発生した場合：

# 1. サービスを実行中のユーザーを確認
sudo systemctl status huobao-drama | grep "Main PID"
ps aux | grep huobao-drama

# 2. 権限を修正（YOUR_USERを実際のユーザー名に置き換え）
sudo chown -R YOUR_USER:YOUR_USER /opt/huobao-drama/data
sudo chmod -R 755 /opt/huobao-drama/data

# 3. 権限を確認
ls -la /opt/huobao-drama/data
# サービスを実行するユーザーが所有者として表示されるはず

# 4. サービスを再起動
sudo systemctl restart huobao-drama

原因：

SQLite はデータベースファイルとそのディレクトリの両方に書き込み権限が必要
ディレクトリ内に一時ファイル（例: -wal、-journal）を作成する必要がある
重要: systemd のUserがデータディレクトリの所有者と一致していることを確認

一般的なユーザー名：

Ubuntu/Debian: www-data、ubuntu
CentOS/RHEL: nginx、apache
カスタムデプロイ: deploy、app、現在ログインしているユーザー

5. Nginx リバースプロキシ

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 静的ファイルへの直接アクセス
    location /static/ {
        alias /opt/huobao-drama/data/storage/;
    }
}

🎨 技術スタック

バックエンド

言語: Go 1.23+
Web フレームワーク: Gin 1.9+
ORM: GORM
データベース: SQLite
ログ: Zap
動画処理: FFmpeg
AI サービス: OpenAI、Gemini、Doubao など

フロントエンド

フレームワーク: Vue 3.4+
言語: TypeScript 5+
ビルドツール: Vite 5
UI コンポーネント: Element Plus
CSS フレームワーク: TailwindCSS
状態管理: Pinia
ルーター: Vue Router 4

開発ツール

パッケージ管理: Go Modules、npm
コード規約: ESLint、Prettier
バージョン管理: Git

📝 よくある質問

Q: Docker コンテナからホストの Ollama にアクセスするには？

A: Base URL として http://host.docker.internal:11434/v1 を使用します。注意点：

ホストの Ollama は 0.0.0.0 でリッスンする必要があります: export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
docker run を使用する Linux ユーザーは追加が必要: --add-host=host.docker.internal:host-gateway

詳細: DOCKER_HOST_ACCESS.md

Q: FFmpeg がインストールされていない、または見つからない？

A: FFmpeg がインストールされ、PATH 環境変数に含まれていることを確認してください。ffmpeg -version で確認。

Q: フロントエンドがバックエンド API に接続できない？

A: バックエンドが実行中で、ポートが正しいか確認してください。開発モードでは、フロントエンドプロキシ設定は web/vite.config.ts にあります。

Q: データベーステーブルが作成されない？

A: GORM は初回起動時にテーブルを自動作成します。ログでマイグレーション成功を確認してください。

📋 更新履歴

v1.0.2 (2026-01-16)

🚀 主要アップデート

純粋な Go SQLite ドライバー（modernc.org/sqlite）、CGO_ENABLED=0 クロスプラットフォームコンパイルをサポート
並行性能を最適化（WAL モード）、"database is locked" エラーを解決
ホストサービスへのアクセス用 host.docker.internal の Docker クロスプラットフォームサポート
ドキュメントとデプロイガイドの簡素化

v1.0.1 (2026-01-14)

🐛 バグ修正 / 🔧 改善

動画生成 API レスポンスのパース問題を修正
OpenAI Sora 動画エンドポイント設定を追加
エラー処理とログ出力を最適化

🤝 コントリビューション

Issue と Pull Request を歓迎します！

このプロジェクトをフォーク
フィーチャーブランチを作成 (git checkout -b feature/AmazingFeature)
変更をコミット (git commit -m 'Add some AmazingFeature')
ブランチにプッシュ (git push origin feature/AmazingFeature)
Pull Request を作成

API 設定サイト

2 分で設定完了: API 集約サイト

👨‍💻 私たちについて

AI 火宝 - AI スタジオ起業中

🏠 所在地: 中国南京
🚀 ステータス: 起業中
📧 Email: 18550175439@163.com
💬 WeChat: dangbao1117 （個人 WeChat - 技術的な質問には対応しません）
🐙 GitHub: https://github.com/chatfire-AI/huobao-drama

「AI に私たちのより創造的なことを手伝ってもらおう」

コミュニティグループ

Issueを提出
プロジェクトメンテナにメール

⭐ このプロジェクトが役に立ったら、Star をお願いします！

Star 履歴

Made with ❤️ by Huobao Team

18 KiB Raw Blame History Unescape Escape