インストール
Dockerまたは開発モードで数分でGalleria写真ポートフォリオを立ち上げましょう。
前提条件
始める前に、次のいずれかを用意してください:
- Dockerデプロイメント(推奨):Docker & Docker Compose
- 開発用:Node.js 18+およびnpm
- オプション:Google OAuth資格情報(パスワード認証はこれなしでも動作します)
Docker Hubを使ったクイックスタート
始める最も早い方法は、私たちの事前構築されたDockerイメージを使用することです。
1. Dockerイメージをプルする
# Pull latest production image
docker pull tedcharles/galleria:latestDocker Hub: hub.docker.com/r/tedcharles/galleria
2. データディレクトリを作成する
写真とデータベースを保存するためのディレクトリを作成します:
mkdir -p ~/galleria-data3. コンテナを実行する
docker run -d \
--name galleria \
-p 3000:3000 \
-p 3001:3001 \
-v ~/galleria-data:/data \
-e DATA_DIR=/data \
-e FRONTEND_DOMAIN=http://localhost:3000 \
-e BACKEND_DOMAIN=http://localhost:3001 \
tedcharles/galleria:latest開発セットアップ
Galleriaの開発または貢献について:
1. リポジトリをクローンする
git clone https://github.com/theodorecharles/Galleria.git
cd Galleria2. 依存関係をインストールする
npm install
cd backend && npm install
cd ../frontend && npm install
cd ..3. 開発サーバーを起動する
npm run devこれにより、フロントエンドとバックエンドが開発モードでホットリロードされます。
Docker Composeのセットアップ
Docker Composeを使用してソースからビルドおよび実行するには:
git clone https://github.com/theodorecharles/Galleria.git
cd Galleria
mkdir -p ~/galleria-data
docker-compose up -d --builddocker-compose.ymlを編集してポートと環境変数をカスタマイズします。
設定
設定は環境変数または管理パネルを通じて管理されます。
環境変数
| 変数 | 説明 | 例 |
|---|---|---|
| DATA_DIR | 写真とデータベースのディレクトリ | /data |
| FRONTEND_DOMAIN | サイトの公開URL | https://yourdomain.com |
| BACKEND_DOMAIN | APIエンドポイントURL | https://api.yourdomain.com |
管理パネルの設定:初期設定後、すべての設定は/admin → 設定の管理パネルを通じて管理できます。
次のステップ
Galleriaがインストールされたので、
- 1. /admin に移動して管理パネルにアクセスします
- 2. アルバムを作成し、写真をアップロードします
- 3. 設定でサイトをカスタマイズします(ブランディング、SEO、言語など)
- 完全なドキュメントを読む
- GitHubでソースコードを見る