secobau/docker-xwiki

XWiki Docker镜像说明

镜像概述

本镜像基于Debian系统构建，提供生产级的XWiki企业wiki平台部署方案。XWiki是Java编写的开源wiki软件，强调可扩展性，支持多数据库（MySQL、PostgreSQL）集成，适用于企业内部知识库、团队协作及文档管理场景。

核心功能

• 富文本编辑：WYSIWYG编辑器支持直观文档创作；
• 结构化数据：自定义数据结构并存储于数据库，支持HQL/XWiki查询语言检索；
• 脚本扩展：内置Velocity、Groovy等多语言脚本宏，可直接在wiki页面编写逻辑；
• 权限管理：细粒度的用户/组权限控制；
• 文档互操作：支持OpenDocument格式导入/导出；
• 扩展生态：通过XWiki扩展库获取丰富插件（代码片段、核心模块等）。

使用场景

• 企业内部知识库建设；
• 团队协作文档共享平台；
• 产品文档管理系统；
• 项目需求与方案协作空间。

配置说明

数据库配置

支持MySQL和PostgreSQL，需提前启动对应数据库容器并配置环境变量（DB_USER、DB_PASSWORD、DB_HOST等）。

外部Solr集成

通过INDEX_HOST和INDEX_PORT环境变量配置远程Solr服务，提升搜索性能（适用于大规模wiki场景）。

Tomcat配置

可挂载Tomcat配置目录（/usr/local/tomcat/conf）自定义反向代理、端口等设置。

部署示例

Docker Run（MySQL）

1. 创建网络：
   docker network create -d bridge xwiki-nw
2. 启动MySQL容器：

   bash
   docker run --net=xwiki-nw --name mysql-xwiki \
     -v /my/path/mysql:/var/lib/mysql \
     -v /my/path/mysql-init:/docker-entrypoint-initdb.d \
     -e MYSQL_ROOT_PASSWORD=xwiki -e MYSQL_USER=xwiki -e MYSQL_PASSWORD=xwiki -e MYSQL_DATABASE=xwiki \
     -d mysql:5.7 --character-set-server=utf8mb4 --collation-server=utf8mb4_bin
   

3. 启动XWiki容器：

   bash
   docker run --net=xwiki-nw --name xwiki -p 8080:8080 \
     -v /my/path/xwiki:/usr/local/xwiki \
     -e DB_USER=xwiki -e DB_PASSWORD=xwiki -e DB_DATABASE=xwiki -e DB_HOST=mysql-xwiki \
     xwiki:lts-mysql-tomcat
   

Docker Compose（PostgreSQL）

yaml
version: '2'
networks:
  bridge:
    driver: bridge
services:
  web:
    image: "xwiki:lts-postgres-tomcat"
    container_name: xwiki-web
    depends_on: [db]
    ports: [8080:8080]
    environment:
      - DB_USER=xwiki
      - DB_PASSWORD=xwiki
      - DB_HOST=xwiki-db
    volumes: [xwiki-data:/usr/local/xwiki]
    networks: [bridge]
  db:
    image: "postgres:9.5"
    container_name: xwiki-db
    volumes: [postgres-data:/var/lib/postgresql/data]
    environment:
      - POSTGRES_ROOT_PASSWORD=xwiki
      - POSTGRES_USER=xwiki
      - POSTGRES_PASSWORD=xwiki
      - POSTGRES_DB=xwiki
      - POSTGRES_INITDB_ARGS="--encoding=UTF8"
    networks: [bridge]
volumes:
  postgres-data: {}
  xwiki-data: {}