arm32v7/friendica

注意：这是https://hub.docker.com/_/friendica%E7%9A%84%60arm32v7%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%E2%80%9C%E6%AF%8F%E6%9E%B6%E6%9E%84%E2%80%9D%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%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/2024.12/fpm-alpine/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/e56ad74382f7d3f3fcfb5942bb39d2e7d5b27343/2025.02-dev/fpm-alpine/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/blob/567780fda826aeaf8ec328fd48225f5d6a48e4e8/2025.07-rc/fpm-alpine/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%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/friendica%EF%BC%89
  （镜像元数据、传输大小等）

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

• 本文档来源：
  https://github.com/docker-library/docs/tree/master/friendica%EF%BC%88https://github.com/docker-library/docs/commits/master/friendica%EF%BC%89

什么是 Friendica？

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

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

如何使用本镜像

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

apache 标签包含完整的 Friendica 安装，包括 Apache Web 服务器，易于使用且可快速启动。latest 标签及未指定类型的版本标签默认使用此类型。

第二种是 fpm 容器，基于 https://hub.docker.com/_/php/ 镜像，运行 FastCGI 进程以提供 Friendica 服务。使用此镜像需配合可将 HTTP 请求代理至容器 FastCGI 端口的 Web 服务器。

使用 apache 镜像

至少需要一个 mariadb/mysql 容器与其链接。

apache 镜像包含 Web 服务器并暴露 80 端口。启动容器命令：

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

此时可通过主机系统的 http://localhost:8080/ 访问 Friendica 安装向导。

使用 fpm 镜像

使用 fpm 镜像需额外 Web 服务器将 HTTP 请求代理至容器的 fpm 端口（暴露 9000 端口）。通常需将 Web 服务器与 fpm 容器置于同一 Docker 网络（通过 docker run --network <NAME> ... 或 compose.yaml 文件），无需将 fpm 端口映射至主机。

console
$ docker run -d arm32v7/friendica:fpm

由于 FastCGI 进程无法提供静态文件（样式表、图片等），Web 服务器需通过 volumes-from 选项访问这些文件，详见 Docker Compose 部分。

后台任务

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

• 使用默认镜像并手动设置后台任务（参见 Friendica https://github.com/friendica/friendica/blob/2021.03-rc/doc/Install.md#required-background-tasks%EF%BC%89
• 使用默认镜像（apache、fpm、fpm-alpine）启动专用 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_URL：Friendica 完整 URL，含协议、域名和子路径（示例：[***]
• FRIENDICA_TZ：服务器默认时区
• FRIENDICA_LANG：服务器默认语言
• FRIENDICA_SITENAME：服务器站点名称
• FRIENDICA_NO_VALIDATION：设为 true 时禁用 URL 和***验证
• FRIENDICA_DATA：存储提供程序名称（如 Filesystem 使用文件系统，默认使用数据库后端）
• FRIENDICA_DATA_DIR：数据目录（默认：/var/www/data）
• FRIENDICA_UPGRADE：强制启动 Friendica 更新（即使版本相同，默认：false）

Friendica 日志

• FRIENDICA_DEBUGGING：设为 true 启用日志
• FRIENDICA_LOGFILE（可选）：日志文件路径（默认：/var/www/friendica.log）
• FRIENDICA_LOGLEVEL（可选）：日志级别（默认：notice）
• FRIENDICA_LOGGER（可选）：日志类型（stream、syslog、monolog，默认：stream）
• FRIENDICA_SYSLOG_FLAGS（可选）：使用 syslog 时的标志（默认：LOG_PID | LOG_ODELAY | LOG_CONS | LOG_PERROR）
• FRIENDICA_SYSLOG_FACTORY（可选）：使用 syslog 时的工厂（默认：LOG_USER）

数据库（安装时必填）

• MYSQL_USER：MySQL/MariaDB 数据库用户名
• MYSQL_PASSWORD：MySQL/MariaDB 数据库密码
• MYSQL_DATABASE：MySQL/MariaDB 数据库名称
• MYSQL_HOST：MySQL/MariaDB 数据库服务器主机名
• MYSQL_PORT：MySQL/MariaDB 数据库服务器端口（默认：3306）

锁驱动（Redis）

• REDIS_HOST：Redis 实例主机名（用于锁定）
• REDIS_PORT（可选）：Redis 实例端口（用于锁定）
• REDIS_PW（可选）：Redis 实例密码（用于锁定）
• REDIS_DB（可选）：Redis 实例数据库（用于锁定）

PHP 限制

• PHP_MEMORY_LIMIT（默认 512M）：脚本允许分配的最大内存
• PHP_UPLOAD_LIMIT（默认 512M）：上传限制（post_max_size 和 upload_max_filesize）

管理员账户

Friendica 将管理员账户与特定绑定，因此必须为 MAILNAME 设置有效地址。

邮件设置

使用 ssmtp 二进制文件支持 Friendica 的 mail() 函数。

需正确设置 --hostname/-h 参数以使用 mail() 命令的正确域名，并通过 SMTP 环境变量指定有效的 SMTP-MTA（如 mx.example.org）以启用邮件功能。

SMTP 相关环境变量：

• SMTP：SMTP 邮件网关地址（必填）
• SMTP_PORT：SMTP 邮件网关端口（默认：587）
• SMTP_DOMAIN：发件人域名（必填，如 friendica.local）
• SMTP_FROM：发件人地址的用户部分（默认：no-reply，如 ***）
• SMTP_TLS：使用 TLS 连接 SMTP 网关（默认：空）
• SMTP_STARTTLS：使用 STARTTLS 连接 SMTP 网关（默认：On）
• SMTP_AUTH：SMTP 网关认证模式（默认：On）
• SMTP_AUTH_USER：SMTP 网关用户名（默认：空）
• SMTP_AUTH_PASS：SMTP 网关密码（默认：空）

STARTTLS 补充说明：tls_starttls 设为 On 或 Off，未设置时默认启用 STARTTLS（可能需要额外配置如独立端口）。

数据库设置

需将 Friendica 容器加入数据库容器所在网络（如 --network some-network），安装时数据库主机设为 mysql。

持久化数据

Friendica 安装及数据库外数据（文件上传等）存储在未命名 Docker 卷 /var/www/html 中。为持久化数据并便于备份，建议使用命名卷或挂载主机目录。需为数据库和 Friendica 分别配置卷：

Friendica：

• /var/www/html/：Friendica 数据目录

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

数据库：

• /var/lib/mysql：MySQL/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

除通过环境变量传递敏感信息外，可在上述变量后添加 _FILE 后缀，使初始化脚本从容器内文件加载值（如 Docker Secrets 的 /run/secrets/<secret_name> 文件）。示例：

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: 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 # 管理员邮箱文件
  mysql_database:
    file: ./mysql_database.txt # 数据库名称文件
  mysql_password:
    file: ./mysql_password.txt # 数据库密码文件
  mysql_user:
    file: ./mysql_user.txt # 数据库用户名文件

目前支持 FRIENDICA_ADMIN_MAIL、MYSQL_DATABASE、MYSQL_PASSWORD、MYSQL_USER。

镜像维护

更新至新版本

拉取最新镜像（docker pull arm32v7/friendica）。稳定分支启动时会检查更新，无安装或使用新镜像时自动更新。

使用 Docker Compose 运行

推荐使用 compose.yaml 实现完整功能部署，以下为基础示例：

基础版本 - apache

使用 apache 镜像和 MariaDB 容器，卷用于持久化数据，无 SSL 加密（建议用于代理后端）。运行前需设置 MYSQL_PASSWORD。

yaml
services