tuxgasy/dolibarr

Dolibarr Docker镜像

Dolibarr的Docker镜像，首次启动时具备自动安装功能。

支持的标签

• 15.0.3-php7.4 15.0.3 15
• 16.0.5-php8.1 16.0.5 16
• 17.0.4-php8.1 17.0.4 17
• 18.0.5-php8.1 18.0.5 18
• 19.0.2-php8.2 19.0.2 19 latest
• develop

不再支持PHP < 7.4

Dolibarr 7、8、9、10、11、12、13、14版本不再更新

支持的架构

Linux x86-64（amd64）、ARMv7 32位（arm32v7 ⚠️ MariaDB/MySQL Docker镜像不支持此架构）和ARMv8 64位（arm64v8）

什么是Dolibarr？

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

https://github.com/dolibarr/dolibarr

如何运行此镜像？

此镜像基于https://registry.hub.docker.com/_/php/%E6%9E%84%E5%BB%BA%E3%80%82

重要：此镜像不包含数据库，需链接数据库容器使用。

建议使用Docker Compose与https://hub.docker.com/_/mariadb/%E9%9B%86%E6%88%90%EF%BC%88%E4%B9%9F%E5%8F%AF%E6%A0%B9%E6%8D%AE%E5%81%8F%E5%A5%BD%E4%BD%BF%E7%94%A8https://hub.docker.com/_/mysql/%EF%BC%89%E3%80%82

创建docker-compose.yml文件如下：

yaml
services:
    mariadb:
        image: mariadb:latest
        environment:
            MYSQL_ROOT_PASSWORD: root
            MYSQL_DATABASE: dolibarr

    web:
        image: tuxgasy/dolibarr
        environment:
            DOLI_DB_HOST: mariadb
            DOLI_DB_USER: root
            DOLI_DB_PASSWORD: root
            DOLI_DB_NAME: dolibarr
            DOLI_URL_ROOT: 'http://0.0.0.0'
            PHP_INI_DATE_TIMEZONE: 'Europe/Paris'
        ports:
            - "80:80"
        links:
            - mariadb

然后运行所有服务：docker-compose up -d。现在可通过 [***] 访问新的Dolibarr安装。

其他示例

examples目录中提供了多个示例，例如：

• 使用MySQL运行Dolibarr
• 使用Traefik反向代理运行Dolibarr
• 使用密钥运行Dolibarr

升级版本和迁移数据库

install.lock文件位于容器卷/var/www/documents中。

删除install.lock文件并启动更新版本的容器。确保环境变量DOLI_INSTALL_AUTO设置为1，将自动迁移数据库至新版本。也可通过Web界面进行标准升级。

PostgreSQL早期支持

将DOLI_DB_TYPE设置为pgsql可启用Dolibarr与PostgreSQL数据库配合使用。使用pgsql时，Dolibarr首次执行需手动安装：

• 访问 http://0.0.0.0/install；
• 按照安装向导操作；
• 在容器卷/var/www/html/documents中添加install.lock（例如：docker-compose exec services-data_dolibarr_1 /bin/bash -c "touch /var/www/html/documents/install.lock"）。

这种设置下，版本升级必须通过Web界面进行：

• 删除install.lock文件（例如：docker-compose exec services-data_dolibarr_1 /bin/bash -c "rm -f /var/www/html/documents/install.lock"）；
• 访问 http://0.0.0.0/install；
• 升级数据库；
• 在容器卷/var/www/html/documents中添加install.lock（例如：docker-compose exec services-data_dolibarr_1 /bin/bash -c "touch /var/www/html/documents/install.lock"）。

环境变量摘要

部分环境变量支持Docker密钥功能，只需添加_FILE后缀并指向读取值的文件。支持Docker密钥的环境变量：

• DOLI_DB_USER => DOLI_DB_USER_FILE
• DOLI_DB_PASSWORD => DOLI_DB_PASSWORD_FILE
• DOLI_ADMIN_LOGIN => DOLI_ADMIN_LOGIN_FILE
• DOLI_ADMIN_PASSWORD => DOLI_ADMIN_PASSWORD_FILE
• DOLI_CRON_KEY => DOLI_CRON_KEY_FILE
• DOLI_CRON_USER => DOLI_CRON_USER_FILE
• DOLI_INSTANCE_UNIQUE_ID => DOLI_INSTANCE_UNIQUE_ID_FILE

添加部署后和启动前脚本

可通过挂载卷在部署结束或Apache启动前执行*.sh、*.sql和/或*.php自定义文件。部署期间执行的脚本挂载至/var/www/scripts/docker-init.d，Apache启动前执行的脚本挂载至/var/www/scripts/before-starting.d。

\docker-init.d
|- custom_script.sql
|- custom_script.php
|- custom_script.sh

在Compose文件中挂载卷：

yaml
services:
    mariadb:
        image: mariadb:latest
        environment:
            MYSQL_ROOT_PASSWORD: root
            MYSQL_DATABASE: dolibarr

    web:
        image: tuxgasy/dolibarr
        environment:
            DOLI_DB_HOST: mariadb
            DOLI_DB_USER: root
            DOLI_DB_PASSWORD: root
            DOLI_DB_NAME: dolibarr
            DOLI_URL_ROOT: '[***]
            PHP_INI_DATE_TIMEZONE: 'Europe/Paris'
        volumes :
          - volume-scripts:/var/www/scripts/docker-init.d
          - before-starting-scripts:/var/www/scripts/before-starting.d
        ports:
            - "80:80"
        links:
            - mariadb