注意：这是monica镜像的arm32v7架构构建的“特定架构”仓库——更多信息，请参见镜像文档中的“除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

快速参考（续）

-** 提交问题的地址 ：
[*]

-** 支持的架构 **：(更多信息)
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服务器。运行容器：

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

使用fpm镜像

此镜像提供暴露9000端口的FastCGI服务器。您可能需要额外的Web服务器来代理请求到容器的9000端口（fpm端口）。运行容器：

console
docker run --name some-monica -d -p 9000:9000 arm32v7/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 \
        arm32v7/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镜像将使用环境变量来设置应用。常见变量设置请参见Monica文档。

使用Docker Compose运行镜像

有关Docker Compose的示例，请参见示例部分。

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变量设置值。它应该是一个随机的32字符字符串。例如，可以复制echo -n 'base64:'; openssl rand -base64 32的输出：

3. 运行

   console
   docker compose up -d
   

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

4. 运行一次以下命令：

   console
   docker compose exec app php artisan setup:production
   

FPM版本

使用FPM镜像时，需要另一个带有Web服务器的容器来代理HTTP请求。本示例使用nginx作为基本容器。

1. 下载nginx的nginx.conf和Dockerfile文件。示例可在示例部分找到：

   sh
   mkdir web
   curl -sSL [***] -o web/nginx.conf
   curl -sSL [***] -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变量设置值。它应该是一个随机的32字符字符串。例如，可以复制echo -n 'base64:'; openssl rand -base64 32的输出：

4. 运行

   console
   docker compose up -d
   

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

5. 运行一次以下命令：

   console
   docker compose exec app php artisan setup:production
   

从互联网访问Monica

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

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

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

使用代理Web服务器容器

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

镜像变体

arm32v7/monica镜像有多种变体，每种设计用于特定场景。

arm32v7/monica:<version>

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

arm32v7/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/目录中找到一些自动检测到的额外许可信息。

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