xalt/confluence

Atlassian Confluence Docker 镜像文档

1. 镜像概述和主要用途

本镜像基于Atlassian Confluence，提供快速部署Confluence协作平台的Docker化解决方案。Confluence是 Atlassian 推出的企业级团队协作与知识管理工具，支持文档创作、团队协作、项目管理等功能。本镜像简化了Confluence的部署流程，支持持久化存储、数据库集成、反向代理、集群配置等生产级特性，适用于开发环境快速验证和生产环境稳定运行。

2. 核心功能和特性

• 快速部署：通过简单命令或Docker Compose快速启动Confluence实例
• 持久化存储：支持数据卷挂载，确保配置和用户数据持久化
• 多数据库支持：兼容PostgreSQL、MySQL等主流数据库
• 反向代理集成：支持jwilder/nginx-proxy实现域名访问和端口映射
• 资源配置：可自定义JVM内存参数（最小/最大堆内存）
• 远程调试：支持开启Java远程调试功能
• 时区配置：支持自定义容器时区
• 备份恢复：启动时可从远程服务器恢复备份数据
• 集群支持：通过环境变量配置Confluence集群节点
• 自定义模板：支持替换Confluence内置模板文件
• 数据库变更管理：集成Liquibase工具，支持独立于Confluence的数据库变更
• SSL/HTTPS支持：通过环境变量配置HTTPS和反向代理参数

3. 使用场景和适用范围

• 开发/测试环境：快速搭建临时Confluence实例，验证功能或进行集成测试
• 生产环境：通过持久化存储、数据库连接和反向代理配置，实现稳定运行
• 集群部署：配置集群节点名称，实现多节点协同工作
• 数据库变更管理：使用Liquibase调整数据库结构、更新应用链接或配置外部服务（如Crowd、Miniorange）
• 定制化需求：替换登录页面、错误页面等模板文件，满足企业品牌化需求

4. 使用方法和配置说明

4.1 基本运行

通过以下命令快速启动Confluence实例（非持久化，适用于测试）：

bash
docker run -d -p 8090:8090 xalt/confluence

访问地址：http://[Docker主机IP]:8090（若使用macOS旧版boot2docker，需通过boot2docker ip获取主机IP）

4.2 集成Nginx反向代理

使用jwilder/nginx-proxy实现域名访问，需先启动Nginx代理容器，再启动Confluence：

bash
# 启动Nginx代理（参考jwilder/nginx-proxy文档）
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro jwilder/nginx-proxy

# 启动Confluence并绑定域名
docker run -d -e VIRTUAL_HOST=confluence.yourdomain.tld -e VIRTUAL_PORT=8090 xalt/confluence

4.3 持久化存储与数据库连接

4.3.1 连接PostgreSQL数据库

bash
# 启动PostgreSQL容器
docker run --name mypgdb -p 5432:5432 \
  -e POSTGRES_USER=confluence \
  -e POSTGRES_PASSWORD=yourpassword \
  -e POSTGRES_DB=confluencedb \
  -d xalt/postgres

# 启动Confluence（持久化存储+连接PostgreSQL）
docker run --name myconf \
  -v /opt/docker/confluence:/var/atlassian/confluence \  # 持久化数据目录
  --link mypgdb:pgdb \  # 链接数据库容器
  -d \
  -e RAM_MIN=2048 \  # JVM最小内存（MB）
  -e RAM_MAX=4096 \  # JVM最大内存（MB）
  -e VIRTUAL_HOST=confluence.yourdomain.tld \  # 绑定域名（若使用Nginx）
  -p 8090:8090 \
  xalt/confluence

4.3.2 连接MySQL数据库（Docker Compose示例）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  confluence:
    image: xalt/confluence
    volumes:
      - /data/confluence:/var/atlassian/confluence  # 持久化数据目录
    links:
      - mysql:db  # 链接MySQL容器
    environment:
      - VIRTUAL_HOST=confluence.yourdomain.tld  # Nginx反向代理域名
      - VIRTUAL_PORT=8090  # 代理端口
      - RAM_MIN=2048  # JVM最小内存（MB）
      - RAM_MAX=8192  # JVM最大内存（MB）
      - HTTPS=true  # 启用HTTPS
      - PROXY_NAME=confluence.yourdomain.tld  # 代理服务器名称（写入server.xml）
      # NewRelic监控配置（可选）
      - NEWRELIC_LICENSE=your_newrelic_license
      - NEWRELIC_APP_NAME=Confluence-Production
      - NEWRELIC=true
    restart: always

  mysql:
    image: mysql:5.6
    volumes:
      - /data/mysql/conf:/etc/mysql/conf.d  # 自定义MySQL配置
      - /data/mysqlconfluence:/var/lib/mysql  # 持久化MySQL数据
    environment:
      - MYSQL_ROOT_PASSWORD=strong_root_password
      - MYSQL_DATABASE=confluence
      - MYSQL_USER=confluence
      - MYSQL_PASSWORD=strong_confluence_password
    restart: always

启动服务：

bash
docker-compose up -d

4.4 远程调试配置

启用Java远程调试（调试端口5005）：

bash
docker run -p 8090:8090 -p 5005:5005 \
  -e CONF_REMOTE_DEBUG=true \
  -e RAM_MIN=2048 \
  -e RAM_MAX=4096 \
  -d xalt/confluence

5. 配置参数详解

5.1 基础配置

5.2 备份与恢复

启动时从远程服务器恢复备份，需设置以下变量：

注意：恢复后会自动在CONF_HOME或CONF_HOME_SHARED目录创建DONTSYNC文件，防止重复恢复。

5.3 集群配置

通过JAVA_OPTS设置集群节点名称，启用共享目录：

bash
docker run -e JAVA_OPTS="-Dcluster.node.name=node-1" ... xalt/confluence

此时Confluence会使用CONF_HOME_SHARED作为数据目录（默认使用CONF_HOME）。

5.4 证书导入

导入自定义证书至Java信任库：

5.5 Liquibase数据库变更管理

通过Liquibase实现数据库独立变更，需设置LIQUIBASE=true，支持以下功能：

5.5.1 基础配置

5.5.2 应用链接与Crowd配置

5.5.3 横幅配置

设置Confluence登录横幅：

5.6 自定义模板

替换Confluence内置模板文件（如登录页面、错误页面）：

1. 挂载自定义模板目录至容器/var/atlassian/confluence/custom_templates；
2. 设置环境变量启用自定义模板：

yaml
volumes:
  - ./custom_templates:/var/atlassian/confluence/custom_templates
environment:
  - CUSTOM_TEMPLATES_ENABLED=true
  - "CUSTOM_TEMPLATES_FILES=/opt/atlassian/confluence/confluence/login.vm|\
     /opt/atlassian/confluence/confluence/errors/notfound.vm"

说明：CUSTOM_TEMPLATES_FILES为模板文件路径列表，用|分隔，需与容器内Confluence文件结构一致。

6. 高级配置：Liquibase与Miniorange集成

通过Liquibase配置Miniorange身份提供商：

7. 注意事项

• 数据备份：生产环境需定期备份/var/atlassian/confluence目录和数据库数据。
• 权限设置：数据卷挂载目录需确保容器内用户（通常为atlassian）有读写权限。
• 版本兼容性：数据库版本需符合Confluence官方要求（如MySQL 5.6+，PostgreSQL 12+等）。
• 资源配置：根据用户规模调整RAM_MIN和RAM_MAX，建议生产环境至少8GB内存。