Friendica Docker 镜像文档

镜像概述和主要用途

本镜像是 Friendica 官方镜像 的 i386 架构专用版本，用于在 i386 架构环境中部署 Friendica 去中心化社交平台。Friendica 是一个去中心化通信平台，集成了社交沟通功能，可连接独立社交项目和企业服务，为用户提供自由开放的社交网络体验。

核心功能和特性

• 去中心化架构：支持分布式社交网络，连接独立项目与企业服务
• 多镜像变体：提供 apache（含 Web 服务器）、fpm（FastCGI 进程）和 fpm-alpine（轻量级 Alpine 基础）三种部署模式
• 环境变量配置：通过环境变量灵活配置 Friendica 服务器、数据库、邮件服务等参数
• 持久化存储：支持 Docker 卷挂载，确保数据持久化
• 自动安装：通过环境变量实现自动配置，无需手动执行安装向导
• 多架构支持：官方镜像支持多种架构，本版本专注于 i386 架构
• 安全配置：支持 Docker Secrets 管理敏感信息（如数据库密码、管理员邮箱）

使用场景和适用范围

• 个人/小型社区：快速部署独立社交服务器，满足小范围社交需求
• 企业内部通信：搭建企业私有社交平台，促进团队协作
• 开发者测试：通过 dev/rc 标签版本测试 Friendica 新功能
• 微服务架构：与 Nginx、Redis 等服务组合，构建高可用社交平台

快速参考

维护者

nupplaPhil

支持渠道

Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

问题反馈

[***]

支持架构

amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

支持的标签及对应 Dockerfile 链接

详细使用方法和配置说明

镜像选择

Friendica 镜像提供两种部署模式：

• apache 标签：包含完整 Friendica 安装及 Apache Web 服务器，开箱即用，适合快速部署（latest 标签默认为此模式）
• fpm 标签：基于 php-fpm 镜像，仅运行 FastCGI 进程，需配合 Nginx 等 Web 服务器使用

Apache 镜像使用

需配合 MariaDB/MySQL 容器使用，暴露 80 端口：

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

访问 http://localhost:8080 即可进入 Friendica 安装向导。

FPM 镜像使用

需配合 Web 服务器（如 Nginx），暴露 9000 端口（FastCGI）：

$ docker run -d i386/friendica:fpm

注意：FPM 容器无法直接提供静态文件（样式表、图片等），需通过 volumes-from 让 Web 服务器访问静态文件目录。

后台任务配置

Friendica 需后台任务处理消息收发及实例维护，有两种配置方式：

1. 手动配置（参考 Friendica 安装文档）
2. 启动专用 cron 实例，使用 cron.sh 作为启动命令（示例配置见 GitHub）

环境变量配置

Friendica 核心设置

日志配置

数据库配置（安装必需）

邮件配置

使用 ssmtp 提供邮件支持，需配置 SMTP 服务器：

PHP 限制配置

持久化数据配置

Friendica 数据存储在 /var/www/html，数据库数据存储在 /var/lib/mysql（MariaDB/MySQL 容器），需通过卷挂载实现持久化：

Friendica 容器：

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

数据库容器：

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

自动安装配置

通过环境变量实现自动安装，需配置：

• FRIENDICA_URL：完整 URL
• FRIENDICA_ADMIN_MAIL：管理员邮箱
• 数据库相关变量（MYSQL_USER、MYSQL_PASSWORD 等）

Docker Secrets 配置

支持通过 Docker Secrets 管理敏感信息（当前支持 FRIENDICA_ADMIN_MAIL、MYSQL_DATABASE、MYSQL_PASSWORD、MYSQL_USER）：

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: i386/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

Docker Compose 部署示例

Apache + MariaDB 基础配置

services:
  db:
    image: mariadb
    restart: always
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_secure_password  # 替换为安全密码
      - MYSQL_DATABASE=friendica
      - MYSQL_RANDOM_ROOT_PASSWORD=yes

  app:
    image: i386/friendica
    restart: always
    volumes:
      - friendica:/var/www/html
    ports:
      - "8080:80"
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_secure_password  # 与数据库密码一致
      - MYSQL_DATABASE=friendica
      - FRIENDICA_ADMIN_MAIL=***  # 替换为管理员邮箱
    depends_on:
      - db

volumes:
  db:
  friendica:

启动命令：

$ docker compose up -d

FPM + Nginx + MariaDB 配置

services:
  db:
    image: mariadb
    restart: always
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_secure_password
      - MYSQL_DATABASE=friendica
      - MYSQL_RANDOM_ROOT_PASSWORD=yes

  app:
    image: i386/friendica:fpm
    restart: always
    volumes:
      - friendica:/var/www/html
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_secure_password
      - MYSQL_DATABASE=friendica
      - FRIENDICA_ADMIN_MAIL=***
    networks:
      - proxy-tier
      - default

  web:
    image: nginx
    ports:
      - 8080:80
    links:
      - app
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro  # 挂载 Nginx 配置
    restart: always
    networks:
      - proxy-tier

volumes:
  db:
  friendica:

networks:
  proxy-tier:

Nginx 配置示例：参考 GitHub 示例

镜像维护

版本更新

拉取最新镜像并重启容器：

$ docker pull i386/friendica
$ docker-compose up -d  # 若使用 Compose

stable 分支镜像启动时会自动检查更新，若检测到新版本则自动升级。

DEV/RC 镜像特殊配置

*-dev 和 *-rc 标签镜像启动时会自动下载并验证最新源码，需设置 FRIENDICA_UPGRADE=true 启用此行为（默认 false）。