Flarum Docker镜像文档

镜像概述

Flarum Docker镜像是用于部署Flarum轻量级开源论坛系统的容器化解决方案。Flarum是一款专注于简洁性与可用性的现代论坛软件，采用PHP开发，支持响应式设计，适合构建各类社区讨论平台。该镜像封装了Flarum运行所需的依赖环境，简化了部署流程，可快速实现论坛系统的搭建与维护。

核心功能与特性

• 快速部署：无需手动配置PHP环境、Web服务器及依赖库，通过Docker命令或docker-compose一键启动
• 数据持久化：支持通过卷挂载保存论坛核心数据（配置文件、用户上传内容、扩展插件等），确保容器重启或升级后数据不丢失
• 灵活配置：通过环境变量自定义数据库连接、管理员信息、PHP内存限制等关键参数
• 数据库兼容：支持与MySQL/MariaDB等主流关系型数据库集成，可连接外部数据库或通过容器化数据库部署
• 扩展生态：支持Flarum官方及第三方扩展安装，可通过后台管理界面一键扩展论坛功能
• 响应式设计：原生支持移动端适配，部署后自动提供跨设备访问体验

使用场景

• 个人博客/网站的附属社区论坛
• 小型技术社区或兴趣小组讨论平台
• 团队内部项目交流与协作空间
• 开源项目用户反馈与讨论区
• 教育机构师生互动平台

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+）及Docker Compose（推荐v2+）
• 具备网络连接（用于拉取镜像及依赖）
• 生产环境需开放对应端口（默认80/tcp）

基础部署（docker run）

1. 启动数据库容器（示例使用MariaDB）

docker run -d \
  --name flarum_db \
  -e MYSQL_DATABASE=flarum \
  -e MYSQL_USER=flarumuser \
  -e MYSQL_PASSWORD=flarumpassword \
  -e MYSQL_ROOT_PASSWORD=secure_root_password \
  -v flarum_db_data:/var/lib/mysql \
  --restart always \
  mariadb:10.6

2. 启动Flarum容器

docker run -d \
  --name flarum \
  -p 80:80 \
  --link flarum_db:db \
  -e DB_HOST=db \
  -e DB_NAME=flarum \
  -e DB_USER=flarumuser \
  -e DB_PASS=flarumpassword \
  -e FLARUM_URL=[***] \
  -e PHP_MEMORY_LIMIT=256M \
  -v flarum_data:/var/www/html \
  --restart always \
  mondediefr/docker-flarum

Docker Compose部署（推荐）

1. 创建docker-compose.yml文件

version: '3.8'

services:
  flarum:
    image: mondediefr/docker-flarum
    container_name: flarum
    restart: always
    ports:
      - "80:80"
    environment:
      # 数据库连接配置
      - DB_HOST=db
      - DB_NAME=flarum
      - DB_USER=flarumuser
      - DB_PASS=flarumpassword
      # 论坛基础配置
      - FLARUM_URL=http://localhost:80
      - PHP_MEMORY_LIMIT=256M
      # 管理员初始化配置（可选，首次启动时生效）
      # - FLARUM_ADMIN_USER=admin
      # - FLARUM_ADMIN_EMAIL=***
      # - FLARUM_ADMIN_PASS=admin_password
    volumes:
      - flarum_data:/var/www/html
    depends_on:
      - db

  db:
    image: mariadb:10.6
    container_name: flarum_db
    restart: always
    environment:
      - MYSQL_DATABASE=flarum
      - MYSQL_USER=flarumuser
      - MYSQL_PASSWORD=flarumpassword
      - MYSQL_ROOT_PASSWORD=secure_root_password
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u$$MYSQL_USER", "-p$$MYSQL_PASSWORD"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  flarum_data:  # 存储Flarum核心数据
  db_data:      # 存储数据库数据

2. 启动服务

# 后台启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

环境变量配置说明

数据持久化

Flarum核心数据存储路径：

• 容器内路径：/var/www/html
• 推荐通过卷挂载持久化：-v flarum_data:/var/www/html（命名卷）或-v /host/path:/var/www/html（主机路径）

数据库数据通过挂载/var/lib/mysql目录持久化（如docker-compose示例中的db_data卷）

访问与初始化

1. 首次访问：启动容器后，通过FLARUM_URL配置的地址访问（如http://localhost）
2. 初始化设置：
   • 若未通过环境变量配置管理员信息，首次访问将进入安装向导，需手动填写管理员用户名、邮箱及密码
   • 完成初始化后，使用管理员账号登录后台（访问/admin路径）
3. 扩展安装：登录管理员后台后，通过「扩展」菜单搜索并安装所需插件（需网络连接）

注意事项

• 生产环境配置：建议通过Nginx反向代理配置HTTPS（可使用certbot获取免费SSL证书），并限制容器网络访问
• 数据备份：定期备份挂载的卷数据（flarum_data和db_data），可通过docker volume inspect查看卷存储路径
• 版本升级：升级镜像时需先备份数据，然后执行docker-compose pull及docker-compose up -d完成更新
• 安全加固：避免使用弱密码，生产环境中建议删除MYSQL_ROOT_PASSWORD环境变量，通过docker exec手动配置数据库权限

常见问题

• 数据库连接失败：检查DB_HOST是否正确（容器化部署时使用服务名，如docker-compose中的db），数据库服务是否健康
• 权限问题：若挂载主机路径出现权限错误，可通过chmod -R 777 /host/path临时测试（生产环境需配置正确的UID/GID映射）
• 扩展安装失败：检查网络连接，确保容器可访问Flarum扩展仓库，或手动下载扩展包至/var/www/html/extensions目录