joltdesign/wp-cron

WP-Cron外部运行容器镜像

镜像概述

本Docker镜像旨在从外部容器自动运行WordPress的WP-Cron任务。WordPress默认通过网站访问触发WP-Cron，可能导致任务执行不及时或依赖访问量。该镜像提供独立的定时触发机制，确保WP-Cron任务按预期频率可靠执行。

核心功能与特性

• 独立运行：与WordPress主容器分离，不占用主应用资源
• 自动触发：定时执行WP-Cron任务，无需依赖网站访问
• 灵活配置：支持自定义执行频率和目标WordPress地址
• 轻量级：基于精简基础镜像，资源占用低

使用场景

• 生产环境中需要可靠执行WordPress定时任务（如数据库备份、内容更新、插件任务等）
• 流量较低的WordPress网站，避免因访问不足导致WP-Cron任务延迟
• 需要控制WP-Cron执行时间和频率的场景

使用方法

基本运行命令

bash
docker run -d \
  --name wp-cron-runner \
  -e WORDPRESS_URL="https://your-wordpress-site.com" \
  -e CRON_INTERVAL="*/15 * * * *" \
  wp-cron-external

环境变量配置

Docker Compose配置示例

yaml
version: '3'

services:
  wordpress:
    image: wordpress
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: exampleuser
      WORDPRESS_DB_PASSWORD: examplepass
      WORDPRESS_DB_NAME: exampledb
    volumes:
      - wordpress_data:/var/www/html

  wp-cron:
    image: wp-cron-external
    depends_on:
      - wordpress
    environment:
      WORDPRESS_URL: "http://wordpress"  # 使用容器名称作为主机名
      CRON_INTERVAL: "*/10 * * * *"      # 每10分钟执行一次

  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: examplepass
      MYSQL_DATABASE: exampledb
      MYSQL_USER: exampleuser
      MYSQL_PASSWORD: examplepass

volumes:
  wordpress_data:
  db_data:

注意事项

1. 确保WORDPRESS_URL可被该容器访问（使用容器网络时可直接使用服务名称）
2. 对于启用了基本认证的WordPress站点，需在URL中包含认证信息（如https://user:pass@example.com）
3. 可通过调整CRON_INTERVAL满足不同任务频率需求（遵循标准Cron表达式格式）
4. 建议与WordPress容器使用相同的网络以确保通信顺畅