pretalx-docker 中文技术文档

镜像概述和主要用途

pretalx-docker 是一个基于 Docker 的 pretalx 部署方案，包含 docker-compose 配置文件及 Ansible 角色，用于简化 pretalx 会议管理系统的部署流程。pretalx 是一款开源会议管理软件，支持会议议程规划、演讲者管理、参会者注册等功能。

注意：本仓库由 pretalx 社区提供，非 pretalx ***团队支持。

核心功能和特性

• 多部署方式支持：提供 docker-compose 快速部署和 Ansible 自动化部署两种方案
• 环境隔离：基于 Docker 容器化部署，确保应用环境一致性
• 灵活的环境适配：同时支持测试环境快速搭建和生产环境稳定运行
• 数据持久化：通过 Docker Volumes 或自定义目录实现数据持久化存储
• 反向代理集成：支持 Traefik（推荐）和 Nginx 等反向代理，便捷配置 TLS 加密
• 自动化初始化：提供一键式用户及组织初始化命令

使用场景和适用范围

• 测试环境：快速搭建 pretalx 进行功能验证或演示
• 生产环境：为会议组织者提供稳定、可扩展的 pretalx 部署方案
• 自动化运维场景：通过 Ansible 角色实现大规模或多环境的标准化部署
• 需要 TLS 加密的场景：需通过反向代理（如 Traefik）处理 HTTPS 流量的生产环境

详细使用方法和配置说明

前置要求

• Docker Engine (20.10+ 推荐)
• docker-compose (v2+ 推荐)
• Ansible (2.10+，如使用 Ansible 部署方式)
• 网络环境：确保服务器可访问互联网（用于拉取镜像和依赖）

使用 docker-compose 部署

测试环境部署

1. 启动容器集群：

   bash
   docker-compose up -d
   

2. 等待几分钟，服务将在 http://localhost/orga 可访问

3. 初始化管理员用户及组织：

   bash
   docker exec -ti pretalx pretalx init
   

生产环境部署

1. 配置文件修改

• 编辑 conf/pretalx.conf，根据 pretalx 配置文档 填写自定义参数
• 编辑 docker-compose.yml：
  • 移除 ports: - "80:80" 配置段（若使用 Traefik 反向代理）
  • 或修改为 ports: - "127.0.0.1:8355:80"（若使用 Nginx 反向代理）
  • 必须修改 environment 中的数据库密码（POSTGRES_PASSWORD）

2. 数据持久化配置

• 使用自定义目录（替代 Docker Volumes）：
  1. 创建数据持久化目录（如 /data/pretalx/redis、/data/pretalx/db、/data/pretalx/data）
  2. 设置目录权限（用户 ID 999 和组 ID 999 需有读写权限）：

     bash
     chown -R 999:999 /data/pretalx/*
     chmod -R 755 /data/pretalx/*
     

  3. 修改 docker-compose.yml 中 volumes 配置，将 pretalx-redis、pretalx-db、pretalx-data 替换为自定义目录路径

3. 反向代理配置（TLS 处理）

pretalx 容器在 pretalxdocker 网络中监听 80 端口，需通过反向代理处理 TLS 加密。

• 推荐方案：Traefik

  1. 参考 reverse-proxy-examples/docker-compose 中的示例配置，将 Traefik 服务添加到 docker-compose.yml
  2. 配置自动获取 Let's Encrypt 证书（参考 Traefik Let's Encrypt 文档）

• 备选方案：Nginx

  1. 参考 reverse-proxy-examples/nginx 中的配置示例，配置 Nginx 反向代理
  2. 设置 proxy_pass 指向容器端口（如 [***]）

4. 启动服务与初始化

1. 启动容器集群：

   bash
   docker-compose up -d
   

2. 等待服务初始化完成（约 3-5 分钟），通过 [***] 访问

3. 初始化管理员用户及组织：

   bash
   docker exec -ti pretalx pretalx init
   

使用 Ansible 部署

测试环境部署

1. 将 ansible-role 目录添加到 Ansible 角色路径（如 /etc/ansible/roles）

2. 创建 Ansible 剧本（示例）：

   yaml
   - hosts: test-server
     roles:
       - pretalx-docker
   

3. 执行部署：

   bash
   ansible-playbook -i inventory test-playbook.yml
   

4. 服务将在 http://localhost/orga 可访问，初始化用户及组织：

   bash
   docker exec -ti pretalx pretalx init
   

生产环境部署

1. 角色配置

1. 将 ansible-role 目录添加到 Ansible 角色路径

2. 编辑角色变量文件（vars/main.yml），设置必要参数：

   yaml
   pretalx_testing: false  # 必须设置为 false
   pretalx_domain: "conf.example.com"  # 生产环境域名
   pretalx_db_password: "StrongPassword123!"  # 数据库密码
   pretalx_secret_key: "your-secure-secret-key"  # 应用加密密钥
   # 其他参数参考 vars/main.yml 注释说明
   

2. 反向代理配置

推荐使用 Traefik 作为反向代理，容器已默认添加 Traefik 标签。可参考 reverse-proxy-examples/ansible/traefik 中的 Ansible 角色配置 Traefik 服务。

3. 执行部署与初始化

1. 执行 Ansible 部署：

   bash
   ansible-playbook -i inventory production-playbook.yml
   

2. 等待部署完成（约 5-10 分钟），通过配置的域名访问（如 [***]）

3. 初始化管理员用户及组织：

   bash
   docker exec -ti pretalx pretalx init
   

配置参数说明

核心配置文件

数据持久化配置

部署方案示例

docker-compose 生产环境配置示例

yaml
version: '3.8'

services:
  pretalx:
    image: pretalx/pretalx:latest
    restart: always
    depends_on:
      - db
      - redis
    environment:
      - DATABASE_URL=postgres://pretalx:StrongPassword123!@db:5432/pretalx
      - REDIS_URL=redis://redis:6379/0
      - SECRET_KEY=your-secure-secret-key
      - SITE_URL=[***]
    volumes:
      - /data/pretalx/data:/data  # 自定义数据目录
    networks:
      - pretalxdocker

  db:
    image: postgres:14-alpine
    restart: always
    environment:
      - POSTGRES_USER=pretalx
      - POSTGRES_PASSWORD=StrongPassword123!
      - POSTGRES_DB=pretalx
    volumes:
      - /data/pretalx/db:/var/lib/postgresql/data  # 自定义数据库目录
    networks:
      - pretalxdocker

  redis:
    image: redis:7-alpine
    restart: always
    volumes:
      - /data/pretalx/redis:/data  # 自定义Redis目录
    networks:
      - pretalxdocker

networks:
  pretalxdocker:

Traefik 反向代理配置示例（docker-compose 集成）

yaml
# 添加到上述 docker-compose.yml 的 services 部分
traefik:
  image: traefik:v2.9
  command:
    - "--providers.docker=true"
    - "--providers.docker.exposedbydefault=false"
    - "--entrypoints.web.address=:80"
    - "--entrypoints.websecure.address=:443"
    - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
    - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
    - "--certificatesresolvers.letsencrypt.acme.email=***"
    - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
  ports:
    - "80:80"
    - "443:443"
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock:ro
    - /data/traefik/letsencrypt:/letsencrypt
  networks:
    - pretalxdocker

# 修改 pretalx 服务，添加 Traefik 标签
pretalx:
  # ... 其他配置不变 ...
  labels:
    - "traefik.enable=true"
    - "traefik.http.routers.pretalx.rule=Host(`conf.example.com`)"
    - "traefik.http.routers.pretalx.entrypoints=websecure"
    - "traefik.http.routers.pretalx.tls.certresolver=letsencrypt"
    - "traefik.http.services.pretalx.load***.server.port=80"