helmuthb/pretalx

pretalx Docker镜像文档

镜像概述和主要用途

pretalx是一款会议规划工具，专注于为会议组织者、演讲者、评审者和参与者提供优质体验。它能够处理会议的征稿流程（通过可配置的征稿启事）、提交内容的评审与选择、日程安排与发布。活动结束后，pretalx允许演讲者接收反馈、上传幻灯片，组织者则可嵌入会议录制内容。本镜像基于pretalx核心功能，并包含针对speaker.at的定制化修改。

核心功能和特性

会议管理核心功能

• 征稿流程管理：支持可配置的征稿启事（Call for Participation），灵活定义提交要求和截止日期
• 评审与选择机制：提供提交内容的评审流程，支持多维度评分和意见收集
• 日程安排工具：可视化日程编排，支持多轨道、多日期会议安排
• 活动后内容管理：允许演讲者上传幻灯片、接收反馈，组织者嵌入会议录制内容

系统特性

• 高度可配置：可自定义外观和行为，适应不同会议需求
• 插件支持：支持开发自定义插件，扩展核心功能
• 数据持久化：支持会议数据的长期保存和管理
• 多角色支持：为组织者、演讲者、评审者和参与者提供专用界面和功能

使用场景和适用范围

pretalx适用于各类会议和活动的规划与管理，特别是：

• 学术会议、技术研讨会、行业峰会等需要管理演讲提交和评审的活动
• 多轨道、多日期的大型会议日程安排
• 需要收集演讲反馈和管理会后内容的活动
• 使用speaker.at平台的用户，可利用本镜像的定制化功能

使用方法和配置说明

基本部署

Docker Run 命令

bash
docker run -d \
  --name pretalx \
  -p 8000:8000 \
  -v pretalx_data:/data \
  pretalx/pretalx:latest

Docker Compose 配置

yaml
version: '3'
services:
  pretalx:
    image: pretalx/pretalx:latest
    ports:
      - "8000:8000"
    volumes:
      - pretalx_data:/data
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/pretalx
      - SECRET_KEY=your_secret_key
      - SITE_URL=https://your-conference.example.com
    depends_on:
      - db
      - redis

  db:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=pretalx

  redis:
    image: redis:6
    volumes:
      - redis_data:/data

volumes:
  pretalx_data:
  postgres_data:
  redis_data:

关键配置参数

环境变量

• SECRET_KEY: 应用密钥，用于数据加密，必须设置为随机安全字符串
• DATABASE_URL: 数据库连接URL，支持PostgreSQL等数据库
• SITE_URL: 会议网站的基础URL
• DEBUG: 是否开启调试模式，生产环境应设为False
• EMAIL_HOST: SMTP服务器地址，用于发送通知邮件

数据持久化

建议通过卷挂载/data目录，确保会议数据、上传文件等持久化保存。

扩展与定制

• 插件安装：可通过在/data/plugins目录挂载自定义插件实现功能扩展
• 主题定制：通过挂载自定义CSS/JS文件修改界面外观
• 配置文件：高级配置可通过挂载/data/pretalx.cfg文件实现

参考资源

• 官方文档：docs.pretalx.org
• 功能列表：pretal***/p/features
• 管理员文档：docs.pretalx.org/administrator
• GitHub仓库：https://github.com/pretalx/pretalx