文档

Galleria 摄影作品集的部署和管理完整指南。

入门

Galleria 是一个现代摄影作品集网站，使用 React 19、TypeScript、Express 5 和 SQLite 构建。它具有优化的图像传递、管理面板、分析跟踪和响应式设计。

快速链接

Google OAuth SSO 设置

启用 Google OAuth 单点登录，以便安全、无密码地访问您的 Galleria 管理面板。

步骤 1：创建 Google Cloud 项目

  1. 前往 Google Cloud 控制台
  2. 创建一个新项目或选择一个现有项目
  3. 导航到 APIs 和服务 → 凭据
  4. 点击创建凭据 → OAuth 客户端 ID
  5. 如果提示，请先配置 OAuth 同意屏幕

步骤 2：配置 OAuth 客户端

  1. 选择 Web 应用程序作为应用类型
  2. 将您的域添加到授权的 JavaScript 来源：
    https://yourdomain.com
  3. 将回调 URL 添加到授权的重定向 URI：
    https://yourdomain.com/api/auth/google/callback
  4. 点击创建并保存您的凭据

步骤 3：在 Galleria 设置中配置

  1. 登录到您的 Galleria 管理面板
  2. 导航到设置 → Google OAuth
  3. 输入您的 Google 客户端 ID
  4. 输入您的 Google 客户端密钥
  5. 点击保存以启用 Google OAuth SSO

自动用户转换：具有匹配电子邮件地址的现有用户将自动转换为 Google OAuth 认证。他们可以在 OAuth 配置后立即使用 Google 登录。

安全提示：仅将受信任的电子邮件地址添加为管理员用户。您可以在初始设置后从管理面板管理用户访问。

OpenObserve 分析设置

OpenObserve 为您的 Galleria 网站提供强大的日志分析和实时监控，并具有地理丰富功能。

步骤 1：使用 Docker 安装 OpenObserve

使用 Docker Compose 运行 OpenObserve：

步骤 2：创建服务账户

  1. 访问 OpenObserve，网址为 http://localhost:5080
  2. 使用您的管理员凭据登录
  3. 导航到设置 → 服务账户
  4. 点击创建服务账户
  5. 给它一个名称（例如，"galleria-analytics"）并分配适当的权限
  6. 复制生成的 API 令牌以备后用

步骤 7：配置 Galleria

  1. 登录到您的 Galleria 管理面板
  2. 导航到 设置 → 分析
  3. 输入您的 OpenObserve URL（例如：http://localhost:5080）
  4. 输入您的组织 ID
  5. 输入您的流名称（网站）
  6. 输入您的用户名（来自步骤 2）
  7. 输入您的密码（来自步骤 2 的服务账户令牌）
  8. 点击保存以启用 OpenObserve 分析

成功！您的分析现在将包括所有访客的地理增强数据，包括城市、地区、国家、ISP 和坐标。

硬件视频编码

Galleria 支持硬件加速的视频编码，使用您的 GPU 进行 5-10 倍更快的视频处理。

支持的硬件

NVIDIA GPU（NVENC）

Docker 和本地支持

Intel Quick Sync（QSV）

仅支持本地

AMD GPU（AMF）

仅原生支持

Apple VideoToolbox

仅限 macOS 原生

启用硬件编码

  1. 前往管理面板 → 设置 → 视频质量
  2. 将 "硬件转码" 切换为启用
  3. 视频处理现在将在可用时使用 GPU 加速

生产部署

使用 PM2

对于没有 Docker 的生产部署：

npm run build
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup

自动部署：推送到主分支，GitHub Actions 会自动部署您的更改。

帮助改善此文档

发现错误或想为文档做贡献？我们欢迎贡献！

在 GitHub 上贡献