MonicaHQ Docker 项目常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00803/article/details/144626513

MonicaHQ Docker 项目常见问题解决方案

docker docker image of Monica 项目地址: https://gitcode.com/gh_mirrors/docker25/docker

项目基础介绍

MonicaHQ 是一个开源的个人关系管理系统（CRM），旨在帮助用户管理与朋友、家人和同事的关系。该项目提供了一个基于 Docker 的镜像，使得用户可以轻松地在本地或云端部署 MonicaHQ。主要的编程语言包括 PHP 和 JavaScript，项目依赖于 MySQL/MariaDB 数据库。

新手使用注意事项及解决方案

1. Docker 和 Docker Compose 的安装问题

问题描述：
新手在使用 MonicaHQ Docker 镜像时，可能会遇到 Docker 或 Docker Compose 未正确安装的问题，导致无法启动容器。

解决步骤：

检查 Docker 安装：
确保 Docker 已正确安装在系统中。可以通过运行以下命令检查 Docker 版本：
```
docker --version
```
如果未安装，请参考 Docker 官方文档进行安装。
检查 Docker Compose 安装：
确保 Docker Compose 已正确安装。可以通过运行以下命令检查 Docker Compose 版本：
```
docker-compose --version
```
如果未安装，请参考 Docker Compose 官方文档进行安装。
启动 Docker 服务：
确保 Docker 服务已启动。可以通过运行以下命令启动 Docker 服务：
```
sudo systemctl start docker
```

2. 数据库连接问题

问题描述：
新手在启动 MonicaHQ Docker 容器时，可能会遇到数据库连接失败的问题，导致应用无法正常运行。

解决步骤：

检查数据库容器是否启动：
确保 MariaDB 或 MySQL 容器已成功启动。可以通过运行以下命令查看容器状态：
```
docker ps
```
如果数据库容器未启动，请检查 Docker Compose 文件中的配置。
检查数据库环境变量：
确保在启动 MonicaHQ 容器时，正确传递了数据库连接的环境变量（如 DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD）。
验证数据库连接：
可以通过运行以下命令手动连接到数据库，验证连接是否正常：
```
docker exec -it <数据库容器ID> mysql -u <用户名> -p<密码>
```

3. 持久化数据存储问题

问题描述：
新手在使用 MonicaHQ Docker 镜像时，可能会遇到数据未持久化的问题，导致容器重启后数据丢失。

解决步骤：

创建 Docker 卷：
在启动容器时，使用 Docker 卷来持久化数据。可以通过以下命令创建卷：
```
docker volume create monica_data
```
挂载卷到容器：
在启动 MonicaHQ 容器时，将卷挂载到 /var/www/html/storage 目录。可以通过以下命令实现：
```
docker run -d -v monica_data:/var/www/html/storage monica
```
验证数据持久化：
在容器重启后，检查 /var/www/html/storage 目录中的数据是否仍然存在。