20251209

dolibarr/README.md

@@ -0,0 +1,151 @@
+# 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/)。