** 说明 **：这是monica官方镜像的s390x架构专用仓库——更多信息，请参见官方镜像文档中的“非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

快速参考（续）

-** 提交issues的地址 ：
[*]

-** 支持的架构 **：(更多信息)
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 s390x/monica

使用fpm镜像

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

docker run --name some-monica -d -p 9000:9000 s390x/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 \
        s390x/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
   

   等待所有迁移完成，然后从主机系统访问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
   

   等待所有迁移完成，然后从主机系统访问http://localhost:8080/。确认正常后，添加首个用户账户。

5. 运行以下命令一次：

   docker compose exec app php artisan setup:production
   

从互联网访问Monica

要将Monica实例暴露到互联网，需设置环境变量APP_ENV=production。此时https模式为必填。

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

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

使用代理Web服务器容器

Docker Compose的示例配置见示例部分，展示如何配置带SSL功能的代理Web服务器。

镜像变体

s390x/monica镜像有多种变体，适用于不同场景。

s390x/monica:<version>

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

s390x/monica:<version>-alpine

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

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

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

许可

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

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

自动检测到的其他许可信息可能位于repo-info仓库的monica/目录。

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