Skip to main content

通过 apt 安装 Dolibarr（.deb 软件包）

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

Dolibarr 已不在标准仓库中

自 Ubuntu 18.04 起，dolibarr 软件包已不再包含在官方 Ubuntu/Debian 仓库中。因此在较新版本上运行 apt install dolibarr 会返回「找不到软件包」错误。目前推荐的方法是获取 Dolibarr 项目发布的官方 .deb 软件包，并用 apt 安装，由 apt 处理依赖项。

订购服务器​

为托管您的 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 GB2-4 GB
CPU1 核2 核
存储5 GB SSD20 GB SSD
网络100 Mbps1 Gbps
软件栈

Dolibarr 依赖 LAMP 栈：Web 服务器（建议 Apache）、数据库（MySQL / MariaDB）和 PHP。.deb 软件包会通过 apt 为您安装并配置这些组件。

连接到服务器​

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

使用用户名和 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
必须使用路径

./ 前缀（或绝对路径，如 /tmp/dolibarr_23.0.3-4_all.deb）是必需的：否则 apt 会在仓库中查找名为「dolibarr」的软件包并失败。

配置向导​

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

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

请妥善保存数据库 root 密码和 dolibarr 数据库的应用密码：维护或排障时需要用到。

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

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

访问 Web 界面​

安装完成后，打开浏览器并访问：

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

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

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

向导结束时，Dolibarr 会创建锁定文件 install.lock 以防止重复运行。检查其是否存在以保护访问安全：

ls -l /var/lib/dolibarr/documents/install.lock

防火墙配置​

如果 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 重定向。

域名

Let's Encrypt 证书需要一个指向服务器 IP 的域名。请参阅我们的创建 A 记录指南，将其指向您服务器的 IP。

常用命令​

命令说明
sudo systemctl restart apache2重启 Web 服务器
sudo systemctl status apache2Apache 状态
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.logWeb 服务器错误日志

更新 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 可能会要求运行数据库迁移向导。请按照提示的步骤操作。

更新前备份

在任何更新前，请备份数据库和 /var/lib/dolibarr/documents/ 文件夹：

sudo mysqldump -u root -p dolibarr > /root/dolibarr_backup.sql
sudo tar czf /root/dolibarr_documents.tar.gz /var/lib/dolibarr/documents

故障排除​

运行 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（请在充分了解后再删除）。

参考资料​