Monica Docker镜像文档

概述

Monica是一款优秀的开源个人关系管理系统，旨在帮助用户组织与亲友的互动和关系信息。本镜像为arm32v6架构的构建版本，基于官方Monica镜像，提供便捷的Docker部署方式。

!logo

快速参考

• 维护者：
  Monica团队

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应Dockerfile链接

• 4.1.2-fpm-alpine, 4.1-fpm-alpine, 4-fpm-alpine, fpm-alpine

• 5.0.0-beta.5-fpm-alpine, 5.0.0-beta-fpm-alpine, 5.0-fpm-alpine

扩展参考

• 问题反馈：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

• 镜像 artifact 详情：
  repo-info 仓库的 repos/monica/ 目录（历史记录）
  （包含镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/monica 标签
  official-images 仓库的 library/monica 文件（历史记录）

• 本描述的来源：
  docs 仓库的 monica/ 目录（历史记录）

如何使用本镜像

Monica 镜像提供两种版本供选择：

• apache 标签：包含完整的 Monica 安装和 Apache 网络服务器，也是 latest 标签的默认指向。
• fpm 标签：提供 FastCGI 进程以服务网页，需配合反向代理服务器（如 Apache 或 Nginx）使用。

使用 apache 镜像

该镜像包含 Web 服务器，暴露 80 端口。运行容器命令：

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

使用 fpm 镜像

该镜像提供 FastCGI 服务器，暴露 9000 端口，需配合外部 Web 服务器代理请求至 9000 端口。运行容器命令：

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

使用外部数据库

Monica 需外部数据库支持，目前兼容 MySQL/MariaDB。可链接数据库容器（如 --link my-mysql:db），并在设置时使用 db 作为数据库主机。详情见 Docker Compose 部分。

持久化数据存储

为保证数据持久化，需为数据库和 Monica 的 /var/www/html/storage 目录创建卷。使用命名卷运行容器：

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

在容器内执行命令

作为 Laravel 应用，php artisan 命令对 Monica 至关重要。在容器内执行命令：

docker exec CONTAINER_ID php artisan COMMAND

使用 Docker Compose 时：

docker compose exec monica php artisan COMMAND

其中 monica 为 compose.yaml 中的服务名称。

使用环境变量配置

Monica 镜像通过环境变量配置应用。常用变量可参考 Monica 文档。

使用 Docker Compose 运行镜像

Docker Compose 的配置示例可参考 示例目录。

Apache 版本

此版本使用 apache 镜像并添加 MySQL 容器，通过卷实现数据持久化。该配置不提供 SSL 加密，建议运行在反向代理后。

运行前需设置 APP_KEY 变量。

1. 创建 compose.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
    volumes:
      - 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:/var/lib/mysql
    restart: always

volumes:
  data:
    name: data
  mysql:
    name: mysql

2. 生成 APP_KEY：执行 echo -n 'base64:'; openssl rand -base64 32 并复制输出值。

3. 启动服务：

docker compose up -d

等待数据库迁移完成后，通过 http://localhost:8080/ 访问 Monica，创建首个用户账户。

4. 执行初始化命令：

docker compose exec app php artisan setup:production

FPM 版本

使用 FPM 镜像时需额外的 Web 服务器容器代理 HTTP 请求，以下示例使用 Nginx。

1. 下载 Nginx 配置文件和 Dockerfile（示例来自 示例目录）：

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

部署前需构建 Web 容器镜像：docker compose build。

2. 创建 compose.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
    volumes:
      - data:/var/www/html/storage
    restart: always

  web:
    build: ./web
    ports:
      - 8080:80
    depends_on:
      - app
    volumes:
      - 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:/var/lib/mysql
    restart: always

volumes:
  data:
    name: data
  mysql:
    name: mysql

3. 生成 APP_KEY（同 Apache 版本步骤 2）。

4. 启动服务：

docker compose up -d

等待数据库迁移完成后，通过 http://localhost:8080/ 访问 Monica，创建首个用户账户。

5. 执行初始化命令：

docker compose exec app php artisan setup:production

从互联网访问 Monica

将 Monica 实例暴露到互联网时，需设置环境变量 APP_ENV=production，此时强制启用 https 模式。

使用主机上的反向代理 Web 服务器

通过主机上具备 SSL 能力的反向代理服务器暴露 Monica 实例。

使用容器化反向代理 Web 服务器

更多带 SSL 能力的代理服务器配置示例见 示例目录。

镜像变体

arm32v6/monica 镜像提供多种变体，适用于不同场景：

arm32v6/monica:<version>

默认镜像，适合大多数场景。既可作为临时容器（挂载源码启动应用），也可作为构建其他镜像的基础。

arm32v6/monica:<version>-alpine

基于 Alpine Linux（alpine 官方镜像），体积更小（约 5MB 基础镜像）。

该变体适用于对最终镜像体积有严格要求的场景。注意其使用 musl libc 而非 glibc，部分依赖 glibc 的软件可能存在兼容性问题。

为最小化体积，Alpine 镜像通常不包含额外工具（如 git 或 bash），需在自定义 Dockerfile 中按需安装（参考 alpine 镜像说明）。

许可证

镜像中软件的许可证信息见 Monica 许可证文档。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础发行版的 Bash 等），其许可证可能不同。

自动检测的额外许可证信息可在 repo-info 仓库的 monica/ 目录 中找到。

使用预构建镜像时，用户需自行确保符合其中所有软件的相关许可证要求。