Monica 是一款开源的个人关系管理（PRM）工具

Monica 详细简介
Monica 是一款开源的个人关系管理（PRM）工具，用于管理联系人、互动记录和重要日期，类似轻量级 CRM。

特点  

• 联系人管理

• 互动记录跟踪

• 任务和提醒

• 日记功能

• 数据导出/导入

• 多用户支持

• API 访问

最新更新内容及时间  

• 最新版本：v4.0.0（2023年10月发布）

• 更新内容：UI 重构、性能优化、新 API 端点、改进的任务管理。

镜像下载地址  

• Docker Hub: docker pull monicahq/monicahq

• GitHub Releases: https://github.com/monicahq/monica/releases

官网地址
https://monicahq.com  

文档地址
https://docs.monicahq.com  

Docker 安装示例  

docker run -d \
  --name monica \
  -p 8080:80 \
  -v monica_data:/var/www/html/storage \
  -e DB_HOST=db \
  -e DB_DATABASE=monica \
  -e DB_USERNAME=monica \
  -e DB_PASSWORD=secret \
  monicahq/monicahq

YAML 设置教程（示例 docker-compose.yml）  

version: '3'
services:
  monica:
    image: monicahq/monicahq
    ports:
      - "8080:80"
    volumes:
      - monica_data:/var/www/html/storage
    environment:
      - DB_HOST=db
      - DB_DATABASE=monica
      - DB_USERNAME=monica
      - DB_PASSWORD=secret
    depends_on:
      - db
  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=monica
      - MYSQL_USER=monica
      - MYSQL_PASSWORD=secret
    volumes:
      - db_data:/var/lib/mysql
volumes:
  monica_data:
  db_data:

常见错误及解决方法  

1. 数据库连接失败

• 确保 DB_HOST、DB_USERNAME 和 DB_PASSWORD 正确。

• 检查 MySQL 容器是否正常运行。

2. 存储权限问题

• 运行 chmod -R 775 storage 确保存储目录可写。

3. 502 Bad Gateway

• 重启容器：docker restart monica。

• 检查 PHP-FPM 日志。

4. 迁移失败

• 清除缓存：php artisan cache:clear。

• 重新运行迁移：php artisan migrate。

5. API 认证失败

• 确认 .env 中 APP_KEY 已生成。

• 检查请求头是否包含有效 Token。