Citadel Docker镜像文档

镜像概述和主要用途

Citadel Docker镜像是基于Citadel开源平台的容器化部署方案，提供一站式的电子邮件、群件和内容管理功能。该镜像将Citadel的核心服务（包括邮件服务器、协作工具和内容管理系统）打包，简化部署流程，适用于需要集成通信与协作功能的各类场景。

核心功能和特性

• 电子邮件服务：支持SMTP、IMAP、POP3等标准邮件协议，提供完整的邮件收发、存储和管理能力。
• 群件功能：集成日历、联系人管理、任务协作等团队协作工具，支持多用户共享和同步。
• 内容管理：提供文档存储、共享和版本控制功能，满足团队内容协作需求。
• 多用户支持：支持多租户架构，可配置不同用户角色和权限。
• 安全性：内置SSL/TLS加密、垃圾邮件过滤和防病毒扫描（需额外配置）。
• 可扩展性：支持插件扩展，可根据需求添加额外功能模块。

使用场景和适用范围

• 小型企业/组织：作为内部通信和协作平台，集成邮件、日历和文档管理。
• 团队协作：用于项目团队的邮件沟通、日程安排和文件共享。
• 个人用户：搭建个人邮件服务器和私有内容管理系统。
• 教育机构：作为师生间通信、课程资料管理的内部平台。

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）
• 已安装Docker Compose（可选，用于多容器部署）

基本部署示例

使用docker run快速启动

docker run -d \
  --name citadel \
  -p 25:25 \
  -p 80:80 \
  -p 443:443 \
  -p 143:143 \
  -p 993:993 \
  -v citadel_data:/var/lib/citadel \
  citadelorg/citadel

说明：

• -p参数映射必要端口（SMTP:25、HTTP:80、HTTPS:443、IMAP:143/993等）
• -v citadel_data:/var/lib/citadel挂载数据卷持久化配置和用户数据

Docker Compose配置（推荐）

创建docker-compose.yml文件：

version: '3'
services:
  citadel:
    image: citadelorg/citadel
    container_name: citadel
    ports:
      - "25:25"       # SMTP
      - "80:80"       # HTTP
      - "443:443"     # HTTPS
      - "110:110"     # POP3
      - "143:143"     # IMAP
      - "993:993"     # IMAPS
      - "995:995"     # POP3S
    volumes:
      - citadel_data:/var/lib/citadel
      - ./ssl:/etc/citadel/ssl  # 挂载自定义SSL证书（可选）
    environment:
      - CITADEL_ADMIN_USER=admin
      - CITADEL_ADMIN_PASSWORD=securepassword
    restart: unless-stopped

volumes:
  citadel_data:

启动服务：

docker-compose up -d

配置说明

环境变量

数据持久化

建议挂载以下目录以确保数据持久化：

• /var/lib/citadel：核心数据目录（用户信息、邮件、配置等）
• /etc/citadel/ssl：SSL证书目录（自定义证书需放置于此）

访问和管理

服务启动后，可通过以下方式访问：

• Web管理界面：http://<服务器IP> 或 https://<服务器IP>
• 邮件客户端配置：使用IMAP/SMTP协议，服务器地址为<服务器IP>，端口对应993（IMAPS）/465（SMTPS）

更多信息

完整配置文档和高级功能说明，请参考官方网站：
[***]