Wodanio Webserver 镜像文档

镜像概述和主要用途

Wodanio Webserver是一款集成多种服务组件的Docker镜像，旨在提供一站式Web服务和定时任务解决方案。包含Nginx（Web服务器）、PHP 8.4（含PHP-FPM）、Node 22（运行时环境）、TTYd（Web终端工具）及Nano（文本编辑器），支持web模式（默认，提供Web服务）和cron模式（运行定时任务），适用于需要快速部署Web应用并配置自定义PHP、Nginx参数的场景。

核心功能和特性

集成组件

• Web服务基础：Nginx（Web服务器）、PHP 8.4、PHP-FPM（PHP进程管理器）
• 开发工具：Node 22（JavaScript运行时）、Nano（轻量级文本编辑器）
• 终端访问：TTYd（通过Web端口访问容器终端）

运行模式

• Web模式（默认）：启动Nginx和TTYd服务，提供Web访问和终端功能
• Cron模式：运行定时任务，支持多任务配置

使用场景和适用范围

• 需要同时部署Web服务和定时任务的应用（如内容管理系统、数据处理服务）
• 快速搭建开发/测试环境，需自定义PHP内存、上传限制等参数
• 需要通过Web界面访问容器终端进行临时操作的场景

使用方法和配置说明

基本运行方式

Web模式（默认）

docker run -p 80:80 -p 81:81 wodanio/webserver

Cron模式

docker run wodanio/webserver cron

端口映射（Web模式）

环境变量配置

通用环境变量（PHP与Nginx配置）

Cron任务环境变量

通过以下变量配置定时任务，其中X为从1开始的序号（如1、2、3...），支持配置多个任务。

部署示例

示例1：Web模式（自定义PHP和Web根目录）

docker run -d \
  -p 8080:80 \
  -p 8081:81 \
  -e PHP_MEMORY_LIMIT=512M \
  -e PHP_UPLOAD_MAX_FILESIZE=128M \
  -e WEB_ROOT=/app \
  -v $(pwd)/www:/var/www/app \  # 挂载本地代码到容器Web根目录
  wodanio/webserver

示例2：Cron模式（配置两个定时任务）

docker run -d \
  -e CRON_1_TIME="*/5 * * * *" \  # 每5分钟执行一次
  -e CRON_1_CMD="php /var/www/cleanup.php" \
  -e CRON_2_TIME="0 0 * * *" \    # 每天凌晨执行
  -e CRON_2_CMD="bash /var/www/backup.sh" \
  -v $(pwd)/scripts:/var/www \    # 挂载本地脚本到容器
  wodanio/webserver cron

示例3：docker-compose配置（Web+Cron组合）

version: '3'
services:
  web:
    image: wodanio/webserver
    ports:
      - "80:80"   # Web服务
      - "81:81"   # TTYd终端
    environment:
      - PHP_MEMORY_LIMIT=512M
      - WEB_TIMEOUT=120s
      - WEB_ROOT=/public  # 代码目录为/var/www/public
    volumes:
      - ./app:/var/www/public  # 挂载应用代码
    restart: always

  cron:
    image: wodanio/webserver
    command: cron
    environment:
      - CRON_1_TIME="* * * * *"
      - CRON_1_CMD="echo '定时任务执行' >> /var/log/cron.log"
    volumes:
      - ./logs:/var/log  # 挂载日志目录
    restart: always