i386/friendica

Friendica Docker 镜像文档

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

快速参考

维护者

https://github.com/friendica/docker

支持渠道

https://dockr.ly/comm-slack%E3%80%81Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

问题反馈

https://github.com/friendica/docker/issues?q=

支持架构

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/

支持的标签及对应 Dockerfile 链接

详细使用方法和配置说明

镜像选择

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

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

Apache 镜像使用

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

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

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

FPM 镜像使用

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

console
$ docker run -d i386/friendica:fpm

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

后台任务配置

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

1. 手动配置（参考 https://github.com/friendica/friendica/blob/2021.03-rc/doc/Install.md#required-background-tasks%EF%BC%89
2. 启动专用 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 核心设置

日志配置

数据库配置（安装必需）

邮件配置

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

PHP 限制配置

持久化数据配置

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

Friendica 容器：

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

数据库容器：

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 等）

Docker Secrets 配置

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

yaml
services:
  db:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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 基础配置

yaml
services:
  db:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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=admin@example.com  # 替换为管理员邮箱
    depends_on:
      - db

volumes:
  db:
  friendica:

启动命令：

console
$ docker compose up -d

FPM + Nginx + MariaDB 配置

yaml
services:
  db:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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=admin@example.com
    networks:
      - proxy-tier
      - default

  web:
    image: docker.xuanyuan.run/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 配置示例：参考 https://github.com/friendica/docker/tree/master/.examples/docker-compose/with-traefik-proxy/mariadb-cron-smtp/fpm/web/nginx.conf

镜像维护

版本更新

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

console
$ docker pull docker.xuanyuan.run/i386/friendica
$ docker-compose up -d  # 若使用 Compose

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

DEV/RC 镜像特殊配置

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