中文

应用程序

通过 apt 安装 Dolibarr(.deb 软件包)

在 Ubuntu/Debian VPS 或专用服务器上通过 apt 和官方 .deb 软件包安装 Dolibarr ERP/CRM 的指南。Apache、MySQL/MariaDB、PHP 与配置向导。

阅读约 6 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在 Ubuntu 或 Debian 服务器上使用 apt 和官方 .deb 软件包(DoliDeb)安装 Dolibarr ERP/CRM。此方法让 apt 自动解析依赖项(Apache、MySQL/MariaDB、PHP),并在安装过程中提供配置向导。

订购服务器

为托管您的 Dolibarr 实例,HostMyServers 提供多种合适的方案:

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • Ubuntu 24.04 LTS 或 Debian 12 64 位系统
  • x64 处理器
  • 最低 1 GB 内存(建议 Dolibarr + 数据库使用 2 GB)
  • 约 5 GB 可用磁盘空间(建议 SSD)
  • 可访问端口 80(HTTPS 需要 443)

所需配置

组件 最低 建议
内存 1 GB 2-4 GB
CPU 1 核 2 核
存储 5 GB SSD 20 GB SSD
网络 100 Mbps 1 Gbps

连接到服务器

开始前请确保已连接到服务器。根据您的环境:

使用用户名和 IP 连接(默认端口)

如果服务器使用标准 SSH 端口(22):

终端
ssh 用户@服务器_ip_地址
  • 用户:服务器登录名
  • 服务器_ip_地址:分配给服务器的 IP 地址

使用自定义端口连接

如果服务器使用非 22 的 SSH 端口:

终端
ssh -p 端口号 用户@服务器_ip_地址

使用 PEM 密钥连接

如果需要 PEM 密钥认证:

终端
ssh -i /密钥/路径/your-key.pem 用户@服务器_ip_地址

选择适合您配置的方法。连接后即可继续安装。

更新系统

安装 Dolibarr 前请先更新服务器:

终端
sudo apt-get update
sudo apt-get upgrade -y

下载官方 .deb 软件包

从官方 Dolibarr 仓库获取 Debian/Ubuntu 软件包。撰写本文时最新稳定版本为 Dolibarr 23.0.3。

终端
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_23.0.3-4_all.deb

通过 apt 安装

使用 apt install 安装软件包,并在路径前加上 ./。与 dpkg -i 不同,apt 会自动解析并安装依赖项(Apache、MariaDB/MySQL、PHP 及扩展):

终端
sudo apt install ./dolibarr_23.0.3-4_all.deb

配置向导

安装过程中会出现 debconf 向导并提出若干问题。使用方向键、空格键勾选,Tab/Enter 确认。

问题 建议回答
要自动重新配置的 Web 服务器 勾选 apache2
使用 dbconfig-common 配置数据库? 是
数据库管理用户密码(MySQL/MariaDB root) 输入 / 确认一个强密码
dolibarr 数据库的应用密码 输入专用于 Dolibarr 的密码

如果安装因缺少依赖而中断,请修复后重新运行配置:

终端
sudo apt-get install -f -y
sudo dpkg-reconfigure dolibarr

访问 Web 界面

安装完成后,打开浏览器并访问:

文本
http://服务器_ip_或域名/dolibarr/

首次访问时,Dolibarr 会在浏览器中启动安装向导:

  1. 环境检查(PHP、扩展、写入权限)
  2. 数据库连接参数(由 dbconfig-common 预填充)
  3. 创建 Dolibarr 管理员账户(登录名和密码)
  4. 完成安装并进入仪表盘

防火墙配置

如果 UFW 已启用,请开放 Web 端口:

终端
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

使用 HTTPS 保护访问

在生产环境中,请使用 SSL 证书保护 Dolibarr 的访问。在 Apache 下最简单的方法是 Certbot / Let's Encrypt:

终端
sudo apt-get install -y certbot python3-certbot-apache
sudo certbot --apache -d 您的域名.com

Certbot 会自动配置 Apache 虚拟主机以及 HTTP → HTTPS 重定向。

常用命令

命令 说明
sudo systemctl restart apache2 重启 Web 服务器
sudo systemctl status apache2 Apache 状态
sudo systemctl status mariadb 数据库状态
sudo dpkg-reconfigure dolibarr 重新运行配置向导
sudo tail -f /var/log/apache2/error.log 跟踪 Apache/PHP 错误

文件结构

路径 说明
/usr/share/dolibarr/htdocs/ 应用程序源代码
/etc/dolibarr/conf.php 主配置文件
/etc/dolibarr/install.forced.php 安装时强制的参数
/var/lib/dolibarr/documents/ 文档、生成的 PDF、备份及 install.lock 文件
/var/log/apache2/error.log Web 服务器错误日志

更新 Dolibarr

要升级到更新版本,请下载新的 .deb 软件包并覆盖安装现有版本——apt 会处理迁移:

终端
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_新版本_all.deb
sudo apt install ./dolibarr_新版本_all.deb

更新后首次登录时,Dolibarr 可能会要求运行数据库迁移向导。请按照提示的步骤操作。

故障排除

运行 apt install dolibarr 时出现「Package not found」

  • 该软件包已不在仓库中:请按上文所述使用官方 .deb 文件。
  • 确保为名称加上 ./ 前缀或绝对路径。

安装时出现依赖错误

  • 修复依赖项:sudo apt-get install -f -y
  • 然后重新运行配置:sudo dpkg-reconfigure dolibarr

无法访问 /dolibarr/

  • 检查 Apache 是否运行:sudo systemctl status apache2
  • 检查 PHP 模块是否启用:sudo apachectl -M | grep php
  • 查看日志:sudo tail -f /var/log/apache2/error.log

数据库连接错误

  • 检查 MariaDB/MySQL 是否运行:sudo systemctl status mariadb
  • 核对 /etc/dolibarr/conf.php 中的凭据
  • 测试连接:mysql -u root -p -e "SHOW DATABASES;"

安装向导不再出现

  • 如果 install.lock 文件存在,向导已被锁定(正常行为)。若要有意重新运行:sudo rm /var/lib/dolibarr/documents/install.lock(请在充分了解后再删除)。

参考资料