acspri/limesurvey

LimeSurvey Docker 镜像使用说明

重要注意事项（数据备份提醒）

适用于 4.0.0 至 5.0.8 版本的安装（5.0.8.1 及以上新版本已修复此问题）——可能存在数据丢失风险

如果您正在使用此容器的 4.0.0 至 5.0.8 版本，且用户在 LimeSurvey 中加密了数据，请务必在更新镜像前备份 /var/www/html/application/config/security.php 文件。

以下是操作示例（假设容器名称为 some-limesurvey）：

console
$ docker cp some-limesurvey:/var/www/html/application/config/security.php /tmp/security.php

更新至 5.0.8.1 或更高版本后，再将文件复制回去：

console
$ docker cp /tmp/security.php some-limesurvey:/var/www/html/application/config/security.php 

5.0.8.1 及更高版本会自动持久化 config 目录。

LimeSurvey 简介

LimeSurvey 是目前网络上最流行的免费开源调查工具（官网：[***]

本 Docker 镜像基于 Apache/PHP 环境构建，可独立运行。支持通过环境变量配置参数，首次启动时会自动创建数据库（需提供数据库用户名和密码），后续运行时若提供环境变量，可更新管理员密码。同时，镜像为插件和上传目录配置了持久化卷，确保数据不丢失。

镜像标签说明

• latest：跟踪 LimeSurvey 最新稳定版（[***]
• lts：跟踪 LimeSurvey LTS 长期支持版（[***]
• development：跟踪 LimeSurvey 开发版（[***]

如何使用本镜像

基本运行命令

console
$ docker run --name some-limesurvey --link some-mysql:mysql -d acspri/limesurvey

环境变量配置

以下环境变量用于配置 LimeSurvey 实例，若已完成安装，这些变量会自动更新配置文件：

注意：若指定的 LIMESURVEY_DB_NAME 数据库不存在，且 LIMESURVEY_DB_USER 有创建权限，容器启动时会自动创建该数据库。

端口映射（访问主机）

若需从主机直接访问容器（无需容器 IP），可通过端口映射：

console
$ docker run --name some-limesurvey --link some-mysql:mysql -p 8080:80 -d acspri/limesurvey

之后通过浏览器访问 [***] 或 [***]

连接外部数据库

若使用外部数据库（非链接的 mysql 容器），需通过 LIMESURVEY_DB_HOST 指定主机和端口，同时设置用户名和密码：

console
$ docker run --name some-limesurvey -e LIMESURVEY_DB_HOST=10.1.2.3:3306 \
    -e LIMESURVEY_DB_USER=数据库用户名 -e LIMESURVEY_DB_PASSWORD=数据库密码 -d acspri/limesurvey

卷和持久化（5.0.8.1 及以上版本）

Dockerfile 定义了 3 个持久化卷，确保数据不丢失：

1. /var/www/html/plugins：已安装的 LimeSurvey 插件
2. /var/www/html/upload：自定义主题、调查资源、上传的问卷数据
3. /var/www/html/application/config：配置文件（含 security.php）

docker-compose 示例

通过 docker-compose.yml 快速部署（需提前安装 docker-compose）：

yaml
version: '2'

services:
  limesurvey:
    image: acspri/limesurvey
    ports:
      - 8082:80  # 主机端口:容器端口
    environment:
      LIMESURVEY_DB_PASSWORD: example  # 数据库密码
      LIMESURVEY_ADMIN_USER: admin     # 管理员用户名
      LIMESURVEY_ADMIN_PASSWORD: password  # 管理员密码
      LIMESURVEY_ADMIN_NAME: Lime Administrator  # 管理员全名
      LIMESURVEY_ADMIN_EMAIL: [邮箱已删除]     # 管理员邮箱
    volumes:
      - ./plugins:/var/www/html/plugins      # 插件卷（主机目录:容器目录）
      - ./upload:/var/www/html/upload        # 上传目录卷
      - ./config:/var/www/html/application/config  # 配置文件卷

  mysql:
    image: mariadb  # 使用 MariaDB 作为数据库
    environment:
      MYSQL_ROOT_PASSWORD: example  # 数据库 root 密码（需与上方 LIMESURVEY_DB_PASSWORD 一致）

运行命令：docker-compose up，待初始化完成后访问 [***] 或 [***]

支持的 Docker 版本

本镜像官方支持 Docker 1.12.3 版本，对 1.6 及以上旧版本提供尽力支持。
升级 Docker 可参考 Docker 官方安装文档。

备注

本 Dockerfile 基于 Wordpress 官方 Docker 镜像 修改。