Friendica Docker 镜像文档

一、镜像概述

1.1 关于 Friendica

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

!logo

1.2 基础信息

• 维护者：nupplaPhil
• 获取帮助：Docker 社区 Slack ([***] Fault、Unix & Linux 或 Stack Overflow
• 提交 issue：[***]
• 支持架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

1.3 支持的标签及 Dockerfile 链接

二、核心功能与特性

1. 去中心化架构：无需依赖中心化服务器，支持用户数据自主管理。
2. 多平台社交整合：链接独立社交项目（如***、Diaspora）和企业服务，实现跨平台通信。
3. 灵活部署选项：提供 apache（含Web服务器）和 fpm（FastCGI进程）两种镜像类型，适配不同部署需求。
4. 自动化配置：支持通过环境变量实现自动安装和配置，简化部署流程。
5. 数据持久化：支持Docker卷挂载，确保用户数据、配置和媒体文件持久化存储。
6. 跨架构支持：兼容 amd64、arm32v5、arm64v8 等多种硬件架构。
7. 日志与调试：可配置日志级别、日志类型（文件、syslog等），支持调试模式。
8. 邮件集成：通过SMTP配置支持邮件发送，用于用户验证、通知等功能。

三、使用场景与适用范围

1. 个人/组织去中心化社交网络：搭建自主可控的社交平台，保护数据隐私。
2. 微服务环境部署：作为微服务架构的一部分，与数据库、缓存（如Redis）、反向代理（如Nginx）等组件协同工作。
3. 开发与测试：通过 dev（开发版）或 rc（候选版）镜像测试新功能，加速定制化开发。
4. 低成本入门：apache 镜像开箱即用，适合快速搭建演示环境或小型实例。
5. 高性能生产环境：fpm 镜像配合Nginx等Web服务器，优化并发处理能力，适合中大型部署。

四、使用方法与配置说明

4.1 镜像类型选择

Friendica Docker镜像提供两种主要类型，适用于不同场景：

• apache 镜像：包含完整Friendica安装和Apache Web服务器，开箱即用，适合快速部署。latest、stable 等标签默认指向此类型。
• fpm 镜像：基于 php-fpm，仅运行FastCGI进程，需配合Nginx等Web服务器转发请求，适合高性能生产环境。

4.2 快速启动（Apache镜像）

前提条件

• 需搭配MariaDB/MySQL数据库容器（推荐使用Docker网络连接）。

启动命令

# 创建网络（若需连接数据库容器）
docker network create friendica-network

# 启动数据库容器
docker run -d \
  --name friendica-db \
  --network friendica-network \
  -v mysql-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=your_root_pw \
  -e MYSQL_DATABASE=friendica \
  -e MYSQL_USER=friendica \
  -e MYSQL_PASSWORD=your_db_pw \
  mariadb

# 启动Friendica Apache容器
docker run -d \
  --name friendica-app \
  --network friendica-network \
  -p 8080:80 \
  -v friendica-data:/var/www/html \
  -e MYSQL_HOST=friendica-db \
  -e MYSQL_USER=friendica \
  -e MYSQL_PASSWORD=your_db_pw \
  -e MYSQL_DATABASE=friendica \
  -e FRIENDICA_URL=http://localhost:8080 \
  -e FRIENDICA_ADMIN_MAIL=*** \
  friendica:apache

访问 http://localhost:8080 即可进入Friendica安装向导（若未配置自动安装）。

4.3 FPM镜像使用（配合Nginx）

架构说明

fpm 镜像需配合Web服务器（如Nginx），通过FastCGI协议处理HTTP请求。Web服务器需访问Friendica静态文件（如CSS、图片），可通过卷共享实现。

示例部署（Docker Compose）

services:
  db:
    image: mariadb
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=friendica
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_db_pw
      - MYSQL_RANDOM_ROOT_PASSWORD=yes

  app:
    image: friendica:fpm
    volumes:
      - friendica-data:/var/www/html
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=your_db_pw
      - MYSQL_DATABASE=friendica
      - FRIENDICA_URL=[***]

  web:
    image: nginx
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - friendica-data:/var/www/html  # 共享静态文件
    depends_on:
      - app

volumes:
  mysql-data:
  friendica-data:

Nginx配置示例（nginx.conf）：

events {}
http {
  server {
    listen 80;
    server_name your-domain.com;

    root /var/www/html;
    index index.php;

    location / {
      try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
      fastcgi_pass app:9000;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      include fastcgi_params;
    }
  }
}

4.4 环境变量配置

4.4.1 Friendica核心设置

4.4.2 日志配置

4.4.3 数据库配置（必填）

4.4.4 Redis锁驱动（可选）

用于分布式锁管理，优化并发任务处理。

4.4.5 PHP资源限制

4.4.6 邮件配置（可选）

用于用户注册验证、密码重置、系统通知等，需配置SMTP服务器。

4.5 数据持久化

Friendica数据（配置、用户上传文件等）存储在容器内 /var/www/html 目录，需通过Docker卷挂载实现持久化：

# 创建命名卷（推荐）
docker volume create friendica-data

# 启动容器时挂载卷
docker run -d \
  -v friendica-data:/var/www/html \
  ... 其他参数 ...
  friendica:apache

4.6 自动安装

通过环境变量配置实现自动安装，无需手动执行安装向导。需至少设置以下变量：

示例：

docker run -d \
  -e FRIENDICA_URL=[***] \
  -e FRIENDICA_ADMIN_MAIL=*** \
  -e MYSQL_HOST=db \
  -e MYSQL_USER=friendica \
  -e MYSQL_PASSWORD=your_db_pw \
  -e MYSQL_DATABASE=friendica \
  ... 其他参数 ...
  friendica:apache

4.7 Docker Secrets支持

为避免敏感信息（如数据库密码）