企业官网建设流程全解析

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/mysqlnd：MySQL数据库连接支持
• php-gd：图形处理（用于报表生成等）
• php-curl：HTTP请求（支付网关对接等）
• php-zip：压缩解压（模块安装包处理）
• php-soap：Web服务接口支持
• 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 'doliuser'@'localhost' IDENTIFIED BY 'StrongPassword123!'; GRANT ALL PRIVILEGES ON dolibarr.* TO 'doliuser'@'localhost'; FLUSH PRIVILEGES;

关键参数说明：

• 字符集必须使用utf8mb4以支持完整Unicode（包括emoji）
• 账户权限遵循最小化原则，避免使用root账户
• 密码复杂度建议包含大小写字母、数字和特殊符号组合

3. Dolibarr安装与初始配置

3.1 软件包获取与部署

通过官方稳定版压缩包安装（当前最新版为18.0.3）：

wget 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.conf）：

<VirtualHost *: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 </VirtualHost>

Nginx对应配置要点：

• 需要特别处理PATH_INFO以支持Dolibarr的路由
• 静态文件缓存策略应单独配置
• PHP-FPM进程池建议独立配置资源限制

3.3 安装向导关键步骤

完成上述准备后，通过浏览器访问服务器IP/域名启动安装向导，重点注意：

1. 数据库连接配置：

   • 使用先前创建的dolibarr数据库和专用用户
   • 测试连接成功后勾选"创建表结构"

2. 管理员账户设置：

   • 建议使用企业邮箱作为登录名
   • 密码需符合PCI DSS标准（至少12位复杂组合）

3. 模块选择策略：

   • 初次部署建议仅启用核心模块（Invoices, Products, Third Parties等）
   • 复杂模块如Accounting、HR等可在后期逐步启用

4. 邮件系统配置：

   • 正确设置SMTP参数确保工单通知等功能正常
   • 建议使用SendGrid或Mailgun等专业服务

4. 安全加固与性能优化

4.1 基础安全措施

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

2. 禁用危险PHP函数： 在php.ini中设置：

disable_functions = "exec,passthru,shell_exec,system,proc_open,popen"

3. 安装Fail2Ban防御暴力破解：

sudo apt install fail2ban sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local

4.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 = 100

PHP-FPM优化（/etc/php/8.1/fpm/php.ini）：

memory_limit = 256M max_execution_time = 120 opcache.enable=1 opcache.memory_consumption=128 opcache.max_accelerated_files=10000

5. 外部访问实现方案

5.1 基础端口转发配置

对于临时测试环境，可通过SSH隧道快速建立访问：

ssh -L 8080:localhost:80 youruser@server_ip -N

然后本地浏览器访问http://localhost:8080

5.2 生产级反向代理方案

推荐使用Nginx + Let's Encrypt组合：

1. 安装Certbot工具：

sudo apt install certbot python3-certbot-nginx

2. 获取SSL证书：

sudo certbot --nginx -d erp.yourdomain.com

3. Nginx安全加固配置：

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 -c

6.2 常见问题解决方案

1. 白屏问题排查步骤：

   • 检查conf/conf.php文件权限
   • 查看PHP错误日志（通常位于/var/log/php_errors.log）
   • 临时开启display_errors确认具体错误

2. 邮件发送失败处理：

   • 测试命令行邮件发送：echo "Test" | mail -s "Test" user@example.com
   • 检查Dolibarr邮件模块日志（首页→系统→日志）
   • 验证SMTP端口是否被防火墙阻挡

3. 性能下降分析工具：

   • MySQL慢查询日志：mysqldumpslow /var/log/mysql/mysql-slow.log
   • PHP执行跟踪：安装XHProf扩展
   • 实时监控：glances或htop

7. 扩展功能与进阶配置

7.1 模块管理策略

官方模块仓库包含超过500个扩展模块，建议采用以下管理原则：

1. 生产环境每次只启用一个新增模块并充分测试
2. 模块安装顺序遵循依赖关系（如Payments模块需先安装Invoices）
3. 定期检查模块更新（系统→模块/应用→更新）

高风险模块特别注意事项：

• Accounting模块需要专业财务知识配置
• REST API模块启用后需严格限制访问IP
• Payment网关模块需PCI DSS合规环境

7.2 移动端访问优化

通过PWA技术实现类原生应用体验：

1. 在htdocs/conf/conf.php中添加：

define('MAIN_OPTIMIZEFORTURBOTABLET', '1'); define('MAIN_ENABLE_PWA', '1');

2. 生成manifest.json文件并配置iOS图标
3. 测试Service Worker离线功能

7.3 与企业微信/钉钉集成

通过以下方式实现组织架构同步：

1. 安装LDAP模块并配置连接参数
2. 设置定时同步任务（系统→定时任务）
3. 配置Webhook实现审批流对接

集成过程中的典型问题处理：

• 字段映射冲突时修改extrafields表
• 大规模同步时调整PHP内存限制
• 加密通信需要正确配置SSL证书链

8. 备份与灾备方案

8.1 全量备份策略

推荐采用3-2-1备份原则：

• 3份备份副本
• 2种不同介质（如硬盘+云存储）
• 1份异地备份

具体实现脚本示例：

#!/bin/bash # 数据库备份 mysqldump -u doliuser -p'password' 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 -delete

8.2 增量备份方案

使用rsync进行差异备份：

rsync -avz --delete --link-dest=/backup/last_full /var/www/dolibarr/ /backup/incr_$(date +%F)

8.3 恢复演练要点

1. 定期测试备份有效性（至少每季度一次）
2. 文档化恢复SOP包含：
   • 恢复优先级顺序（先数据库后文件）
   • 各步骤预期耗时
   • 验证检查清单
3. 建立回滚预案（特别是版本升级前）

9. 版本升级最佳实践

9.1 升级前检查清单

1. 确认当前版本与目标版本的兼容性
2. 检查第三方模块的版本要求
3. 备份数据库和代码文件
4. 在测试环境验证升级过程

9.2 安全升级步骤

1. 维护模式准备：

// htdocs/conf/conf.php define('MAIN_ONLY_LOGIN_ALLOWED', 1);

2. 执行升级命令：

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/

3. 运行升级脚本： 访问http://yourserver/admin/upgrade.php

9.3 升级后验证

1. 核心功能冒烟测试：

   • 创建/编辑客户记录
   • 生成并发送发票
   • 库存变动操作

2. 检查系统日志中的异常记录

3. 逐步解除维护模式限制