bubbajames/sendy

快速参考

这是Sendy的非官方Docker仓库。

• 维护者：https://github.com/bubbajames-docker/sendy
• 帮助渠道：Sendy故障排除与支持指南、Sendy社区论坛
• 需要许可证：购买详情

快速参考（续）

• Docker相关问题反馈：https://github.com/bubbajames-docker/sendy/issues
• 应用问题反馈：参见Sendy故障排除与支持指南

什么是Sendy？

Sendy是一款自托管的电子邮件通讯应用，可通过Amazon Simple Email Service (SES)发送可追踪的邮件。这使得你能够以极低的价格发送经过身份验证的批量邮件，同时不牺牲送达率。

更多信息及Sendy服务器和其他产品的相关下载，请访问Sendy官网。

如何使用该镜像

启动Sendy实例非常简单。

console
$ docker run -d \
  --name sendy \
  -e SENDY_FQDN=campaigns.example.com \
  -e MYSQL_HOST=db_sendy \
  -e MYSQL_PASSWORD=db_password \
  bubbajames/sendy:tag

其中 sendy 是你为容器分配的名称，campaigns.example.com 是Sendy服务器的完全限定域名，db_sendy 是数据库服务器实例，db_password 是数据库用户的密码，tag 是指定你想要的Sendy版本的标签（请查看上方的标签列表）。

环境变量

SENDY_PROTOCOL（可选）

Sendy APP_PATH中使用的HTTP协议（http 或 https）。默认值：http

SENDY_FQDN（必填）

Sendy安装的完全限定域名，必须与你的许可证关联的FQDN匹配。你可以在此购买许可证。

MYSQL_HOST（必填）

托管Sendy数据库的MySQL服务器地址。

MYSQL_DATABASE（可选）

Sendy数据库名称。默认值：sendy。

MYSQL_USER（可选）

数据库用户。默认值：sendy。

MYSQL_PASSWORD（必填）

数据库用户的密码。不建议用于敏感数据（请参见：Docker Secrets）。

SENDY_DB_PORT（可选）

数据库端口。默认值：3306。

Docker Secrets

作为通过环境变量传递敏感信息的替代方案，可以在上述环境变量后追加 _FILE，使初始化脚本从容器内的文件中加载这些变量的值。特别是，这可用于从存储在 /run/secrets/<secret_name> 文件中的Docker Secrets加载密码（请参见https://github.com/bubbajames-docker/sendy%E8%8E%B7%E5%8F%96%E7%A4%BA%E4%BE%8BSecrets%EF%BC%89%E3%80%82

例如：

console
$ docker run -d --name sendy -e MYSQL_PASSWORD_FILE=/run/secrets/mysql-root -d sendy

使用 Dockerfile

Dockerfile非常简洁，因为所需的一切都已捆绑。只需提供环境变量或环境文件即可。

dockerfile
FROM bubbajames/sendy:5.2

# ... 在此添加额外的apache/php配置 ... 
# 例如：如果不使用负载均衡器，复制你的SSL证书和apache配置。  

启动Sendy实例

以下命令通过指定环境文件启动实例：

console
$ docker run -d -name sendy --env_file sendy.env -p 80:80 sendy

示例环境文件

ini
SENDY_FQDN=campaigns.example.com
MYSQL_HOST=db_sendy
MYSQL_DATABASE=sendy
MYSQL_USER=sendy
MYSQL_PASSWORD_FILE=/run/secrets/db_password
# MYSQL_PASSWORD=db_password

使用 docker-compose

启动用于SSL终止的HAProxy负载均衡器实例、Sendy实例和带有挂载卷的MySQL数据库实例（用于重启间的数据持久化）。同时使用Docker Secrets避免通过“inspect”暴露敏感数据。

最新的 docker-compose.yml 和示例文件可从镜像https://github.com/bubbajames-docker/sendy%E8%8E%B7%E5%8F%96%E3%80%82%E5%BC%BA%E7%83%88%E5%BB%BA%E8%AE%AE%E5%85%8B%E9%9A%86%E6%AD%A4%E4%BB%93%E5%BA%93%E4%BB%A5%E7%A1%AE%E4%BF%9D%E4%BD%BF%E7%94%A8%E6%9C%80%E6%96%B0%E7%A4%BA%E4%BE%8B%E3%80%82

yaml
version: "3.7"

# 用于持久化数据的卷
volumes: 
  data_sendy:
    labels: 
      co.sendy.description: "Sendy数据库的数据卷"

# 秘密文件，避免通过'docker inspect'暴露
secrets:
  db_password:
    file: secrets/db_password
  db_root_password:
    file: secrets/db_root_password    

services:
  # 数据库：MySQL
  db_sendy:
    hostname: db_sendy
    container_name: db_sendy
    image: mysql:5.6
    env_file: 
      - sendy.env
    environment:
      MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
    secrets:
      - db_root_password
      - db_password      
    volumes: 
      - data_sendy:/var/lib/mysql

  # Web应用：Apache2+PHP+Sendy
  sendy:
    hostname: sendy
    container_name: sendy
    depends_on: 
      - db_sendy
    image: sendy:5.2
    build: 
      context: .
      # 取消注释以启用XDEBUG构建
      # target: debug
    env_file: 
      - sendy.env
    secrets:
      - db_password 
    ports:
      - 8080:80

  # 负载均衡器：HAProxy
  load-balancer:
    hostname: lb_sendy
    container_name: lb_sendy
    image: lb_sendy
    build:
      context: .
      dockerfile: haproxy/Dockerfile   
    env_file: 
      - sendy.env      
    ports:
      - 80:80
      - 443:443

启动服务

console
$ docker-compose up -d

停止服务

console
$ docker-compose down

Crontab支持

已安装并配置Crontab，包含以下任务：

计划邮件活动

安排营销活动在未来特定时间发送。此任务每5分钟执行一次，以确定是否有活动需要启动。

自动回复

为收到的邮件设置自动回复。此任务每1分钟执行一次，以确定是否有邮件需要自动回复。

导入联系人列表

导入CSV文件中的联系人列表。此任务每1分钟执行一次，以确定是否有导入列表任务已创建，并在需要时启动CSV文件导入。

鸣谢

Brad Touesnard

请阅读Brad Touesnard的文章如何为本地HTTPS开发创建自己的SSL证书颁发机构，该文章启发了本项目中使用的generateSSLCertificate.sh脚本。

许可证

请参见仓库中的https://raw.githubusercontent.com/bubbajames-docker/sendy/master/LICENSE%E3%80%82

与所有Docker镜像一样，这些镜像可能还包含其他受其他许可证约束的软件（例如基础发行版中的Bash等，以及包含的主要软件的任何直接或间接依赖项）。

对于任何预构建镜像的使用，镜像用户有责任确保该镜像的任何使用符合其中包含的所有软件的相关许可证。