wernerfred/docker-rainloop

!GitHub Workflow Status !Docker Pulls !GitHub !Docker Image Size (latest semver) !GitHub release (latest SemVer) !Docker Image Version (latest semver) !GitHub Release Date

使用Docker托管您自己的Rainloop实例

本项目允许您使用Docker托管https://github.com/RainLoop/rainloop-webmail%E7%A4%BE%E5%8C%BA%E7%89%88%E5%AE%9E%E4%BE%8B%EF%BC%88%E5%9F%BA%E4%BA%8EGNU AGPL v3许可）。

GitHub仓库：https://github.com/wernerfred/docker-rainloop

镜像概述和主要用途

该镜像基于官方php-apache基础镜像构建，将Rainloop社区版Web邮件客户端打包为Docker容器，便于快速部署和管理私有Web邮件服务。Rainloop提供直观的Web界面，支持多***账户管理，适合个人或小型团队搭建私有邮件客户端。

核心功能和特性

• 基于Rainloop社区版，支持标准邮件协议（IMAP、SMTP）
• 使用php-apache基础镜像，稳定可靠
• 内置数据持久化机制，支持***卷、命名卷和绑定挂载
• 提供管理员面板，可配置邮件服务、用户权限等
• 支持版本标签，镜像版本与Rainloop版本同步（从1.14.0开始）
• 兼容Nginx、Traefik等反向代理，便于配置SSL加密

使用场景和适用范围

• 个人用户搭建私有Web邮件客户端
• 小型团队部署内部邮件访问门户
• 需要快速部署Web邮件服务的场景
• 希望通过Docker简化Rainloop部署和维护的用户

安装与使用方法

从源码构建

克隆GitHub仓库并进入目录，执行以下命令构建镜像：

bash
docker build -t wernerfred/docker-rainloop .

从DockerHub拉取

直接从DockerHub拉取官方镜像：

bash
docker pull wernerfred/docker-rainloop

运行容器

使用docker run命令启动容器（可根据需求调整端口）：

bash
docker run -d \
           -p 80:80 \
           wernerfred/docker-rainloop

数据持久化

容器默认创建***卷存储数据，也可通过以下方式配置持久化：

Docker Compose（绑定挂载示例）

yaml
version: '3'

services:
  rainloop:
    image: wernerfred/docker-rainloop:latest
    container_name: docker-rainloop
    restart: always
    ports:
      - 80:80
    volumes:
      - /opt/docker-rainloop/data:/rainloop/data  # 本地目录绑定到容器数据目录

配置说明

管理员面板访问

通过以下URL访问管理员面板：http://YOUR-IP/?admin
默认登录凭据：

• 用户名：admin
• 密码：12345（建议登录后立即修改）

配置文件路径

配置数据存储于容器内：/rainloop/data/_data_/_default_/configs/application.ini
更多配置选项请参考官方文档。

容器结构

• 基础镜像：php-apache
• Rainloop安装路径：/rainloop
• 数据目录：/rainloop/data（需持久化）
• 默认端口：80（Apache服务）
• 版本标签：镜像版本与Rainloop版本对应（如wernerfred/docker-rainloop:1.14.0对应Rainloop 1.14.0）

反向代理配置

建议通过反向代理访问容器，并配置SSL加密。

Nginx配置示例

假设容器暴露于8080端口，使用Let's Encrypt证书：

nginx
server {
    listen       80;
    server_name  <mail.domain.tld>;
    return       301 https://$host$request_uri;  # HTTP重定向到HTTPS
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name <mail.domain.tld>;
    root /dev/null;

    access_log /var/log/nginx/<mail.domain.tld>.access.log combined;
    error_log /var/log/nginx/<mail.domain.tld>.error.log warn;

    location / {
      proxy_pass http://localhost:8080;  # 代理到Rainloop容器
      proxy_set_header X-Forwarded-Host $host:$server_port;
      proxy_set_header X-Forwarded-Server $host;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
    # SSL配置
    ssl_certificate /etc/letsencrypt/live/<mail.domain.tld>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<mail.domain.tld>/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/<mail.domain.tld>/chain.pem;
    ssl_protocols TLSv1.2;
    ssl_prefer_server_ciphers on;
}

Traefik配置示例

假设Traefik与容器在同一proxy网络：

yaml
version: '3'

services:
  rainloop:
    image: wernerfred/docker-rainloop:latest
    container_name: docker-rainloop
    restart: always
    volumes:
      - /opt/docker-rainloop/data:/rainloop/data
    networks:
      - proxy
    labels:
      - "traefik.enable=true"
      - "traefik.http.middlewares.rainloop-https.redirectscheme.scheme=https"
      - "traefik.http.routers.rainloop-http.entrypoints=web"
      - "traefik.http.routers.rainloop-http.rule=Host(`<mail.domain.tld>`)"
      - "traefik.http.routers.rainloop-http.middlewares=rainloop-https@docker"
      - "traefik.http.routers.rainloop-https.entrypoints=websecure"
      - "traefik.http.routers.rainloop-https.rule=Host(`<mail.domain.tld>`)"
      - "traefik.http.routers.rainloop-https.tls=true"
      - "traefik.http.routers.rainloop-https.tls.certresolver=letsencrypt"
      - "traefik.http.routers.rainloop-https.tls.domains[0].main=<mail.domain.tld>"

networks:
  proxy:
    external: true