Monica Docker 镜像文档

镜像概述和主要用途

Monica 是一款开源的个人关系管理系统，用于组织和管理您与亲友的互动信息。本 Docker 镜像提供了 Monica 应用的便捷部署方式，支持多种架构，适合个人或小型团队使用。

注意：此仓库是 mips64le 架构的 "per-architecture" 仓库。mips64le 架构不支持此镜像。有关更多信息，请参见镜像文档中的 "除 amd64 之外的架构？" 和镜像 FAQ 中的 "Git 中镜像的源代码已更改，现在该怎么办？"。

核心功能和特性

• 个人关系管理系统，用于跟踪与联系人的互动
• 支持多种部署模式：Apache 集成版和 FPM 版
• 基于 Laravel 框架构建，提供强大的后端功能
• 可通过环境变量灵活配置
• 支持外部数据库和持久化存储
• 轻量级设计，易于部署和维护

使用场景和适用范围

• 个人用户管理亲友关系和互动记录
• 小型组织维护客户或会员关系
• 需要隐私保护的个人数据管理
• 希望自托管关系管理系统的用户

详细的使用方法和配置说明

支持的架构

• amd64
• arm32v5
• arm32v6
• arm32v7
• arm64v8
• i386
• ppc64le
• riscv64
• s390x

快速参考

• 维护者：Monica 团队
• 获取帮助：Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 提交问题：[***]
• 镜像更新：official-images repo's library/monica 标签
• 描述来源：docs repo's monica/ 目录

镜像版本

提供两种版本的镜像：

• apache：包含完整的 Monica 安装和 Apache Web 服务器，也是默认的 latest 标签
• fpm：仅包含 FastCGI 进程，需要配合外部 Web 服务器（如 Apache 或 Nginx）使用

快速开始

使用 Apache 版本

Apache 版本包含内置 Web 服务器，暴露 80 端口：

console
docker run --name some-monica -d -p 8080:80 mips64le/monica

使用 FPM 版本

FPM 版本提供 FastCGI 服务，暴露 9000 端口，需要配合外部 Web 服务器：

console
docker run --name some-monica -d -p 9000:9000 mips64le/monica:fpm

Docker Compose 部署方案

Apache 版本（带 MySQL）

此配置使用 Apache 镜像并添加 MySQL 容器，设置了持久化卷以保留数据。

1. 创建 compose.yaml 文件：

yaml
services:
  app:
    image: monica
    depends_on:
      - db
    ports:
      - 8080:80
    environment:
      - APP_KEY= # 使用 `echo -n 'base64:'; openssl rand -base64 32` 生成
      - DB_HOST=db
      - DB_USERNAME=monica
      - DB_PASSWORD=secret
      - APP_ENV=production
    volumes:
      - monica_data:/var/www/html/storage
    restart: always

  db:
    image: mariadb:11
    environment:
      - MYSQL_RANDOM_ROOT_PASSWORD=true
      - MYSQL_DATABASE=monica
      - MYSQL_USER=monica
      - MYSQL_PASSWORD=secret
    volumes:
      - mysql_data:/var/lib/mysql
    restart: always

volumes:
  monica_data:
  mysql_data:

2. 生成并设置 APP_KEY：

console
echo -n 'base64:'; openssl rand -base64 32

3. 启动服务：

console
docker compose up -d

4. 执行初始化命令：

console
docker compose exec app php artisan setup:production

5. 通过 http://localhost:8080 访问 Monica

FPM 版本（带 Nginx 和 MySQL）

FPM 版本需要额外的 Web 服务器。以下示例使用 Nginx：

1. 创建 Nginx 配置：

console
mkdir web
curl -sSL [***] -o web/nginx.conf
curl -sSL [***] -o web/Dockerfile

2. 创建 compose.yaml 文件：

yaml
services:
  app:
    image: monica:fpm
    depends_on:
      - db
    environment:
      - APP_KEY= # 使用 `echo -n 'base64:'; openssl rand -base64 32` 生成
      - DB_HOST=db
      - DB_USERNAME=monica
      - DB_PASSWORD=secret
      - APP_ENV=production
    volumes:
      - monica_data:/var/www/html/storage
    restart: always

  web:
    build: ./web
    ports:
      - 8080:80
    depends_on:
      - app
    volumes:
      - monica_data:/var/www/html/storage:ro
    restart: always

  db:
    image: mariadb:11
    environment:
      - MYSQL_RANDOM_ROOT_PASSWORD=true
      - MYSQL_DATABASE=monica
      - MYSQL_USER=monica
      - MYSQL_PASSWORD=secret
    volumes:
      - mysql_data:/var/lib/mysql
    restart: always

volumes:
  monica_data:
  mysql_data:

3. 构建并启动服务：

console
docker compose build
docker compose up -d

4. 执行初始化命令：

console
docker compose exec app php artisan setup:production

配置参数和环境变量

Monica 镜像使用环境变量进行配置，常见的环境变量包括：

更多环境变量可参考 Monica 文档。

持久化数据存储

为确保数据持久化，需要挂载 /var/www/html/storage 目录：

console
docker run -d \
        -v monica_data:/var/www/html/storage \
        mips64le/monica

或在 Docker Compose 中定义命名卷：

yaml
volumes:
  monica_data:
    name: monica_data

在容器内运行命令

Monica 是基于 Laravel 的应用，php artisan 命令非常有用。在容器内运行命令：

console
docker exec CONTAINER_ID php artisan COMMAND

使用 Docker Compose：

console
docker compose exec monica php artisan COMMAND

常用命令：

• php artisan setup:production - 生产环境初始化
• php artisan migrate - 数据库迁移
• php artisan db:seed - 填充数据库
• php artisan cache:clear - 清除缓存

从互联网访问 Monica

要将 Monica 实例暴露到互联网，需设置环境变量 APP_ENV=production，此时强制使用 HTTPS。推荐使用反向代理（如 Nginx 或 Traefik）处理 SSL 终止。

更多配置示例可参考 示例部分。

许可证

查看 许可信息 了解此镜像中包含的软件许可。

与所有 Docker 镜像一样，此镜像可能还包含其他软件，这些软件可能具有其他许可（如基础发行版中的 Bash 等）。使用前应确保您对所有软件的使用符合相关许可要求。