mozmeao/basket

basket.mozilla.org Docker镜像文档

1. 镜像概述

basket.mozilla.org Docker镜像是Mozilla官方提供的容器化部署方案，用于快速搭建和运行basket服务。该服务是Mozilla生态系统中的用户订阅管理系统，主要负责用户注册、邮件列表订阅、订阅状态跟踪及邮件分发等功能，广泛应用于Mozilla产品的用户沟通与社区运营场景。

2. 核心功能与特性

2.1 核心功能

• 用户订阅管理：支持用户注册、订阅/退订邮件列表、订阅偏好设置
• 邮件分发：集成邮件发送功能，支持批量邮件分发与模板化配置
• 订阅状态跟踪：实时记录用户订阅状态（活跃/未验证/退订）及交互日志
• API接口：提供RESTful API，支持与第三方系统（如产品官网、CRM）集成

2.2 关键特性

• 轻量级部署：基于容器化架构，简化依赖管理与环境配置
• 可扩展性：支持水平扩展，适配不同规模的用户订阅量
• 数据持久化：支持外部数据卷挂载，确保订阅数据与日志持久化存储
• 安全合规：遵循Mozilla数据安全标准，支持数据加密与访问控制

3. 使用场景与适用范围

3.1 典型使用场景

• Mozilla产品（如Firefox、Thunderbird）的用户邮件订阅管理
• 开源项目社区的公告邮件列表服务
• 开发者文档更新通知、安全漏洞通报等场景
• 社区活动报名与参与状态跟踪

3.2 适用范围

• 技术团队：快速部署测试/生产环境的订阅管理系统
• 社区运营：构建用户沟通渠道，实现精准消息触达
• 开发者：通过API集成自定义订阅功能到第三方应用

4. 使用方法与配置说明

4.1 环境要求

• Docker Engine 20.10+
• Docker Compose 2.0+（如需多容器部署）
• 至少1GB内存，20GB磁盘空间

4.2 快速启动（docker run）

bash
docker run -d \
  --name basket \
  -p 8000:8000 \
  -v /path/to/data:/app/data \
  -e DATABASE_URL=postgresql://user:password@db:5432/basket \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=user@example.com \
  -e SMTP_PASSWORD=smtp_password \
  docker.xuanyuan.run/mozilla/basket:latest

参数说明：

• -p 8000:8000：映射容器内8000端口到主机（默认HTTP服务端口）
• -v /path/to/data:/app/data：挂载数据卷，持久化订阅数据、日志及配置文件
• 环境变量（必填）：
  • DATABASE_URL：数据库连接地址（支持PostgreSQL）
  • SMTP_HOST/SMTP_PORT/SMTP_USER/SMTP_PASSWORD：SMTP服务器配置（用于邮件发送）

4.3 Docker Compose配置示例

yaml
version: '3.8'
services:
  basket:
    image: docker.xuanyuan.run/mozilla/basket:latest
    ports:
      - "8000:8000"
    volumes:
      - basket_data:/app/data
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/basket
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=user@example.com
      - SMTP_PASSWORD=smtp_password
      - DEBUG=False
      - SECRET_KEY=your_secret_key
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/postgres:14
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=basket

volumes:
  basket_data:
  postgres_data:

4.4 核心配置参数

4.5 数据持久化

通过 -v /path/to/data:/app/data 挂载容器内/app/data目录，持久化以下数据：

• 订阅用户数据（CSV/JSON格式备份）
• 邮件发送日志
• 自定义邮件模板

5. 维护与更新

• 镜像更新：通过docker pull docker.xuanyuan.run/mozilla/basket:latest获取最新版本
• 数据备份：定期备份挂载的/app/data目录及数据库数据
• 日志查看：通过docker logs basket查看应用运行日志

6. 注意事项

• 生产环境中必须设置SECRET_KEY并确保其安全性
• SMTP服务器需配置正确，避免邮件发送失败
• 高并发场景下建议搭配Redis集群与数据库主从架构使用