arm32v6/monica

Monica Docker镜像文档

概述

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

!https://raw.githubusercontent.com/docker-library/docs/b962028212dbd77c9531dbcf8d5a81db79d4a735/monica/logo.svg?sanitize=true

快速参考

• 维护者：
  https://github.com/monicahq/docker

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

支持的标签及对应Dockerfile链接

• https://github.com/monicahq/docker/blob/7ffc74385e243e2dac4d7013a3240c0ae1229f05/4/fpm-alpine/Dockerfile

• https://github.com/monicahq/docker/blob/7ffc74385e243e2dac4d7013a3240c0ae1229f05/5/fpm-alpine/Dockerfile

扩展参考

• 问题反馈：
  https://github.com/monicahq/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/monica/%E3%80%81https://hub.docker.com/r/arm32v5/monica/%E3%80%81https://hub.docker.com/r/arm32v6/monica/%E3%80%81https://hub.docker.com/r/arm32v7/monica/%E3%80%81https://hub.docker.com/r/arm64v8/monica/%E3%80%81https://hub.docker.com/r/i386/monica/%E3%80%81https://hub.docker.com/r/ppc64le/monica/%E3%80%81https://hub.docker.com/r/riscv64/monica/%E3%80%81https://hub.docker.com/r/s390x/monica/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/monica%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/monica%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fmonica
  https://github.com/docker-library/official-images/blob/master/library/monica%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/monica%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/monica%EF%BC%88https://github.com/docker-library/docs/commits/master/monica%EF%BC%89

如何使用本镜像

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

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

使用 apache 镜像

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

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

使用 fpm 镜像

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

console
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 目录创建卷。使用命名卷运行容器：

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

在容器内执行命令

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

console
docker exec CONTAINER_ID php artisan COMMAND

使用 Docker Compose 时：

console
docker compose exec monica php artisan COMMAND

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

使用环境变量配置

Monica 镜像通过环境变量配置应用。常用变量可参考 https://github.com/monicahq/monica/blob/4.x/.env.example%E3%80%82

使用 Docker Compose 运行镜像

Docker Compose 的配置示例可参考 https://github.com/monicahq/docker/blob/main/.examples%E3%80%82

Apache 版本

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

运行前需设置 APP_KEY 变量。

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
    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. 启动服务：

console
docker compose up -d

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

4. 执行初始化命令：

console
docker compose exec app php artisan setup:production

FPM 版本

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

1. 下载 Nginx 配置文件和 Dockerfile（示例来自 https://github.com/monicahq/docker/blob/main/.examples/full/fpm/web/%EF%BC%89%EF%BC%9A

sh
mkdir web
curl -sSL https://raw.githubusercontent.com/monicahq/docker/main/.examples/full/web/nginx.conf -o web/nginx.conf
curl -sSL https://raw.githubusercontent.com/monicahq/docker/main/.examples/full/web/Dockerfile -o web/Dockerfile

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

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
    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. 启动服务：

console
docker compose up -d

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

5. 执行初始化命令：

console
docker compose exec app php artisan setup:production

从互联网访问 Monica

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

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

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

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

更多带 SSL 能力的代理服务器配置示例见 https://github.com/monicahq/docker/blob/main/.examples%E3%80%82

镜像变体

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

arm32v6/monica:<version>

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

arm32v6/monica:<version>-alpine

基于 Alpine Linux（https://hub.docker.com/_/alpine%EF%BC%89%EF%BC%8C%E4%BD%93%E7%A7%AF%E6%9B%B4%E5%B0%8F%EF%BC%88%E7%BA%A6 5MB 基础镜像）。

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

为最小化体积，Alpine 镜像通常不包含额外工具（如 git 或 bash），需在自定义 Dockerfile 中按需安装（参考 https://hub.docker.com/_/alpine/%EF%BC%89%E3%80%82

许可证

镜像中软件的许可证信息见 https://github.com/monicahq/monica/blob/main/LICENSE.md%E3%80%82

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

自动检测的额外许可证信息可在 https://github.com/docker-library/repo-info/tree/master/repos/monica 中找到。

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