waazaafr/webserver-apache-php8

webserver-apache-php8

集成Apache + PHP8的Docker镜像，具备持久化/var/www目录布局、可选反向代理支持，以及一系列常用PHP扩展和实用工具。

---

标签规范

• 每个PHP次要版本标签对应上游基础PHP镜像。
• 主版本标签始终指向该分支中可用的最新次要版本。

示例：

• 8.4 当前指向 8.4.20-apache-trixie

架构说明：

• arm64 镜像使用带有 -arm64 后缀的独立标签。

---

更新记录

2026-05-01

• 添加 FORCE_CHOWN 变量，默认禁用。
• 当设置为 true 时，使用提供的 PUID 和 PGID 更新 /var/www 的所有权。

2026-03-20

• 添加 locales-all。

2026-03-15

• 移除无文件时自动生成 index.php 的功能。

2026-02-15

• 添加 PUID 和 PGID 变量，用于定义 apache2 用户ID并设置 /var/www 的所有权。

2026-01-27

• 添加 redis PHP扩展。
• 修复代理处理。

---

镜像说明

PHP及其依赖项从镜像中包含的 packages.sury.org 仓库安装。

包含的实用工具

bash
locales-all nano tree git zip unzip smbclient composer mariadb-client postgresql-client redis-tools curl sqlite3

启用的Apache模块

包含的PHP扩展

---

使用说明

所有持久化文件存储在 /var/www 目录，建议将此目录绑定到主机上的位置。

持久化目录布局

环境变量

---

部署示例

Docker Compose

yaml
services:
  app:
    image: docker.xuanyuan.run/waazaafr/webserver-apache-php8:8.2
    container_name: webserver
    restart: unless-stopped
    ports:
      - "8787:80"
    volumes:
      - ./webserver:/var/www
    environment:
      TZ: Europe/Paris
      PUBLIC_FOLDER: "false"
      PROXY_LOCAL_IPS: 192.168.1.23
      PROXY_EXTERNAL_IPS: 192.168.1.23

Docker Run

bash
docker run -d \
  --name webserver \
  --restart unless-stopped \
  -p 8787:80 \
  -v ./webserver:/var/www \
  -e TZ=Europe/Paris \
  -e PUBLIC_FOLDER=false \
  -e PROXY_LOCAL_IPS=192.168.1.23 \
  -e PROXY_EXTERNAL_IPS=192.168.1.23 \
  docker.xuanyuan.run/waazaafr/webserver-apache-php8:8.2

---

工具

容器内提供两个辅助二进制文件：

• apache-stop
• apache-start

这些工具在 cron 任务中很有用，例如在运行 mysqldump 或 pg_dump 前临时停止Apache。

---

链接

• : []
• Buy me a coffee: [***]
• : []
• UnRAID 许可证: [***]
• VPS: [***]