si458/zpush

zpush Docker镜像

镜像概述

zpush Docker镜像是将开源ActiveSync协议实现z-push集成到Docker容器中的部署方案。该镜像提供了便捷的容器化部署方式，使z-push服务的安装、配置和管理更加简单高效。

主要用途

作为ActiveSync服务器，实现移动设备（如iOS、Android设备）与邮件服务器之间的双向数据同步，支持邮件、联系人、日历、任务等信息的实时同步。

核心功能和特性

• ActiveSync协议支持：完整实现ActiveSync协议，兼容主流移动操作系统的邮件客户端
• 容器化部署：基于Docker容器，简化环境依赖管理，支持快速部署和迁移
• 跨平台兼容：可在任何支持Docker的操作系统上运行，包括Linux、Windows和macOS
• 轻量级设计：优化容器体积，降低资源占用
• 开源免费：基于z-push开源项目，无需额外许可费用

使用场景和适用范围

• 企业内部邮件系统的移动设备同步解决方案
• 个人自建邮件服务器（如Postfix、Dovecot等）的移动接入需求
• 需要为移动设备提供邮件、联系人、日历同步服务的场景
• 希望简化z-push服务部署和维护的用户

使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动zpush容器：

bash
docker run -d -p 80:80 --name zpush \
  -v /path/to/zpush/config:/etc/z-push \
  -v /path/to/zpush/logs:/var/log/z-push \
  your-zpush-image:latest

参数说明：

• -p 80:80：将容器内80端口映射到主机80端口（HTTP服务）
• -v /path/to/zpush/config:/etc/z-push：挂载本地配置目录到容器内z-push配置目录
• -v /path/to/zpush/logs:/var/log/z-push：挂载本地日志目录，用于持久化存储日志

配置文件说明

z-push的核心配置文件位于容器内/etc/z-push目录，主要配置文件包括：

• config.php：主配置文件，包含服务器连接信息、同步设置等
• backend.php：后端配置，指定邮件服务器连接方式（如IMAP、CardDAV等）

访问服务

容器启动后，可通过http://主机IP访问z-push服务，移动设备需配置ActiveSync账户，服务器地址填写主机IP或域名。

注意事项

• 生产环境建议使用HTTPS加密，可配合Nginx或Apache等反向代理实现
• 配置文件需根据实际邮件服务器类型（如Exchange、IMAP、Kolab等）进行相应调整
• 首次使用需确保邮件服务器与z-push的网络连通性