pretix Docker镜像文档

镜像概述和主要用途

pretix 是一个开源的票务销售应用程序，专注于为各类活动提供票务预售和管理解决方案。其核心定位是"重新定义票务预售，每张票都精益求精"，已稳定应用于数千场活动（包括会议、节日、音乐会等），累计销售数百万张门票。该项目成熟稳定，适合自托管部署，提供完整的票务管理功能，满足不同规模活动的票务需求。

核心功能和特性

• 稳定可靠：经过大规模活动验证，确保票务销售过程中的稳定性和数据安全性。
• 多活动类型支持：适用于会议、节日、音乐会、科技活动、演出、研讨会等多种场景。
• 自托管能力：支持在私有服务器上部署，完全掌控数据和服务配置。
• 开源免费：100% 自由开源软件，可免费使用，同时提供商业支持选项。
• 多语言支持：提供多语言界面，支持国际化活动需求。
• 灵活扩展：通过 API 和插件系统支持功能扩展，满足定制化需求。

使用场景和适用范围

pretix 适用于各类需要票务管理的活动场景，包括但不限于：

• 学术会议、技术研讨会
• 音乐节、艺术展览
• 音乐会、戏剧演出
• 企业活动、培训 workshops
• 体育赛事、社区活动

使用方法和配置说明

快速启动（Docker Run）

以下命令可快速启动 pretix 服务（需提前准备 PostgreSQL 数据库）：

bash
docker run -d \
  --name pretix \
  -p 8000:8000 \
  -e DATABASE_URL=postgresql://user:password@db-host:5432/pretix \
  -e SECRET_KEY=your-secure-secret-key \
  -e ADMIN_EMAIL=*** \
  -v pretix-data:/var/pretix/data \
  pretix/pretix

使用 Docker Compose

推荐使用 docker-compose 管理服务，包含 pretix 和 PostgreSQL 数据库：

yaml
version: '3'

services:
  db:
    image: postgres:14
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=pretix
      - POSTGRES_PASSWORD=secure-password
      - POSTGRES_DB=pretix
    restart: always

  pretix:
    image: pretix/pretix
    depends_on:
      - db
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://pretix:secure-password@db:5432/pretix
      - SECRET_KEY=your-secure-secret-key  # 建议使用随机生成的32位字符串
      - ADMIN_EMAIL=***
      - DEBUG=False  # 生产环境设为False
      - ALLOWED_HOSTS=your-domain.com,localhost
    volumes:
      - pretix-data:/var/pretix/data
    restart: always

volumes:
  postgres-data:
  pretix-data:

启动命令：

bash
docker-compose up -d

环境变量说明

数据持久化

pretix 需持久化存储数据（配置、媒体文件等），建议通过 Docker 卷挂载 /var/pretix/data 目录，如上述示例中的 pretix-data 卷。

支持与贡献

开源支持

pretix 是 100% 开源免费软件，社区支持可通过 GitHub 仓库的 issues 或讨论区获取。

商业支持

提供商业支持、托管服务及企业版方案，详情可访问 pretix.eu 或联系 ***。

贡献方式

如需贡献代码或翻译，可参考 开发者文档，或参与 翻译项目。

许可证信息

pretix 代码主要采用 GNU AGPL v3 许可证 及附加条款发布，完整许可证详情见项目根目录的 LICENSE 文件。

参考链接

• ***文档
• 安装指南
• 行为准则