Friendica Docker 镜像文档 (arm32v5 架构)

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

快速参考

• 维护者：
  nupplaPhil

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

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

  • 2024.12-apache, apache, stable-apache, 2024.12, latest, stable
  • 2024.12-fpm, fpm, stable-fpm
  • 2025.02-dev-apache, dev-apache, 2025.02-dev, dev
  • 2025.02-dev-fpm, dev-fpm
  • 2025.07-rc-apache, rc-apache, 2025.07-rc, rc
  • 2025.07-rc-fpm, rc-fpm

• 问题反馈地址：
  [***]

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

• 镜像 artifact 详情：
  repo-info 仓库的 repos/friendica/ 目录 (历史记录)
  （包含镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/friendica 标签
  official-images 仓库的 library/friendica 文件 (历史记录)

• 本文档来源：
  docs 仓库的 friendica/ 目录 (历史记录)

镜像概述和主要用途

什么是 Friendica？

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

!logo

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

核心功能和特性

• 去中心化架构：不依赖单一服务器，支持联邦式社交网络
• 多协议支持：链接独立社交项目和企业服务
• 灵活部署选项：提供 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 标签：基于 php-fpm 镜像，运行 FastCGI 进程，需配合能代理 HTTP 请求至 FastCGI 端口的 Web 服务器使用。

使用 apache 镜像

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

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

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

使用 fpm 镜像

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

$ docker run -d arm32v5/friendica:fpm

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

后台任务

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

1. 使用默认镜像，手动配置后台任务（参见 Friendica 安装文档）
2. 使用默认镜像（apache、fpm），启动专用 cron 实例并以 cron.sh 为启动命令（示例见 此处）

环境变量

Friendica 配置

Friendica 日志

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

锁驱动（Redis）

PHP 限制

邮件设置

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

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

管理员账户

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

持久化数据

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

Friendica 数据卷：

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

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

$ 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：

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  # 管理员