Инсталация
Създайте своето портфолио за фотография Galleria за минути с Docker или в режим на разработка.
Предварителни условия
Преди да започнете, уверете се, че имате едно от следните:
- За разгръщане с 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:latest4. Достъп до вашия сайт
Отворете браузъра си и отидете на:
Магьосникът за настройка ще ви води през началната конфигурация при първото посещение.
Настройка за разработка
За разработка или участие в 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 --buildРедактирайте docker-compose.yml, за да персонализирате портовете и променливите на средата.
Конфигурация
Конфигурацията се управлява чрез променливи на средата или административния панел.
Променливи на средата
| Променлива | Описание | Пример |
|---|---|---|
| DATA_DIR | Директория за снимки и база данни | /data |
| FRONTEND_DOMAIN | Публичен URL на вашия сайт | https://yourdomain.com |
| BACKEND_DOMAIN | URL на API крайна точка | https://api.yourdomain.com |
Конфигурация на административния панел: След първоначалната настройка, всички настройки могат да се управляват чрез административния панел на /admin → Настройки
Следващи стъпки
Сега, след като имате инсталиран Galleria:
- 1. Отидете на /admin, за да получите достъп до администраторския панел
- 2. Създайте албуми и качете вашите снимки
- 3. Персонализирайте сайта си в Настройки (бранд, SEO, език и др.)
- Прочетете пълната документация
- Вижте изходния код в GitHub