micrograils/discuz

!https://img.shields.io/docker/image-size/micrograils/discuz/latest !https://img.shields.io/docker/pulls/micrograils/discuz !https://img.shields.io/badge/platforms-amd64%20%7C%20arm64-blue

micrograils/discuz

基于Alpine Linux的Discuz!论坛Docker镜像，集成Nginx + PHP-FPM，开箱即用。

---

✨ 特点

• 超轻量：基于Alpine Linux，体积小，启动快
• 开箱即用：内置Nginx + PHP-FPM，通过Supervisor统一管理
• 多架构支持：支持AMD64 / ARM64双平台
• 自动HTTPS适配：根据X-Forwarded-Proto头部自动判断HTTPS
• 静态资源缓存：对JS/CSS/图片等静态资源自动设置长期缓存
• PHP优化配置：已调整upload_max_filesize、post_max_size、memory_limit等参数

---

📚 版本说明

镜像标签格式：micrograils/discuz:<VERSION>

---

🚀 快速上手

1. 快速启动（需额外准备数据库）

bash
docker run -d \
    --name discuz \
    -p 12345:80 \
    micrograils/discuz:latest

或带持久化数据：

bash
docker run -d \
    --name discuz \
    -p 12345:80 \
    -v $PWD/data/discuz:/var/www/html \
    micrograils/discuz:latest

启动后访问http://localhost:12345，进入Discuz!安装向导。

2. 使用Docker Compose部署

示例docker-compose.yml如下，请自行修改数据库密码等信息：

yaml
services:
  discuz_web:
    image: micrograils/discuz:3.5.20250901
    restart: always
    volumes:
      - ./data/discuz:/var/www/html
    ports:
      - "12345:80"
    depends_on:
      - discuz_db
    networks:
      - discuz_net
  discuz_db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: discuz
      MYSQL_USER: discuz
      MYSQL_PASSWORD: discuz_password
    volumes:
      - ./data/mysql:/var/lib/mysql
    networks:
      - discuz_net
networks:
  discuz_net:
    driver: bridge

安装时填写数据库信息：

• 数据库服务器：discuz_db
• 数据库名：discuz
• 数据库用户名：discuz
• 数据库密码：discuz_password

---

🔧 进阶教程

1. 自定义配置

如果最终部署在HTTPS后面（例如nginx），参考配置如下：

nginx
server {
    listen 443;
    server_name your_domain.com;

    # HTTPS配置
    ssl on;
    ssl_certificate /path/to/certificate.pem;
    ssl_certificate_key /path/to/privatekey.pem;

    location / {
        proxy_pass http://127.0.0.1:12345;
        proxy_set_header Host $host;
        # 重要
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

无论是否开启了HTTPS:

1. X-Forwarded-Proto头部都会被识别，并根据其值自动调整配置
2. discuz后台: 全局 - 站点设置 - 站点URL调整为公网url，例如https://your_domain.com
3. 然后继续后台：工具 - 更新缓存

注：某些情况下，虽然是在HTTPS后面，但X-Forwarded-Proto头部可能不存在（比如前面的反代配置你没有修改权利），此时需要手动调整配置：

bash
docker exec -it ${discuz_web_real_id} /bin/sh

sed -i 's/fastcgi_param HTTPS $php_https;/fastcgi_param HTTPS on;/g' /etc/nginx/http.d/default.conf

nginx -t && nginx -s reload

---

📝 技术细节

基础环境

• Alpine Linux：3.22.2
• PHP版本：8.2
• Web服务器：Nginx
• 进程管理：Supervisor

PHP扩展（discuz最小化需求）

• mysqli（数据库连接）
• curl、gd、xml（网络、图片、XML处理）
• iconv、simplexml（字符编码转换）
• sodium（加密功能）
• bcmath、ctype、phar（数学运算、字符类型判断、归档处理）

PHP配置优化

Nginx配置特性

• 支持HTTPS自动识别（通过X-Forwarded-Proto）
• 隐藏隐藏文件（以.开头的文件）
• 静态资源缓存1年
• 友好的URL重写规则

---

🔍 常见问题

Q：如何查看当前PHP版本和配置？

bash
docker exec -it discuz php -v
docker exec -it discuz php -i

Q：如何进入容器调试？

bash
docker exec -it discuz /bin/sh

Q：如何查看Nginx日志？

bash
docker logs discuz

Q：master版本会自动更新吗？ A：需要手动重新构建镜像。master镜像跟随Gitee源码仓库v3.5分支的最新提交，需要重新构建才能获取最新代码。

---

🤝 反馈 & 贡献

• Discuz!官方网站
• https://gitee.com/Discuz/DiscuzX
• 遇到问题或需要新功能，欢迎提Issue / PR！

---

micrograils/discuz

• https://gitee.com/micrograils/docker/tree/master/discuz

让搭建论坛像搭积木一样简单。