arm32v5/friendica

Friendica Docker 镜像文档 (arm32v5 架构)

注意： 这是 https://hub.docker.com/_/friendica 的 arm32v5 架构构建的 "每个架构" 仓库。更多信息请参见官方镜像文档中的 https://github.com/docker-library/official-images#architectures-other-than-amd64 和官方镜像 FAQ 中的 https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

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

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

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

  • https://github.com/friendica/docker/blob/e56ad74382f7d3f3fcfb5942bb39d2e7d5b27343/2024.12/apache/Dockerfile
  • https://github.com/friendica/docker/blob/e56ad74382f7d3f3fcfb5942bb39d2e7d5b27343/2024.12/fpm/Dockerfile
  • https://github.com/friendica/docker/blob/e56ad74382f7d3f3fcfb5942bb39d2e7d5b27343/2025.02-dev/apache/Dockerfile
  • https://github.com/friendica/docker/blob/e56ad74382f7d3f3fcfb5942bb39d2e7d5b27343/2025.02-dev/fpm/Dockerfile
  • https://github.com/friendica/docker/blob/567780fda826aeaf8ec328fd48225f5d6a48e4e8/2025.07-rc/apache/Dockerfile
  • https://github.com/friendica/docker/blob/567780fda826aeaf8ec328fd48225f5d6a48e4e8/2025.07-rc/fpm/Dockerfile

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

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

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/friendica (https://github.com/docker-library/repo-info/commits/master/repos/friendica)
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Ffriendica
  https://github.com/docker-library/official-images/blob/master/library/friendica (https://github.com/docker-library/official-images/commits/master/library/friendica)

• 本文档来源：
  https://github.com/docker-library/docs/tree/master/friendica (https://github.com/docker-library/docs/commits/master/friendica)

镜像概述和主要用途

什么是 Friendica？

Friendica 是一个去中心化的通信平台，集成了社交沟通功能。该平台可链接独立的社交项目和企业服务。

!https://raw.githubusercontent.com/docker-library/docs/656ea9be01afdd087261aeae612d026012f1f63e/friendica/logo.svg?sanitize=true

主要用途：构建去中心化社交网络节点，实现跨平台社交互动，连接各类社交服务和独立项目。

核心功能和特性

• 去中心化架构：不依赖单一服务器，支持联邦式社交网络
• 多协议支持：链接独立社交项目和企业服务
• 灵活部署选项：提供 apache（含 Web 服务器）和 fpm（FastCGI 进程管理器）两种镜像类型
• 自动安装配置：通过环境变量支持自动完成安装向导
• 多架构支持：兼容 amd64、arm32v5、arm64v8 等多种硬件架构
• 数据持久化：支持 Docker 卷和绑定挂载，确保数据持久存储
• 后台任务支持：通过 cron 或手动配置运行必要的后台任务，维护节点正常运行
• 安全配置：支持 Docker Secrets 管理敏感信息，避免环境变量泄露

使用场景和适用范围

适用场景

• 个人/小型社区：快速部署私有社交网络节点
• 企业内部沟通：构建去中心化的企业内部通信平台
• 开发者测试：使用 dev 或 rc 标签测试 Friendica 新功能
• 微服务架构：与外部 Web 服务器（如 Nginx）、数据库（MariaDB/MySQL）、缓存（Redis）等组件配合使用

适用范围

• 需具备 Docker 环境的服务器或开发设备
• apache 镜像：适合快速启动，无需额外配置 Web 服务器
• fpm 镜像：适合需要自定义 Web 服务器配置（如 Nginx）的场景
• 建议配合数据库容器（如 MariaDB）和持久化存储使用

详细的使用方法和配置说明

如何使用本镜像

本镜像设计用于微服务环境，提供两种类型供选择：

• apache 标签：包含完整的 Friendica 安装及 Apache Web 服务器，易于使用，快速启动。latest 标签及未指定类型的版本标签默认使用此类型。
• fpm 标签：基于 https://hub.docker.com/_/php/ 镜像，运行 FastCGI 进程，需配合能代理 HTTP 请求至 FastCGI 端口的 Web 服务器使用。

使用 apache 镜像

至少需要一个 mariadb/mysql 容器与之链接。apache 镜像包含 Web 服务器并暴露 80 端口，启动命令：

console
$ docker run -d -p 8080:80 --network some-network arm32v5/friendica

启动后，可通过 http://localhost:8080/ 访问 Friendica 安装向导。

使用 fpm 镜像

fpm 镜像需配合 Web 服务器使用，暴露 9000 端口（FastCGI）。通常不直接映射端口到主机，而是通过 Docker 网络与 Web 服务器容器通信。启动命令：

console
$ docker run -d arm32v5/friendica:fpm

Web 服务器需访问静态文件（样式表、图片等），可通过 volumes-from 选项共享 Friendica 容器的卷（详见 Docker Compose 部分）。

后台任务

Friendica 需要后台任务来获取、发送消息及维护实例，有两种配置方式：

1. 使用默认镜像，手动配置后台任务（参见 Friendica https://github.com/friendica/friendica/blob/2021.03-rc/doc/Install.md#required-background-tasks%EF%BC%89
2. 使用默认镜像（apache、fpm），启动专用 cron 实例并以 cron.sh 为启动命令（示例见 https://github.com/friendica/docker/blob/stable/.examples/docker-compose/insecure/mariadb-cron-redis/apache/docker-compose.yml%EF%BC%89

环境变量

Friendica 配置

Friendica 日志

数据库配置（安装时必填）

锁驱动（Redis）

PHP 限制

邮件设置

使用 ssmtp 支持 Friendica 的 mail() 函数，需配置以下环境变量：

注意：需通过 --hostname/-h 参数设置正确的域名，确保 mail() 命令使用正确的域名。

管理员账户

Friendica 将管理员账户与特定绑定，必须通过 MAILNAME 设置有效的地址。

持久化数据

Friendica 安装及数据库外的所有数据（文件上传等）存储在未命名卷 /var/www/html 中。为确保数据持久化（如升级或删除容器后），建议使用命名卷或绑定主机目录：

Friendica 数据卷：

console
$ docker run -d \
  -v friendica-vol-1:/var/www/html \
  --network some-network \
  arm32v5/friendica

数据库数据卷（MariaDB 示例）：

console
$ docker run -d \
  -v mysql-vol-1:/var/lib/mysql \
  --network some-network \
  mariadb

自动安装

通过环境变量预配置安装参数，无需手动完成安装向导。需设置以下变量：

• FRIENDICA_URL：完整 URL（含协议、域名、子路径）
• FRIENDICA_ADMIN_MAIL：管理员***
• MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE、MYSQL_HOST：数据库配置

Docker Secrets

支持通过 Docker Secrets 传递敏感信息，避免使用环境变量。可在环境变量后添加 _FILE 后缀，从容器内文件加载值。目前支持 FRIENDICA_ADMIN_MAIL、MYSQL_DATABASE、MYSQL_PASSWORD、MYSQL_USER。

示例 compose.yaml：

yaml
services:
  db:
    image: mariadb
    restart: always
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_DATABASE_FILE=/run/secrets/mysql_database
      - MYSQL_USER_FILE=/run/secrets/mysql_user
      - MYSQL_PASSWORD_FILE=/run/secrets/mysql_password
    secrets:
      - mysql_database
      - mysql_password
      - mysql_user

  app:
    image: arm32v5/friendica
    restart: always
    volumes:
      - friendica:/var/www/html
    ports:
      - "8080:80"
    environment:
      - MYSQL_HOST=db
      - MYSQL_DATABASE_FILE=/run/secrets/mysql_database
      - MYSQL_USER_FILE=/run/secrets/mysql_user
      - MYSQL_PASSWORD_FILE=/run/secrets/mysql_password
      - FRIENDICA_ADMIN_MAIL_FILE=/run/secrets/friendica_admin_mail
    depends_on:
      - db
    secrets:
      - friendica_admin_mail
      - mysql_database
      - mysql_password
      - mysql_user

volumes:
  db:
  friendica:

secrets:
  friendica_admin_mail:
    file: ./friendica_admin_mail.txt  # 管理员