Flarum Docker镜像文档

镜像概述

本Docker镜像基于Alpine Linux构建，封装了Flarum——一款现代、轻量级的开源论坛软件。Alpine Linux的精简特性使镜像体积小、资源占用低，同时包含Flarum运行所需的完整依赖，支持快速部署功能完善的社区论坛。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，运行时资源消耗低，适合资源受限环境。
• 完整依赖：内置Flarum运行所需的PHP环境、扩展及依赖组件，开箱即用。
• 灵活配置：支持通过环境变量自定义论坛设置（如数据库连接、URL配置等）。
• 易于维护：Docker化部署简化版本更新和依赖管理，降低维护成本。
• 兼容性：兼容主流容器编排工具（如Docker Compose、Kubernetes）。

使用场景与适用范围

• 个人或小型社区搭建轻量级论坛平台。
• 需要低资源消耗的论坛解决方案（如VPS、个人服务器）。
• 快速原型验证或临时论坛部署。
• 希望通过容器化方式简化部署流程的开发者或管理员。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop。
• 若需持久化数据，建议配合数据库容器（如MySQL、PostgreSQL）使用（Flarum需外部数据库支持）。

基本部署（Docker Run）

1. 启动数据库容器（示例：MySQL）

docker run -d \
  --name flarum-mysql \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=flarum \
  -e MYSQL_USER=flarumuser \
  -e MYSQL_PASSWORD=flarumpass \
  -v flarum-mysql-data:/var/lib/mysql \
  mysql:8.0

2. 启动Flarum容器

docker run -d \
  --name flarum \
  --link flarum-mysql:mysql \
  -p 8080:80 \
  -e DB_HOST=mysql \
  -e DB_NAME=flarum \
  -e DB_USER=flarumuser \
  -e DB_PASS=flarumpass \
  -e FLARUM_URL=http://localhost:8080 \
  -v flarum-data:/app/public/assets \
  -v flarum-extensions:/app/extensions \
  crazy-max/docker-flarum

Docker Compose部署（推荐）

创建docker-compose.yml文件：

version: '3.8'

services:
  flarum:
    image: crazy-max/docker-flarum
    container_name: flarum
    restart: always
    ports:
      - "8080:80"
    environment:
      - DB_HOST=mysql
      - DB_NAME=flarum
      - DB_USER=flarumuser
      - DB_PASS=flarumpass
      - FLARUM_URL=http://localhost:8080
      - PHP_MEMORY_LIMIT=128M
    volumes:
      - flarum-data:/app/public/assets
      - flarum-extensions:/app/extensions
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    container_name: flarum-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=flarum
      - MYSQL_USER=flarumuser
      - MYSQL_PASSWORD=flarumpass
    volumes:
      - flarum-mysql-data:/var/lib/mysql

volumes:
  flarum-data:
  flarum-extensions:
  flarum-mysql-data:

启动服务：

docker-compose up -d

环境变量配置

数据持久化

通过以下卷挂载实现数据持久化：

• flarum-data：存储用户上传的图片、附件等静态资源。
• flarum-extensions：存储安装的Flarum扩展。
• flarum-mysql-data：存储数据库数据（需配合数据库容器使用）。

访问与初始化

部署完成后，通过FLARUM_URL（如http://localhost:8080）访问论坛，首次访问将引导完成管理员账户创建及基础配置。

维护与更新

• 更新镜像：

  docker-compose pull flarum && docker-compose up -d
  

• 备份数据：备份挂载的卷数据（如flarum-data、flarum-mysql-data）。
• 安装扩展：通过Flarum管理界面或容器内composer require命令安装扩展。