adamzammit/limesurvey

LimeSurvey

该仓库原位于acspri/limesurvey，请更新记录指向adamzammit/limesurvey（所有现有镜像/标签已迁移，内容保持一致）

重要注意事项（针对4.0.0至5.0.8版本安装）- 潜在数据丢失风险

如果您使用的容器版本在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是全球最流行的免费开源调查工具（[***]

核心功能和特性

• 环境变量配置：支持通过环境变量自定义数据库连接、管理员信息和调试参数
• 自动数据库管理：首次启动时自动创建数据库（需提供数据库用户及密码权限）
• 数据持久化：指定plugins、upload和config目录为持久化卷，确保数据不丢失
• 版本迁移兼容：从acspri/limesurvey平滑迁移，所有镜像/标签保持一致
• 灵活部署：支持链接MySQL容器或外部数据库，兼容标准端口映射

使用场景和适用范围

• 个人或组织快速部署LimeSurvey进行在线调查
• 开发、测试和生产环境中LimeSurvey的标准化部署
• 需要持久化调查数据、插件和配置的场景

使用方法和配置说明

基本使用

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

环境变量

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

• LIMESURVEY_DB_HOST：数据库主机（默认：链接的mysql容器IP和端口）
• LIMESURVEY_DB_USER：数据库用户（默认："root"）
• LIMESURVEY_DB_PASSWORD：数据库密码（默认：链接的mysql容器的MYSQL_ROOT_PASSWORD值）
• LIMESURVEY_DB_NAME：数据库名（默认："limesurvey"）
• LIMESURVEY_TABLE_PREFIX：数据库表前缀（默认：空，例如可设为"lime_"）
• LIMESURVEY_ADMIN_USER：管理员用户名（默认：空）
• LIMESURVEY_ADMIN_PASSWORD：管理员密码（默认：空）
• LIMESURVEY_ADMIN_NAME：管理员全名（默认："Lime Administrator"）
• LIMESURVEY_ADMIN_EMAIL：管理员***（默认："***"）
• LIMESURVEY_DEBUG：调试级别（默认：0，0=关闭，1=错误，2=严格PHP模式并允许编辑模板）
• LIMESURVEY_SQL_DEBUG：SQL调试级别（默认：0，1=开启，需LIMESURVEY_DEBUG=2）
• LIMESURVEY_USE_INNODB：是否使用InnoDB（默认：空，设任意值启用，部分云服务商必需）
• LIMESURVEY_USE_DB_SESSIONS：是否使用数据库会话（默认：空，设任意值启用）
• MYSQL_SSL_CA：MySQL SSL CA路径（基于/var/www/html，不设置则禁用SSL；安全说明：默认关闭服务器证书验证以兼容）
• TZ：时区名称，配置PHP和LimeSurvey时区

若LIMESURVEY_DB_NAME不存在且LIMESURVEY_DB_USER有创建权限，容器会自动创建数据库。

端口映射

通过端口映射从主机访问容器：

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

访问地址：http://localhost:8080 或 http://主机IP:8080

外部数据库配置

连接外部数据库（非链接容器）：

console
$ docker run --name some-limesurvey -e LIMESURVEY_DB_HOST=10.1.2.3:3306 \
    -e LIMESURVEY_DB_USER=... -e LIMESURVEY_DB_PASSWORD=... -d adamzammit/limesurvey

卷和持久化

5.0.8.1及更高版本定义3个持久化卷：

1. /var/www/html/plugins：已安装插件
2. /var/www/html/upload：主题、调查资源和上传响应数据
3. /var/www/html/application/config：配置文件和加密响应的security.php

使用docker-compose

示例docker-compose.yml：

yaml
version: '2'

services:
  limesurvey:
    image: adamzammit/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: lime@lime.lime
    volumes:
      - ./plugins:/var/www/html/plugins
      - ./upload:/var/www/html/upload
      - ./config:/var/www/html/application/config

  mysql:
    image: mariadb
    environment:
      MYSQL_ROOT_PASSWORD: example

运行docker-compose up，初始化完成后访问http://localhost:8082或http://主机IP:8082

支持的Docker版本

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

备注

本Dockerfile基于https://github.com/docker-library/wordpress/tree/8ab70dd61a996d58c0addf4867a768efe649bf65/php5.6/apache%E6%9E%84%E5%BB%BA