knsit/bluespice

BlueSpice Docker镜像

该容器镜像用于在Docker环境中部署BlueSpice wiki系统，基于公开的MediaWiki容器构建，支持通过环境变量和卷实现灵活配置与持久化。

核心功能

1. 持久化配置：通过/config卷保存wiki核心配置文件LocalSettings.php，避免容器重启丢失配置。
2. 插件扩展：通过/extensions卷添加第三方插件，扩展wiki功能。
3. 自动初始化：通过环境变量自动生成配置文件，完成数据库连接、管理员账号等初始化操作。
4. 自动迁移：启动时自动执行数据库迁移，适配版本更新或插件新增需求。

使用场景

• 企业内部知识管理平台搭建
• 团队项目文档协作系统
• 开源社区或组织的公共wiki部署

配置说明

卷说明

容器预定义以下卷：

• /config：存储wiki核心配置文件LocalSettings.php，建议持久化挂载。
• /extensions：存放第三方扩展插件，可选挂载。

环境变量

启动步骤

容器启动时执行以下流程：

1. 检查/config卷中是否存在LocalSettings.php。
2. 若不存在，通过环境变量生成配置文件并持久化。
3. 验证配置文件存在性，缺失则退出。
4. 确保配置文件包含BlueSpice导入语句。
5. 复制配置文件到web目录。
6. 复制扩展插件到web目录（若有）。
7. 执行数据库迁移。
8. 修复文件权限，确保web服务器可访问。
9. 启动Apache2服务。

Docker部署示例

独立容器（依赖外部MySQL）

yaml
version: '2.3'
services:
  bluespice:
    image: 'docker.xuanyuan.run/knsit/bluespice:latest'
    volumes:
      - ./config:/config
      - ./extensions:/extensions
    environment:
      - "WIKI_URL=http://localhost:8081"
      - "WIKI_NAME=企业知识库"
      - "DB_USER=bluespice"
      - "DB_PASS=your_db_password"
      - "DB_NAME=bluespice"
      - "DB_SERVER=mysql"
      - "ADMIN_LOGIN=admin"
      - "ADMIN_PASS=your_admin_password"
    ports:
      - 8081:80

注意：外部数据库需提前创建bluespice数据库及对应账号。

包含MySQL的完整部署

yaml
version: '2.3'
services:
  bluespice:
    image: 'docker.xuanyuan.run/knsit/bluespice:latest'
    volumes:
      - ./config:/config
      - ./extensions:/extensions
    environment:
      - "WIKI_URL=http://localhost:8081"
      - "WIKI_NAME=团队协作wiki"
      - "DB_USER=bluespice"
      - "DB_PASS=bluespice"
      - "DB_NAME=bluespice"
      - "DB_SERVER=mysql"
      - "ADMIN_LOGIN=admin"
      - "ADMIN_PASS=bluespice"
    ports:
      - 8081:80
    depends_on:
      mysql:
        condition: service_healthy
  
  mysql:
    image: docker.xuanyuan.run/mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=bluespice
      - MYSQL_USER=bluespice
      - MYSQL_PASSWORD=bluespice
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      timeout: 20s
      retries: 10

该配置自动创建MySQL数据库，无需提前手动设置。