** 注意：**这是 monica 官方镜像的 ppc64le 架构构建的“每个架构”仓库——更多信息，请参见官方镜像文档中的“除 amd64 之外的架构？”和官方镜像 FAQ 中的“Git 中的镜像源已更改，现在该怎么办？”。

快速参考

-** 维护者：**Monica 团队

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

支持的标签及对应的 Dockerfile 链接

• 4.1.2-apache, 4.1-apache, 4-apache, apache, 4.1.2, 4.1, 4, latest

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

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

• 5.0.0-beta.5-apache, 5.0.0-beta-apache, 5.0-apache

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

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

快速参考（续）

-** 提交 issue 的位置：[*]

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

-** 已发布镜像制品详情：**repo-info 仓库的 repos/monica/ 目录（历史记录）
（镜像元数据、传输大小等）

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

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

什么是 Monica？

Monica 是一款优秀的开源个人关系管理系统，用于组织与亲友的互动。

!logo

如何使用本镜像

您可以选择两种版本的镜像。

apache 标签包含完整的 Monica 安装，带有 Apache Web 服务器。此标签也指向默认的 latest 标签。

fpm 标签包含一个 FastCGI 进程，用于提供网页服务。此镜像应与用作代理的 Web 服务器（如 Apache 或 Nginx）结合使用。

使用 apache 镜像

此镜像包含一个暴露 80 端口的 Web 服务器。运行容器的命令如下：

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

使用 fpm 镜像

此镜像提供一个暴露 9000 端口的 FastCGI 服务器。您可能需要一个额外的 Web 服务器，用于将请求代理到容器的 9000 端口（fpm 端口）。运行此容器的命令如下：

docker run --name some-monica -d -p 9000:9000 ppc64le/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 \
        ppc64le/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 变量的值。它应该是一个随机的 32 字符字符串。例如，您可以复制粘贴 echo -n 'base64:'; openssl rand -base64 32 的输出：

3. 运行

   docker compose up -d
   

   等待所有迁移完成，然后从主机系统访问 Monica：http://localhost:8080/。如果一切正常，添加您的第一个用户账户。

4. 运行以下命令一次：

   docker compose exec app php artisan setup:production
   

FPM 版本

使用 FPM 镜像时，您需要另一个带有 Web 服务器的容器来代理 HTTP 请求。在此示例中，我们使用 Nginx 基本容器来实现。

1. 下载 Nginx 的 nginx.conf 和 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 变量的值。它应该是一个随机的 32 字符字符串。例如，您可以复制粘贴 echo -n 'base64:'; openssl rand -base64 32 的输出：

4. 运行

   docker compose up -d
   

   等待所有迁移完成，然后从主机系统访问 Monica：http://localhost:8080/。如果一切正常，添加您的第一个用户账户。

5. 运行以下命令一次：

   docker compose exec app php artisan setup:production
   

使 Monica 可从互联网访问

要将您的 Monica 实例暴露到互联网，设置环境变量 APP_ENV=production 非常重要。在此情况下，https 模式是必需的。

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

暴露 Monica 实例的一种方法是使用主机上具有 SSL 功能的代理 Web 服务器。这可以通过反向代理实现。

使用代理 Web 服务器容器

有关带有 SSL 功能的代理 Web 服务器的示例，请参见 示例部分。

镜像变体

ppc64le/monica 镜像有多种版本，每种版本设计用于特定用例。

ppc64le/monica:<version>

这是默认镜像。如果您不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以启动应用），也可作为构建其他镜像的基础。

ppc64le/monica:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，可在 alpine 官方镜像 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是您的主要关注点时，此变体非常有用。需要注意的主要问题是它使用 musl libc 而非 glibc 及相关库，因此软件可能会因 libc 要求/假设的深度而遇到问题。有关可能出现的问题以及使用基于 Alpine 的镜像的优缺点比较，请参见 此 Hacker News 评论线程。

为了最小化镜像大小，基于 Alpine 的镜像中通常不包含其他相关工具（如 git 或 bash）。使用此镜像作为基础，在您自己的 Dockerfile 中添加所需的工具（如果不熟悉如何安装包，请参见 alpine 镜像描述 中的示例）。

许可

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

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可（如基础发行版中的 Bash 等，以及包含的主要软件的任何直接或间接依赖项）约束。

一些能够自动检测到的其他许可信息可能在 repo-info 仓库的 monica/ 目录 中找到。

至于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可。