upshift/dolibarr

Dolibarr ERP 应用服务器 Docker 镜像文档

镜像概述和主要用途

本镜像为 Dolibarr ERP 提供容器化部署方案。Dolibarr 是一款开源企业资源规划（ERP）和客户关系管理（CRM）软件，适用于中小型企业管理业务流程。本镜像包含完整的数据库配置支持、生产模式、HTTPS 强制（SSL 需由反向代理提供）、自动升级处理等功能，简化 Dolibarr 的部署和运维流程。

核心功能和特性

• 完整数据库支持：兼容 MySQL/MariaDB 和 PostgreSQL，支持通过环境变量自动配置数据库连接
• 生产环境优化：可启用生产模式，隐藏错误信息，提升安全性
• 数据持久化：通过 Docker 卷挂载确保应用数据和文档持久化存储
• 自动升级：启动时自动检测版本差异，执行升级流程
• 灵活认证：支持内置认证、LDAP、OpenID 等多种认证方式
• 配置自动化：通过环境变量预配置安装参数，跳过手动安装向导

使用场景和适用范围

• 中小型企业部署 ERP/CRM 系统
• 需要快速搭建 Dolibarr 测试环境
• 追求容器化部署带来的环境一致性和运维简化
• 需通过反向代理实现 HTTPS 加密的生产环境
• 需要自定义模块、主题或配置的个性化部署

详细使用方法和配置说明

基本使用

本镜像不包含数据库，需配合现有数据库或数据库容器使用。

启动容器命令：

console
docker run -d -p 8080:80 --link my-db:db docker.xuanyuan.run/upshift/dolibarr

访问方式：通过 http://localhost:8080 访问 Dolibarr，默认管理员账户 admin，密码 dolibarr。

数据持久化

Dolibarr 的应用数据和文档存储在以下路径，需通过卷挂载确保持久化：

• /var/www/html：Dolibarr 核心安装目录（含配置、模块等）
• /var/www/documents：文档存储目录

使用命名卷挂载（推荐）

Dolibarr 卷配置：

console
docker run -d \
  -v dolibarr_html:/var/www/html \
  -v dolibarr_docs:/var/www/documents \
  docker.xuanyuan.run/upshift/dolibarr

数据库卷配置（以 MariaDB 为例）：

console
docker run -d \
  -v dolibarr_db:/var/lib/mysql \
  docker.xuanyuan.run/mariadb

高级卷挂载（自定义配置/模块）

可额外挂载以下路径实现细粒度控制：

• /var/www/html/custom：自定义模块目录
• /var/www/html/conf：配置文件目录
• /var/www/html/theme/<YOUR_CUSTOM_THEME>：自定义主题目录

环境变量自动配置

通过环境变量可预配置 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%E3%80%82

数据库配置参数

管理员账户配置

应用配置参数

认证配置（DOLI_AUTH）

LDAP 认证配置（需 DOLI_AUTH=ldap 且 DOLI_MODULES=modLdap）

Docker Compose 部署示例

以下示例使用 MariaDB 数据库，通过命名卷持久化数据，适用于开发或测试环境（无 SSL，建议配合反向代理使用）。

创建 docker-compose.yml 文件：

yml
version: '3'

volumes:
  dolibarr_html:  # 存储 Dolibarr 核心数据
  dolibarr_docs:  # 存储 Dolibarr 文档
  dolibarr_db:    # 存储 MariaDB 数据

services:
  mariadb:
    image: docker.xuanyuan.run/mariadb:latest
    restart: always
    command: --character_set_client=utf8 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
      - dolibarr_db:/var/lib/mysql
    environment:
      - "MYSQL_DATABASE=dolibarr"         # 数据库名
      - "MYSQL_USER=dolibarr"             # 数据库用户
      - "MYSQL_PASSWORD=dolibarr"         # 数据库密码
      - "MYSQL_RANDOM_ROOT_PASSWORD=yes"  # 自动生成 root 密码

  dolibarr:
    image: docker.xuanyuan.run/upshift/dolibarr:latest
    restart: always
    depends_on:
      - mariadb
    ports:
      - "8080:80"  # 主机 8080 端口映射到容器 80 端口
    environment:
      - "DOLI_DB_HOST=mariadb"            # 数据库主机（服务名）
      - "DOLI_DB_NAME=dolibarr"           # 数据库名（与 MariaDB 一致）
      - "DOLI_DB_USER=dolibarr"           # 数据库用户（与 MariaDB 一致）
      - "DOLI_DB_PASSWORD=dolibarr"       # 数据库密码（与 MariaDB 一致）
      - "DOLI_ADMIN_PASSWORD=SecureAdmin123!"  # 自定义管理员密码
      - "DOLI_PROD=1"                     # 启用生产模式
    volumes:
      - dolibarr_html:/var/www/html
      - dolibarr_docs:/var/www/documents

启动服务：

console
docker-compose up -d

访问安装向导：http://localhost:8080/install

首次使用

1. 访问安装向导：首次启动后，通过 http://<主机IP>:8080/install 访问安装向导
2. 配置数据库：使用数据库容器名（如 mariadb）作为主机，输入环境变量中配置的数据库名、用户和密码
3. 跳过手动配置：若已设置环境变量，可直接访问 http://<主机IP>:8080/install/step2.php 使用自动生成的配置

版本更新

Docker 命令方式

console
# 拉取新版本镜像
docker pull docker.xuanyuan.run/upshift/dolibarr
# 停止并删除旧容器（数据保存在卷中）
docker stop <容器ID> && docker rm <容器ID>
# 用原参数启动新容器
docker run <原启动参数> -d upshift/dolibarr

Docker Compose 方式

console
# 拉取新版本镜像
docker-compose pull
# 重启服务（自动使用新镜像）
docker-compose up -d

注意：升级时建议逐步更新（如 5.0 → 6.0 → 7.0），不要跳过主要版本。

从互联网访问（SSL 配置）

生产环境需通过反向代理（如 Nginx、Traefik）实现 HTTPS 加密。推荐方案：

1. 部署反向代理容器，挂载 SSL 证书（手动生成或通过 Let's Encrypt 自动生成）
2. 配置代理规则，将 HTTPS 请求转发至 Dolibarr 容器的 80 端口
3. 在 Dolibarr 环境变量中设置 DOLI_HTTPS=1 或 2 强制 HTTPS 重定向