riscv64/friendica

Friendica Docker镜像（riscv64架构）

注意：这是https://hub.docker.com/_/friendica%E7%9A%84%60riscv64%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E3%80%82%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%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://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/***f3b885ca311dcb5c24f57c731ff1857ab14/2026.01/apache/Dockerfile

• https://github.com/friendica/docker/blob/***f3b885ca311dcb5c24f57c731ff1857ab14/2026.01/fpm/Dockerfile

• https://github.com/friendica/docker/blob/***f3b885ca311dcb5c24f57c731ff1857ab14/2026.01/fpm-alpine/Dockerfile

• https://github.com/friendica/docker/blob/b70aa03e49e3c408971417d4d72d1995f857f37a/2026.05/apache/Dockerfile

• https://github.com/friendica/docker/blob/b70aa03e49e3c408971417d4d72d1995f857f37a/2026.05/fpm/Dockerfile

• https://github.com/friendica/docker/blob/b70aa03e49e3c408971417d4d72d1995f857f37a/2026.05/fpm-alpine/Dockerfile

• https://github.com/friendica/docker/blob/dcbc3166d05ca444fa9cdc70247c6e40930a7fce/2026.08-dev/apache/Dockerfile

• https://github.com/friendica/docker/blob/dcbc3166d05ca444fa9cdc70247c6e40930a7fce/2026.08-dev/fpm/Dockerfile

• https://github.com/friendica/docker/blob/dcbc3166d05ca444fa9cdc70247c6e40930a7fce/2026.08-dev/fpm-alpine/Dockerfile

快速参考（续）

• 提交issue：
  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/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/%E9%95%9C%E5%83%8F%EF%BC%8C%E8%BF%90%E8%A1%8CFastCGI%E8%BF%9B%E7%A8%8B%E4%BB%A5%E6%8F%90%E4%BE%9BFriendica%E6%9C%8D%E5%8A%A1%E3%80%82%E4%BD%BF%E7%94%A8%E6%AD%A4%E9%95%9C%E5%83%8F%E9%9C%80%E9%85%8D%E5%90%88%E5%8F%AF%E5%B0%86HTTP%E8%AF%B7%E6%B1%82%E4%BB%A3%E7%90%86%E5%88%B0%E5%AE%B9%E5%99%A8FastCGI%E7%AB%AF%E5%8F%A3%E7%9A%84Web%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82

使用apache镜像

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

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

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

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

使用fpm镜像

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

console
$ docker run -d riscv64/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服务器的默认时区
• FRIENDICA_LANG：Friendica服务器的默认语言
• FRIENDICA_SITENAME：Friendica服务器的站点名称
• FRIENDICA_NO_VALIDATION：设为true时禁用URL和电子邮件验证
• FRIENDICA_DATA：存储提供程序名称（例如Filesystem使用文件系统），默认使用数据库后端
• FRIENDICA_DATA_DIR：Friendica服务器的数据目录（默认：/var/www/data）
• FRIENDICA_UPGRADE：强制启动Friendica更新（即使版本相同），默认false

Friendica日志

• FRIENDICA_DEBUGGING：设为true时启用Friendica日志记录
• 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设置有效的地址。

邮件设置

Friendica的mail()功能使用ssmtp二进制文件。

需正确设置--hostname/-h参数以使用正确的域名。需设置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，不可 unset。若 unset，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 \
  riscv64/friendica

数据库：

• /var/lib/mysql：MySQL/MariaDB数据目录

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

自动安装

Friendica镜像支持通过环境变量自动配置，可预配置首次运行时安装页面的所有选项。启用自动安装需设置以下环境变量：

• FRIENDICA_URL：Friendica完整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数据库名
  mysql_password:
    file: ./mysql_password.txt # 在此文件中放置MySQL密码
  mysql_user:
    file: ./mysql_user.txt # 在此文件中放置MySQL用户名

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

镜像维护

更新至新版本

需从仓库拉取最新镜像（docker pull riscv64/friendica）。稳定分支在每次启动时会检查更新，若未找到安装或使用新镜像，将自动更新。

使用Docker Compose运行镜像

使用compose.yaml文件可轻松实现功能完整的部署。以下为部分示例：

基础版本 - apache

使用apache镜像并添加MariaDB容器，通过卷实现数据持久化