1. 项目概述Dolibarr ERP/CRM本地部署的价值与场景Dolibarr作为一款开源的企业资源计划ERP和客户关系管理CRM集成系统其模块化架构允许企业根据实际需求灵活启用功能模块。选择本地部署方案意味着将系统完全部署在自有服务器环境与SaaS模式相比这种方案在数据主权、长期成本控制以及定制化开发方面具有独特优势。对于中小型企业和技术团队而言本地部署Dolibarr通常基于以下典型场景存在敏感业务数据需要完全自主管控的金融、医疗等行业机构已有IT基础设施希望最大化利用现有服务器资源的企业需要深度定制开发并与内部其他系统进行API集成的技术团队网络条件受限或对系统响应速度有严格要求的生产环境重要提示虽然本地部署提供了更高的控制权但也意味着需要自行承担系统维护、安全更新和灾难恢复等责任。建议部署前评估团队的技术运维能力。2. 环境准备与基础组件安装2.1 服务器基础环境配置推荐使用Ubuntu 22.04 LTS或CentOS Stream 9作为宿主系统这两种发行版都能获得长期支持且软件包兼容性良好。以下是必须安装的核心组件及其作用说明# Ubuntu/Debian系 sudo apt update sudo apt install -y apache2 mariadb-server php \ php-mysql php-gd php-curl php-zip php-xml php-mbstring php-bcmath \ php-intl php-soap php-ldap php-imagick # CentOS/RHEL系 sudo dnf install -y httpd mariadb-server php php-mysqlnd php-gd \ php-curl php-zip php-xml php-mbstring php-bcmath php-intl \ php-soap php-ldap php-pecl-imagick每个PHP扩展模块的具体功能php-mysql/mysqlndMySQL数据库连接支持php-gd图形处理用于报表生成等php-curlHTTP请求支付网关对接等php-zip压缩解压模块安装包处理php-soapWeb服务接口支持php-ldap目录服务集成2.2 数据库初始化配置执行MySQL安全加固并创建专用数据库实例sudo mysql_secure_installation mysql -u root -p CREATE DATABASE dolibarr CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER doliuserlocalhost IDENTIFIED BY StrongPassword123!; GRANT ALL PRIVILEGES ON dolibarr.* TO doliuserlocalhost; FLUSH PRIVILEGES;关键参数说明字符集必须使用utf8mb4以支持完整Unicode包括emoji账户权限遵循最小化原则避免使用root账户密码复杂度建议包含大小写字母、数字和特殊符号组合3. Dolibarr安装与初始配置3.1 软件包获取与部署通过官方稳定版压缩包安装当前最新版为18.0.3wget https://files.dolibarr.org/files/stable/18.0.3/dolibarr-18.0.3.zip unzip dolibarr-18.0.3.zip -d /var/www/ sudo chown -R www-data:www-data /var/www/dolibarr sudo chmod -R 755 /var/www/dolibarr/htdocs/conf目录权限设置要点conf目录需要Web服务器可写用于保存配置documents目录需要完全可写文件存储其他目录应限制为只读执行3.2 Web服务器虚拟主机配置Apache示例配置/etc/apache2/sites-available/dolibarr.confVirtualHost *:80 ServerName erp.yourdomain.com DocumentRoot /var/www/dolibarr/htdocs Directory /var/www/dolibarr/htdocs Options FollowSymLinks AllowOverride All Require all granted /Directory ErrorLog ${APACHE_LOG_DIR}/dolibarr_error.log CustomLog ${APACHE_LOG_DIR}/dolibarr_access.log combined /VirtualHostNginx对应配置要点需要特别处理PATH_INFO以支持Dolibarr的路由静态文件缓存策略应单独配置PHP-FPM进程池建议独立配置资源限制3.3 安装向导关键步骤完成上述准备后通过浏览器访问服务器IP/域名启动安装向导重点注意数据库连接配置使用先前创建的dolibarr数据库和专用用户测试连接成功后勾选创建表结构管理员账户设置建议使用企业邮箱作为登录名密码需符合PCI DSS标准至少12位复杂组合模块选择策略初次部署建议仅启用核心模块Invoices, Products, Third Parties等复杂模块如Accounting、HR等可在后期逐步启用邮件系统配置正确设置SMTP参数确保工单通知等功能正常建议使用SendGrid或Mailgun等专业服务4. 安全加固与性能优化4.1 基础安全措施文件权限修正find /var/www/dolibarr/htdocs -type f -exec chmod 644 {} \; find /var/www/dolibarr/htdocs -type d -exec chmod 755 {} \; chmod 600 /var/www/dolibarr/htdocs/conf/conf.php禁用危险PHP函数 在php.ini中设置disable_functions exec,passthru,shell_exec,system,proc_open,popen安装Fail2Ban防御暴力破解sudo apt install fail2ban sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local4.2 性能调优参数MySQL配置优化/etc/mysql/my.cnf[mysqld] innodb_buffer_pool_size 1G # 建议物理内存的50-70% innodb_log_file_size 256M query_cache_size 64M thread_cache_size 8 max_connections 100PHP-FPM优化/etc/php/8.1/fpm/php.inimemory_limit 256M max_execution_time 120 opcache.enable1 opcache.memory_consumption128 opcache.max_accelerated_files100005. 外部访问实现方案5.1 基础端口转发配置对于临时测试环境可通过SSH隧道快速建立访问ssh -L 8080:localhost:80 youruserserver_ip -N然后本地浏览器访问http://localhost:80805.2 生产级反向代理方案推荐使用Nginx Lets Encrypt组合安装Certbot工具sudo apt install certbot python3-certbot-nginx获取SSL证书sudo certbot --nginx -d erp.yourdomain.comNginx安全加固配置server { listen 443 ssl http2; server_name erp.yourdomain.com; ssl_certificate /etc/letsencrypt/live/erp.yourdomain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/erp.yourdomain.com/privkey.pem; # 强化TLS配置 ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384...; ssl_prefer_server_ciphers on; ssl_session_cache shared:SSL:10m; ssl_session_timeout 24h; location / { proxy_pass http://localhost:80; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # 静态资源缓存 location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 30d; add_header Cache-Control public, no-transform; } }5.3 防火墙规则配置UFW基础规则集sudo ufw allow 22/tcp # SSH sudo ufw allow 80/tcp # HTTP sudo ufw allow 443/tcp # HTTPS sudo ufw enable进阶防护建议启用Cloudflare等CDN服务隐藏真实IP配置GeoIP限制只允许本国IP访问设置API接口的速率限制6. 运维管理与故障排查6.1 日常维护命令数据库备份与恢复# 备份 mysqldump -u doliuser -p dolibarr | gzip dolibarr_backup_$(date %F).sql.gz # 恢复 gunzip dolibarr_backup_2023-08-15.sql.gz | mysql -u doliuser -p dolibarr日志监控关键命令# 实时监控Apache错误日志 tail -f /var/log/apache2/dolibarr_error.log # 检查最近登录情况 grep dolibarr\.org /var/log/apache2/dolibarr_access.log | awk {print $1} | sort | uniq -c6.2 常见问题解决方案白屏问题排查步骤检查conf/conf.php文件权限查看PHP错误日志通常位于/var/log/php_errors.log临时开启display_errors确认具体错误邮件发送失败处理测试命令行邮件发送echo Test | mail -s Test userexample.com检查Dolibarr邮件模块日志首页→系统→日志验证SMTP端口是否被防火墙阻挡性能下降分析工具MySQL慢查询日志mysqldumpslow /var/log/mysql/mysql-slow.logPHP执行跟踪安装XHProf扩展实时监控glances或htop7. 扩展功能与进阶配置7.1 模块管理策略官方模块仓库包含超过500个扩展模块建议采用以下管理原则生产环境每次只启用一个新增模块并充分测试模块安装顺序遵循依赖关系如Payments模块需先安装Invoices定期检查模块更新系统→模块/应用→更新高风险模块特别注意事项Accounting模块需要专业财务知识配置REST API模块启用后需严格限制访问IPPayment网关模块需PCI DSS合规环境7.2 移动端访问优化通过PWA技术实现类原生应用体验在htdocs/conf/conf.php中添加define(MAIN_OPTIMIZEFORTURBOTABLET, 1); define(MAIN_ENABLE_PWA, 1);生成manifest.json文件并配置iOS图标测试Service Worker离线功能7.3 与企业微信/钉钉集成通过以下方式实现组织架构同步安装LDAP模块并配置连接参数设置定时同步任务系统→定时任务配置Webhook实现审批流对接集成过程中的典型问题处理字段映射冲突时修改extrafields表大规模同步时调整PHP内存限制加密通信需要正确配置SSL证书链8. 备份与灾备方案8.1 全量备份策略推荐采用3-2-1备份原则3份备份副本2种不同介质如硬盘云存储1份异地备份具体实现脚本示例#!/bin/bash # 数据库备份 mysqldump -u doliuser -ppassword dolibarr | gzip /backup/db_$(date %F).sql.gz # 文件备份 tar -czf /backup/files_$(date %F).tar.gz /var/www/dolibarr # 同步到S3 aws s3 cp /backup/db_$(date %F).sql.gz s3://your-bucket/ aws s3 cp /backup/files_$(date %F).tar.gz s3://your-bucket/ # 保留最近7天 find /backup -type f -mtime 7 -delete8.2 增量备份方案使用rsync进行差异备份rsync -avz --delete --link-dest/backup/last_full /var/www/dolibarr/ /backup/incr_$(date %F)8.3 恢复演练要点定期测试备份有效性至少每季度一次文档化恢复SOP包含恢复优先级顺序先数据库后文件各步骤预期耗时验证检查清单建立回滚预案特别是版本升级前9. 版本升级最佳实践9.1 升级前检查清单确认当前版本与目标版本的兼容性检查第三方模块的版本要求备份数据库和代码文件在测试环境验证升级过程9.2 安全升级步骤维护模式准备// htdocs/conf/conf.php define(MAIN_ONLY_LOGIN_ALLOWED, 1);执行升级命令wget https://files.dolibarr.org/files/stable/19.0.0/dolibarr-19.0.0.zip unzip dolibarr-19.0.0.zip -d /tmp rsync -av /tmp/dolibarr-19.0.0/htdocs/ /var/www/dolibarr/htdocs/运行升级脚本 访问http://yourserver/admin/upgrade.php9.3 升级后验证核心功能冒烟测试创建/编辑客户记录生成并发送发票库存变动操作检查系统日志中的异常记录逐步解除维护模式限制