Cài đặt

Làm cho danh mục nhiếp ảnh Galleria của bạn hoạt động chỉ trong vài phút với Docker hoặc chế độ phát triển.

Yêu cầu tiên quyết

Trước khi bạn bắt đầu, hãy đảm bảo bạn có một trong những điều sau:

  • Đối với triển khai Docker (Được khuyến nghị): Docker & Docker Compose
  • Đối với phát triển: Node.js 18+ và npm
  • Tùy chọn: Thông tin xác thực Google OAuth (xác thực bằng mật khẩu vẫn hoạt động mà không cần nó)

Khởi động nhanh với Docker Hub

Cách nhanh nhất để bắt đầu là sử dụng các hình ảnh Docker đã được xây dựng sẵn của chúng tôi.

1. Kéo hình ảnh Docker

# Pull latest production image
docker pull tedcharles/galleria:latest

Docker Hub: hub.docker.com/r/tedcharles/galleria

2. Tạo thư mục dữ liệu

Tạo một thư mục để lưu trữ ảnh và cơ sở dữ liệu của bạn:

mkdir -p ~/galleria-data

3. Chạy Container

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

4. Truy cập trang web của bạn

Mở trình duyệt của bạn và điều hướng đến:

Giao diện người dùng:http://localhost:3000
Bảng điều khiển quản trị:http://localhost:3000/admin

Trình hướng dẫn thiết lập sẽ hướng dẫn bạn qua cấu hình ban đầu khi lần đầu truy cập.

Cài đặt phát triển

Để phát triển hoặc đóng góp cho Galleria:

1. Sao chép kho lưu trữ

git clone https://github.com/theodorecharles/Galleria.git
cd Galleria

2. Cài đặt các phụ thuộc

npm install
cd backend && npm install
cd ../frontend && npm install
cd ..

3. Bắt đầu máy chủ phát triển

npm run dev

Điều này khởi động cả frontend và backend ở chế độ phát triển với tải lại nóng.

Cài đặt Docker Compose

Để xây dựng và chạy từ mã nguồn với Docker Compose:

git clone https://github.com/theodorecharles/Galleria.git
cd Galleria
mkdir -p ~/galleria-data
docker-compose up -d --build

Chỉnh sửa docker-compose.yml để tùy chỉnh cổng và biến môi trường.

Cấu hình

Cấu hình được quản lý thông qua các biến môi trường hoặc bảng điều khiển quản trị.

Biến môi trường

BiếnMô tảVí dụ
DATA_DIRThư mục cho ảnh và cơ sở dữ liệu/data
FRONTEND_DOMAINURL công khai của trang web của bạnhttps://yourdomain.com
BACKEND_DOMAINURL điểm cuối APIhttps://api.yourdomain.com

Cấu hình Bảng điều khiển Quản trị: Sau khi thiết lập ban đầu, tất cả các cài đặt có thể được quản lý thông qua bảng điều khiển quản trị tại /admin → Cài đặt

Các bước tiếp theo

Bây giờ bạn đã cài đặt Galleria: