安装

使用 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:latest

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

2. 创建数据目录

创建一个目录来存储您的照片和数据库：

mkdir -p ~/galleria-data

3. 运行容器

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. 访问您的网站

打开您的浏览器并导航到：

前端：http://localhost:3000
管理面板：http://localhost:3000/admin

设置向导将在首次访问时引导您完成初始配置。

开发设置

用于开发或贡献于 Galleria：

1. 克隆仓库

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

2. 安装依赖

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您网站的公共 URLhttps://yourdomain.com
BACKEND_DOMAINAPI 端点 URLhttps://api.yourdomain.com

管理面板配置：初始设置后，所有设置可以通过 /admin → 设置 的管理面板进行管理。

后续步骤

现在您已经安装了 Galleria：