friendica/server

什么是Friendica？

Friendica是一个去中心化的通信平台，整合社交沟通功能。我们的平台链接独立社交项目和企业服务。

!logo

如何使用此镜像

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

• 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%EF%BC%8C%E9%9C%80%E7%BB%93%E5%90%88%E5%8F%AF%E4%BB%A3%E7%90%86HTTP%E8%AF%B7%E6%B1%82%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%E4%BD%BF%E7%94%A8%E3%80%82

https://github.com/play-with-docker/stacks/raw/cff22438cb4195ace27f9b***bbb497047afa7/assets/images/button.png](http://play-with-docker.com?stack=https://raw.githubusercontent.com/nupplaphil/friendica-docker/fec33c98be957436279b7074ca08068b***/stack.yml) （管理员***：root@friendica.local）

使用Apache镜像

您至少需要一个mariadb/mysql容器链接到Friendica。Apache镜像包含Web服务器并暴露80端口，启动命令如下：

console
$ docker run -d -p 8080:80 --link some-mysql:mysql friendica/server

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

使用FPM镜像

使用FPM镜像需额外Web服务器将HTTP请求代理到容器的FPM端口（9000）。通常建议与其他容器或主机代理配合使用，确保它们在同一Docker网络中。启动命令如下：

console
$ docker run -d friendica/server:fpm

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

使用定时任务

启用Friendica定时任务有三种方式：

• 使用默认镜像并激活定时任务（参考安装文档的“激活计划任务”部分）
• 使用默认镜像（apache、fpm、fpm-alpine）创建两个容器（一个用于定时任务，一个用于主应用）
• 使用额外的预定义https://github.com/friendica/docker/tree/master/.examples/dockerfiles/cron

环境变量说明

自动安装设置

• FRIENDICA_ADMIN_MAIL：管理员***地址
• FRIENDICA_TZ：服务器默认时区
• FRIENDICA_LANG：服务器默认语言
• FRIENDICA_PHP_PATH：PHP二进制文件路径

数据库设置（安装必填）

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

开发/候选版本设置

• FRIENDICA_UPGRADE：设为true时，开发或候选版本节点将在启动时更新

管理员账户

Friendica将管理员账户与特定***关联，您必须为MAILNAME设置有效地址。

邮件设置

参考https://github.com/friendica/docker/tree/master/.examples/dockerfiles/README.md#smtpsetting

数据库设置

需链接运行中的数据库容器（如--link my-mysql:mysql），并在安装时使用mysql作为数据库主机。

持久化数据

Friendica安装及数据库外的所有数据（文件上传等）存储在未命名Docker卷/var/www/html中。为确保数据持久化，建议使用命名卷或挂载主机目录：

Friendica数据卷：

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

数据库数据卷：

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

自动安装

Friendica镜像支持通过环境变量自动配置，需至少设置以下变量：

• FRIENDICA_ADMIN_MAIL：管理员***
• MYSQL_USERNAME/MYSQL_USER：数据库用户名
• MYSQL_PASSWORD：数据库密码
• MYSQL_DATABASE：数据库名称
• MYSQL_HOST：数据库主机名

也可通过预定义local.ini.php文件（复制到/usr/src/config）实现自动配置。

镜像维护

更新到新版本

稳定版与开发版更新方式不同：

• 稳定版：拉取最新镜像（docker pull friendica），启动时会自动检查并更新
• 开发版：无需频繁拉取镜像，设置FRIENDICA_UPGRADE=true即可在启动时更新到最新版本

使用Docker Compose运行

Apache基础版本

yaml
version: '2'

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

  app:
    image: friendica/server
    restart: always
    volumes:
      - friendica:/var/www/html
    ports:
      - "8080:80"
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=
      - MYSQL_DATABASE=friendica
      - FRIENDICA_ADMIN_MAIL=root@friendica.local      
    hostname: friendica.local
    depends_on:
      - db

volumes:
  db:
  friendica:

运行docker-compose up -d后，访问http://localhost:8080/即可进入Friendica。

FPM基础版本

yaml
version: '2'

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

  app:
    image: friendica/server:fpm
    restart: always
    volumes:
      - friendica:/var/www/html    
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=friendica
      - MYSQL_PASSWORD=
      - MYSQL_DATABASE=friendica
      - FRIENDICA_ADMIN_MAIL=root@friendica.local
    hostname: friendica.local
    networks:
      - proxy-tier
      - default 

  web:
    image: nginx
    ports:
      - 8080:80
    links:
      - app
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro    
    restart: always
    networks:
      - proxy-tier  

volumes:
  db:
  friendica:

networks:
  proxy-tier:

需提前创建nginx.conf文件，运行docker-compose up -d后访问http://localhost:8080/。

问题反馈

如有问题，请访问https://github.com/friendica/docker%E6%8F%90%E4%BA%A4Issue%E3%80%82