** 注意 **：这是 monica 官方镜像 的 amd64 架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“非 amd64 架构？”和官方镜像常见问题中的“镜像源在 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

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

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

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

什么是 Monica？

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

!logo

如何使用本镜像

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

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

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

使用 apache 镜像

此镜像包含一个暴露 80 端口的网络服务器。运行容器：

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

使用 fpm 镜像

此镜像提供一个暴露 9000 端口的 FastCGI 服务器。您可能需要一个额外的网络服务器作为代理，将请求转发到容器的 9000 端口。运行容器：

docker run --name some-monica -d -p 9000:9000 amd64/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 \
        amd64/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 镜像时，需要另一个容器作为网络服务器代理 HTTP 请求。本示例使用 Nginx 容器。

1. 下载 Nginx 的 nginx.conf 和 Dockerfile 文件。示例可在 example section 找到。

   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 模式。

使用主机上的代理网络服务器

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

使用代理网络服务器容器

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

镜像变体

amd64/monica 镜像有多种版本，适用于不同用例。

amd64/monica:<version>

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

amd64/monica:<version>-alpine

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

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用 musl libc 而非 glibc 及相关库，因此软件可能因 libc 要求/假设而遇到问题。更多讨论参见 此 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外相关工具（如 git 或 bash）。以此镜像为基础，可在自己的 Dockerfile 中添加所需工具（若不熟悉安装包方法，参见 alpine 镜像描述 中的示例）。

许可证

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

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

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

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