# Dolibarr ERP/CRM Docker部署指南

本指南将帮助您使用Docker Compose快速部署Dolibarr ERP/CRM系统。

## 功能特点

- 使用官方Dolibarr Docker镜像
- 集成MariaDB数据库
- 数据持久化存储
- 可自定义配置

## 系统要求

- Docker 18.06.0+ 
- Docker Compose 1.22.0+

## 部署步骤

### 1. 克隆或下载配置文件

确保您已经在`dolibarr`目录下有`docker-compose.yml`文件。

### 2. 启动服务

在`dolibarr`目录下执行以下命令：

```bash
docker-compose up -d
```

这将启动两个容器：
- `dolibarr`：Dolibarr ERP/CRM应用
- `dolibarr_db`：MariaDB数据库

### 3. 访问Dolibarr

启动完成后，通过以下地址访问Dolibarr：

```
http://localhost:8080
```

### 4. 完成安装

首次访问时，您需要完成Dolibarr的安装配置：

1. 选择您的语言并点击"开始安装"
2. 检查系统需求（应该都是绿色的）
3. 数据库配置：
   - 数据库类型：MySQL
   - 数据库服务器：db
   - 数据库名称：dolibarr
   - 数据库用户：dolibarr
   - 数据库密码：dolibarr_password
4. 点击"测试连接"并确认连接成功
5. 完成剩余的安装步骤

## 配置说明

### 环境变量

在`docker-compose.yml`文件中，您可以修改以下环境变量：

- `DOLI_ADMIN_LOGIN`：Dolibarr管理员用户名（默认：admin）
- `DOLI_ADMIN_PASSWORD`：Dolibarr管理员密码（默认：admin_password）
- `DOLI_URL_ROOT`：Dolibarr访问URL（默认：http://localhost:8080）
- `MYSQL_ROOT_PASSWORD`：MariaDB root用户密码（默认：root_password）
- `MYSQL_DATABASE`：数据库名称（默认：dolibarr）
- `MYSQL_USER`：数据库用户名（默认：dolibarr）
- `MYSQL_PASSWORD`：数据库密码（默认：dolibarr_password）

### 端口映射

默认将Dolibarr的80端口映射到主机的8080端口。您可以通过修改`ports`部分来更改：

```yaml
ports:
  - "您选择的端口:80"
```

### 数据持久化

使用Docker卷来持久化存储数据：
- `dolibarr_html`：存储Dolibarr应用文件
- `dolibarr_documents`：存储Dolibarr文档和上传文件
- `dolibarr_db`：存储MariaDB数据库数据

## 管理命令

### 查看日志

```bash
# 查看Dolibarr日志
docker-compose logs dolibarr

# 查看数据库日志
docker-compose logs db

# 查看所有日志
docker-compose logs
```

### 停止服务

```bash
docker-compose down
```

### 重启服务

```bash
docker-compose restart
```

### 更新服务

```bash
# 拉取最新镜像
docker-compose pull

# 重新启动服务
docker-compose up -d
```

## 安全建议

1. 生产环境中请修改默认密码
2. 考虑使用HTTPS协议访问
3. 定期备份数据卷
4. 限制容器的网络访问

## 常见问题

### Q: 无法访问Dolibarr？
A: 检查容器是否正在运行，端口是否正确映射，以及防火墙设置。

### Q: 忘记管理员密码？
A: 您可以通过修改数据库中的`llx_user`表来重置密码，或者在环境变量中重新设置`DOLI_ADMIN_PASSWORD`并重启容器。

### Q: 如何备份数据？
A: 您可以使用`docker cp`命令将数据卷中的内容复制到本地：

```bash
docker cp dolibarr:/var/www/html ./backup/html
docker cp dolibarr:/var/www/documents ./backup/documents
docker exec dolibarr_db mysqldump -u root -proot_password dolibarr > ./backup/dolibarr.sql
```

## 联系方式

如有问题，请参考[Dolibarr官方文档](https://wiki.dolibarr.org/index.php/Main_Page)或[Docker Hub页面](https://hub.docker.com/r/dolibarr/dolibarr/)。