monogramm/docker-dolibarr

Docker上的Dolibarr

Dolibarr的Docker镜像。

提供完整的数据库配置、生产模式、HTTPS强制（SSL必须由反向代理提供）、处理升级等功能。

什么是Dolibarr

Dolibarr ERP & CRM是一个现代化的软件包，用于管理组织的活动（联系人、供应商、发票、订单、库存、日程等）。

https://github.com/dolibarr/dolibarr

支持的标签及对应的Dockerfile链接

https://hub.docker.com/r/monogramm/docker-dolibarr/

• Dolibarr develop分支（:construction: 可能不稳定）

  • develop: /images/develop/php7.3-apache

• Dolibarr 13

  • 13.0-apache apache latest: /images/13.0/php7.3-apache
  • 13.0-fpm fpm: /images/13.0/php7.3-fpm
  • 13.0-alpine alpine: /images/13.0/php7.3-alpine

• Dolibarr 12

  • 12.0-apache: /images/12.0/php7.3-apache
  • 12.0-fpm: /images/12.0/php7.3-fpm
  • 12.0-alpine: /images/12.0/php7.3-alpine

• Dolibarr 11

  • 11.0-apache: /images/11.0/php7.3-apache
  • 11.0-fpm: /images/11.0/php7.3-fpm
  • 11.0-alpine: /images/11.0/php7.3-alpine

• Dolibarr 10

  • 10.0-apache: /images/10.0/php7.3-apache
  • 10.0-fpm: /images/10.0/php7.3-fpm
  • 10.0-alpine: /images/10.0/php7.3-alpine

如何运行此镜像

此镜像基于https://registry.hub.docker.com/_/php/构建，灵感来源于https://github.com/nextcloud/docker和https://github.com/tuxgasy/docker-dolibarr。

此镜像不包含Dolibarr的数据库，您需要使用现有数据库或数据库容器。

此镜像设计用于微服务环境，提供两种版本供选择：

apache标签包含完整的Dolibarr安装，包括Apache Web服务器，易于使用且能快速运行，也是latest标签和未指定进一步说明的版本标签的默认选择。

第二种选择是fpm容器，基于https://hub.docker.com/_/php/镜像，运行FastCGI进程来提供Dolibarr页面。使用此镜像时，必须结合能将HTTP请求代理到容器FastCGI端口的Web服务器。

使用apache镜像

apache镜像包含Web服务器并暴露80端口。启动容器的命令如下：

shell
$ docker run -d -e DOLI_AUTO_CONFIGURE='' -p 8080:80 monogramm/docker-dolibarr

现在您可以从主机系统通过http://localhost:8080/访问Dolibarr。

使用fpm镜像

使用fpm镜像需要额外的Web服务器，该服务器能将HTTP请求代理到容器的fpm端口。对于fpm连接，此容器暴露9000端口。在大多数情况下，您可能希望使用另一个容器或主机作为代理。如果使用主机，可以直接通过9000端口访问Dolibarr容器；如果使用另一个容器，确保它们添加到同一Docker网络（通过docker run --network <NAME> ...或docker-compose文件）。在这两种情况下，都不需要将fpm端口映射到主机。

shell
$ docker run -d -e DOLI_AUTO_CONFIGURE='' monogramm/docker-dolibarr:fpm

由于FastCGI进程无法提供静态文件（样式表、图像等），Web服务器需要访问这些文件。这可以通过volumes-from选项实现，更多信息见docker-compose部分。

使用外部数据库

默认情况下，此容器不包含Dolibarr的数据库，您需要使用现有数据库或数据库容器。

Dolibarr设置向导（首次运行时出现）允许连接到现有MySQL/MariaDB或PostgreSQL数据库。您也可以链接数据库容器，例如--link my-mysql:mysql，然后在设置时使用mysql作为数据库主机。更多信息见docker-compose部分。

持久化数据

Dolibarr安装和所有数据库之外的数据（文件上传等）存储在https://docs.docker.com/engine/tutorials/dockervolumes/#adding-a-data-volume /var/www/html和/var/www/documents中。Docker守护进程会将这些数据存储在Docker目录/var/lib/docker/volumes/...中。这意味着即使容器崩溃、停止或删除，您的数据也会保存。

为使数据在升级时持久化并便于备份，可使用命名Docker卷或挂载主机文件夹。为此，您需要为数据库容器和Dolibarr各使用一个卷。

Dolibarr：

• /var/www/html/：所有Dolibarr数据所在的文件夹
• /var/www/documents/：所有Dolibarr文档所在的文件夹

shell
$ docker run -d \
    -v dolibarr_html:/var/www/html \
    -v dolibarr_docs:/var/www/documents \
    -e DOLI_AUTO_CONFIGURE='' \
    monogramm/docker-dolibarr

数据库：

• /var/lib/mysql：MySQL/MariaDB数据
• /var/lib/postgresql/data：PostgreSQL数据

shell
$ docker run -d \
    -v db:/var/lib/mysql \
    mariadb \
    --character_set_client=utf8 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --character-set-client-handshake=FALSE

如果需要细粒度访问各个文件，可以为配置、主题和自定义模块挂载额外卷。conf存储在/var/www/html/内的子文件夹中，模块分为核心apps（随Dolibarr一起提供，无需处理）和custom文件夹。如果使用自定义主题，它将位于theme子文件夹中。

可挂载为卷的文件夹概述：

• /var/www/html：主文件夹，更新时需要
• /var/www/html/custom：已安装/修改的模块
• /var/www/html/conf：本地配置
• /var/www/html/theme/<YOUR_CUSTOM_THEME>：主题/品牌

如果要为所有这些使用命名卷，命令如下：

shell
$ docker run -d \
    -v dolibarr:/var/www/html \
    -v apps:/var/www/html/custom \
    -v config:/var/www/html/conf \
    -v theme:/var/www/html/theme/<YOUR_CUSTOM_THEME> \
    -e DOLI_AUTO_CONFIGURE='' \
    monogramm/docker-dolibarr

通过环境变量自动配置

Dolibarr镜像支持通过环境变量自动配置，几乎可以预配置首次运行时安装页面上要求的所有内容。要启用自动配置，通过以下环境变量设置数据库连接。仅使用一种数据库类型！

有关安装配置的更多详细信息，请参见https://github.com/Dolibarr/dolibarr/blob/develop/htdocs/conf/conf.php.example和https://github.com/Dolibarr/dolibarr/blob/develop/htdocs/install/install.forced.sample.php。

DOLI_AUTO_CONFIGURE

默认值：1

可能值：1，''

此参数触发基于环境变量生成Dolibarr默认配置。

示例：

properties
    DOLI_AUTO_CONFIGURE=1
    DOLI_AUTO_CONFIGURE=''

DOLI_DB_TYPE

默认值：mysqli

可能值：mysqli，pgsql

此参数包含用于访问Dolibarr数据库的驱动程序名称。

示例：

properties
    DOLI_DB_TYPE=mysqli
    DOLI_DB_TYPE=pgsql

DOLI_DB_HOST

默认值：

此参数包含Dolibarr数据库服务器的主机名或IP地址。

示例：

properties
    DOLI_DB_HOST=localhost
    DOLI_DB_HOST=127.0.2.1
    DOLI_DB_HOST=192.168.0.10
    DOLI_DB_HOST=mysql.myserver.com

DOLI_DB_PORT

默认值：3306

此参数包含Dolibarr数据库的端口。

示例：

properties
    DOLI_DB_PORT=3306
    DOLI_DB_PORT=5432

DOLI_DB_NAME

默认值：dolibarr

此参数包含Dolibarr数据库的名称。

示例：

properties
    DOLI_DB_NAME=dolibarr
    DOLI_DB_NAME=mydatabase

DOLI_DB_USER

默认值：dolibarr

此参数包含用于读写Dolibarr数据库的用户名。

示例：

properties
    DOLI_DB_USER=admin
    DOLI_DB_USER=dolibarruser

DOLI_DB_PASSWORD

默认值：

此参数包含用于读写Dolibarr数据库的密码。

示例：

properties
    DOLI_DB_PASSWORD=myadminpass
    DOLI_DB_PASSWORD=myuserpassword

DOLI_DB_PREFIX

默认值：llx_

此参数包含Dolibarr数据库的前缀。

示例：

properties
    DOLI_DB_PREFIX=llx_

DOLI_DB_CHARACTER_SET

默认值：utf8

用于存储数据的数据库字符集（在数据库创建期间强制设置，然后使用数据库的值）。取决于所使用的数据库驱动程序，参见DOLI_DB_TYPE。

示例：

properties
    DOLI_DB_CHARACTER_SET=utf8

DOLI_DB_COLLATION

默认值：utf8_unicode_ci

用于排序数据的数据库排序规则（在数据库创建期间强制设置，然后使用数据库的值）。取决于所使用的数据库驱动程序，参见DOLI_DB_TYPE。

示例：

properties
    DOLI_DB_COLLATION=utf8_unicode_ci

DOLI_DB_ROOT_LOGIN

默认值：

此参数包含用于创建Dolibarr数据库的数据库服务器root用户名。

如果设置此参数，容器将在首次安装时自动告诉Dolibarr使用root账户创建数据库。

示例：

properties
    DOLI_DB_ROOT_LOGIN=root
    DOLI_DB_ROOT_LOGIN=dolibarruser

DOLI_DB_ROOT_PASSWORD

默认值：

此参数包含用于创建Dolibarr数据库的数据库服务器root密码。

示例：

properties
    DOLI_DB_ROOT_PASSWORD=myrootpass

DOLI_ADMIN_LOGIN

默认值：admin

此参数包含首次安装时使用的管理员登录名。

示例：

properties
    DOLI_ADMIN_LOGIN=admin

DOLI_MODULES

默认值：

此参数包含首次安装时要启用的模块列表（逗号分隔）。

示例：

properties
    DOLI_MODULES=modSociete
    DOLI_MODULES=modSociete,modPropale,modFournisseur,modContrat,modLdap

DOLI_URL_ROOT

默认值：http://localhost

此参数定义Dolibarr index.php页面的根URL，不带结尾的“/”。它必须链接到htdocs目录。在大多数情况下，这是自动检测的，但仍需要：

• 为某些服务显示完整的URL书签（例如：日程RSS导出URL等）
• 或使用Apache目录别名时（自动检测失败）
• 或使用nginx时（自动检测失败）

示例：

properties
    DOLI_URL_ROOT=http://localhost
    DOLI_URL_ROOT=http://mydolibarrvirtualhost
    DOLI_URL_ROOT=http://myserver/dolibarr/htdocs
    DOLI_URL_ROOT=http://myserver/dolibarralias

DOLI_AUTH

默认值：dolibarr

可能值：在htdocs/core/login目录中的文件中，function_字符串之后和.php字符串之前的任何值，除forceuser外。您也可以使用逗号分隔多个值，在这种情况下，Dolibarr将按值定义的顺序检查每个值的登录/密码。但请注意，并非所有值都能正常工作。

此参数包含身份验证方式。如果使用首次安装向导，将不使用此参数。有关更多详细信息，请参见“首次使用”。

如果使用ldap值，还必须设置DOLI_LDAP_*参数，且DOLI_MODULES必须包含modLdap。

示例：

properties
    DOLI_AUTH=http
    DOLI_AUTH=dolibarr
    DOLI_AUTH=ldap
    DOLI_AUTH=openid,dolibarr

DOLI_LDAP_HOST

默认值：

您可以在此处用逗号分隔定义多个服务器。

示例：

properties
    DOLI_LDAP_HOST=localhost
    DOLI_LDAP_HOST=ldap.company.com
    DOLI_LDAP_HOST=ldaps://ldap.company.com:636,ldap://ldap.company.com:389

DOLI_LDAP_PORT

默认值：389

DOLI_LDAP_VERSION

默认值：3

DOLI_LDAP_SERVERTYPE

默认值：openldap 可能值：openldap，activedirectory或egroupware

DOLI_LDAP_DN

默认值：

示例：

properties
    DOLI_LDAP_DN=ou=People,dc=company,dc=com

DOLI_LDAP_LOGIN_ATTRIBUTE

默认值：uid

例如：对于Active Directory，为uid或samaccountname

DOLI_LDAP_FILTER

默认值：

如果已定义，则不使用前两个参数在LDAP中查找用户。

示例：

properties
    DOLI_LDAP_FILTER=(uid=%1%)
    DOLI_LDAP_FILTER=(&(uid=%1%)(isMemberOf=cn=Sales,ou=Groups,dc=company,dc=com))

DOLI_LDAP_ADMIN_LOGIN

默认值：

仅在禁用***绑定时需要。

示例：

properties
    DOLI_LDAP_ADMIN_LOGIN=cn=admin,dc=company,dc=com

DOLI_LDAP_ADMIN_PASS

默认值：

仅在禁用***绑定时需要。例如：

示例：

properties
    DOLI_LDAP_ADMIN_PASS=secret

DOLI_LDAP_DEBUG

默认值：false

DOLI_PROD

默认值：0

可能值：0或1

定义此参数时，所有错误消息都不会报告。此功能用于生产环境，以避免向黑客提供任何信息。

示例：

properties
    DOLI_PROD=0
    DOLI_PROD=1

DOLI_HTTPS

默认值：0

可能值：0，1，2或https://my.domain.com

此参数允许强制