sneaky/egroupware-extended

egroupware-extended Docker镜像文档

1. 概述

1.1 基本信息

该Dockerfile构建了一个EGroupware容器，并集成了自定义应用。基于作者的EGroupware基础镜像构建，使用官方源代码。使用时需配合MySQL或MariaDB容器作为数据库。当前已支持MySQL 8.0。

1.2 EGroupware

EGroupware是一款功能强大的开源群件程序，包含日历、联系人、信息日志、项目管理、票务系统等组件。更多信息请访问[***]

1.3 已安装的自定义应用

ROSInE（Rothaar Systems Open Source Invoice for EGroupware）

最新版本的ROSInE是一款用于创建发票、订单、报价单和交货单的应用，集成EGroupware地址簿。支持基本多客户端功能（每个用户可拥有独立公司信息），易于配置，采用HTML5和CSS3开发。如需特殊模板和PHP文件，可联系作者获取支持。

其他应用

更多应用将在后续添加。

2. 安装与配置

a) 使用辅助脚本

推荐使用container_control.sh脚本进行容器的启动、停止和更新操作，可从https://github.com/sneakyx/egroupwareserver_extended/blob/master/assets/container_control.sh%E4%B8%8B%E8%BD%BD%E3%80%82

b) 手动安装（不推荐）

若需手动操作，需执行以下步骤（以sudo权限运行）：

变量说明

• $2: 存放所有EGroupware容器数据的路径
• $3: MySQL root用户密码
• $4: EGroupware数据库用户密码
• $5: 外部访问端口
• $6: 子文件夹（可选）

操作脚本

bash
# 创建文件夹
mkdir -p /home/egroupware/$2/mysql /home/egroupware/$2/data/default/backup /home/egroupware/$2/data/default/files
touch /home/egroupware/$2/data/header.inc.php
chown -R www-data:www-data /home/egroupware/$2/data
chmod 0700 /home/egroupware/$2/data/header.inc.php

# 配置MySQL（解决MySQL 8.0兼容性问题）
if [ ! -f "/home/egroupware/$2/mysql.cnf" ]; then
    touch /home/egroupware/$2/mysql.cnf
    echo -e "[mysqld]\ndefault_authentication_plugin= mysql_native_password" > /home/egroupware/$2/mysql.cnf
fi

# 创建并运行MySQL容器
docker run -d --name mysql-egroupware-$2 \
    -e MYSQL_ROOT_PASSWORD=$3 \
    -e MYSQL_DATABASE=egroupware \
    -e MYSQL_USER=egroupware \
    -e MYSQL_PASSWORD=$4 \
    -v /home/egroupware/$2/mysql:/var/lib/mysql \
    -v /home/egroupware/$2/mysql.cnf:/etc/mysql/conf.d/egroupware.cnf \
    docker.xuanyuan.run/mysql

# 创建并运行EGroupware容器
docker run -d \
    --name egroupware-$2 \
    -p $5:80 \
    -v /home/egroupware/$2/data:/var/lib/egroupware \
    --link mysql-egroupware-$2:mysql \
    -e SUBFOLDER=$6 \
    docker.xuanyuan.run/sneaky/egroupware-extended

echo "容器已创建/更新"

3. 初始化设置

3.1 EGroupware设置

a) 首次登录

首次启动镜像后，通过以下URL登录：

• http://服务器IP:4321/
• 或 http://服务器IP:4321/egroupware（取决于子文件夹变量配置）

安装过程已自动化，无需手动输入数据库信息（通过修改class.setup_header.inc.php和class.setup_process.inc.php实现）。系统会自动导入已有的EGroupware数据库备份。

b) 使用现有数据库和数据

若header.inc.php文件已存在（表示之前安装过），docker-entrypoint.sh会自动更新该文件中的数据库主机IP和端口。

升级EGroupware版本后，需通过以下URL启动设置并更新数据库： http://服务器IP:4321/egroupware/setup

3.2 ROSInE设置

登录EGroupware后，需为用户激活ROSInE权限。激活后，点击左侧ROSInE按钮即可使用。首次启动或数据目录变更时，模板文件夹会自动激活，点击"Click here"完成初始化。

4. 补充信息

• 密码安全：将默认密码"***"修改为自定义密码。
• 数据持久化：需将以下目录外部挂载，避免镜像更新后数据丢失：
  • EGroupware文件夹
  • MySQL数据库文件
  • ROSInE模板
• 容器重启：若通过docker stop xxx停止容器后使用docker start xxx重启，需执行以下命令更新MySQL IP地址：

  bash
  docker exec -it xxx /bin/docker-entrypoint.sh update
  

5. 挂载Samba文件夹

1. 登录Docker容器：

   bash
   docker exec -it egroupware-xxx /bin/bash
   

2. 创建挂载点：

   bash
   filemanager/cli.php mount --user root_admin --password 123456 'smb://Workgroup\$user:$pass@服务器地址/路径' '/文件管理器中的挂载路径'
   

https://images.microbadger.com/badges/image/sneaky/egroupware-extended.svg](http://microbadger.com/images/sneaky/egroupware-extended "Get your own image badge on microbadger.com")