基于Alpine的PHP-FPM和NGINX HumHub Docker容器

![Codacy Badge]([] ![Build]([] !Docker Pulls ![Join the chat at []]([]

HumHub 是一款功能丰富、高度灵活的开源社交网络工具，采用PHP开发。本容器提供了一种快速、灵活且轻量级的方式来搭建概念验证环境，以便进行详细评估。虽然可用于生产环境，但请注意目前这种部署方式无官方支持。

版本

本项目提供不同镜像和标签以满足不同需求。评估环境建议使用 humhub:stable，生产环境建议使用最新的次要版本标签（如 humhub:1.13）。

• latest：不稳定的主分支构建（不推荐用于生产环境；使用时需谨慎，可能不稳定！）
• 次要版本（如 1.13）：始终指向特定次要版本的最新发布版（推荐）
• 构建版本（如 1.13.4）：始终指向特定构建版本的最新发布版，稳定性高但可能过时
• stable：始终指向仍受支持的最旧版本，因此最为成熟。更新包含次要版本变更，可能涉及数据库 schema 更改（风险较高）
• legacy：尽量避免使用此标签。若当前安装被标记为“已弃用”，相关标签将改为“legacy”。请尽快升级以避免安全及其他问题

变体

本镜像提供3种变体。若需快速启动安装，使用未指定变体的标签（如 humhub:1.13）；若需保持更新且不关注版本升级，使用动态标签；对于关键环境，建议使用版本标签或镜像摘要，避免使用动态标签。

若计划构建托管解决方案，可参考 docker-compose.prod.yml 了解变体镜像的使用方式。

• all-in-one（如 humhub:1.13）：多服务镜像（包含nginx + php-fpm），不确定需求时推荐使用
• nginx（如 humhub:1.13-nginx）：仅包含静态文件和nginx代理配置，不含PHP
• phponly（如 humhub:1.13-phponly）：包含HumHub源码和php-fpm，需配合FCGI应用服务器才能提供HTTP服务

版本矩阵

• 生命周期结束（EOL）：不再持续重建，版本可能随时移除，请勿使用或立即升级
• 已弃用（Deprecated）：即将进入EOL，避免使用或尽快升级
• 稳定（Stable）：广泛使用且关注度高，体验最佳
• 测试（Testing）：需特定新功能时使用，最新HumHub版本会先以此方式发布以发现迁移问题，适合测试下一主要版本升级

快速启动

未集成数据库。如需持久性存储，参考Compose文件示例。

1. docker run -d --name humhub_db -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=humhub mariadb:10.2
2. docker run -d --name humhub -p 80:80 --link humhub_db:db mriedmann/humhub:stable
3. 在浏览器中打开 http://localhost/
4. 完成安装向导（数据库主机名使用 db，数据库名使用 humhub）
5. 完成

Compose文件示例

version: '3.1'
services:
  humhub:
    image: mriedmann/humhub:stable
    links:
      - "db:db"
    ports:
      - "8080:80"
    volumes:
      - "config:/var/www/localhost/htdocs/protected/config"
      - "uploads:/var/www/localhost/htdocs/uploads"
      - "modules:/var/www/localhost/htdocs/protected/modules"
    environment:
      HUMHUB_DB_USER: humhub
      HUMHUB_DB_PASSWORD: humhub

  db:
    image: mariadb:10.2
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: humhub
      MYSQL_USER: humhub
      MYSQL_PASSWORD: humhub

volumes:
  config: {}
  uploads: {}
  modules: {}

在某些情况下（如使用 podman-compose），可能需要运行两次 compose up 以确保命名卷创建完成。

高级配置

本容器支持通过环境变量进行进一步配置。可参考 docker-compose.yml 获取配置灵感。

数据库配置

若要在首次启动时跳过可视化安装向导，需同时设置 HUMHUB_DB_PASSWORD 和 HUMHUB_DB_USER。若使用 --link 参数，请通过 HUMHUB_DB_HOST 指定链接名称作为主机，或使用 db 作为链接名（--link <容器名>:db）。

HUMHUB_DB_USER     []  # 数据库用户名
HUMHUB_DB_PASSWORD []  # 数据库密码
HUMHUB_DB_NAME     [humhub]  # 数据库名
HUMHUB_DB_HOST     [db]  # 数据库主机

自动安装配置

HUMHUB_AUTO_INSTALL [false]  # 是否启用自动安装

若启用此选项且设置了 HUMHUB_DB_USER，首次启动时将执行自动安装。此功能利用了HumHub集成测试中使用的隐藏安装特性（参见代码文件）。

HUMHUB_PROTO [http]  # 协议（http/https）
HUMHUB_HOST  [localhost]  # 主机名

自动安装时若定义这两个变量，HumHub将配置为使用指定URL（例如，设置 HUMHUB_PROTO=https 和 HUMHUB_HOST=example.com，则基础URL为 [***]；默认配置为 http://localhost/）。

HUMHUB_ADMIN_LOGIN    [admin]  # 管理员登录名
HUMHUB_ADMIN_EMAIL    [***]  # 管理员邮箱
HUMHUB_ADMIN_PASSWORD [test]  # 管理员密码

自动安装时若定义这些变量，将创建具有指定凭据的管理员账户。

启动配置

INTEGRITY_CHECK [1]  # 是否启用启动完整性检查，设为"false"可禁用（谨慎使用！）

WAIT_FOR_DB [1]  # 数据库主机不可用时是否使启动失败，设为"false"可禁用。使用外部数据库主机时可能有用，链接容器时建议启用。

SET_PJAX [1]  # 是否启用PJAX（第二次启动时生效）。PJAX是使用Ajax和pushState提升浏览体验的jQuery插件（参考），部分浏览器安装时可能出现问题。容器默认禁用PJAX以提高安装可靠性，设为"false"可永久禁用。容器创建后修改此值无效。

邮件配置

可通过以下环境变量配置HumHub邮件设置：

HUMHUB_MAILER_SYSTEM_EMAIL_ADDRESS    [***]  # 系统邮件地址
HUMHUB_MAILER_SYSTEM_EMAIL_NAME       [HumHub]  # 系统邮件名称
HUMHUB_MAILER_TRANSPORT_TYPE          [php]  # 传输类型
HUMHUB_MAILER_HOSTNAME                []  # 邮件服务器主机名
HUMHUB_MAILER_PORT                    []  # 邮件服务器端口
HUMHUB_MAILER_USERNAME                []  # 邮件服务器用户名
HUMHUB_MAILER_PASSWORD                []  # 邮件服务器密码
HUMHUB_MAILER_ENCRYPTION              []  # 加密方式
HUMHUB_MAILER_ALLOW_SELF_SIGNED_CERTS []  # 是否允许自签名证书

LDAP配置

可通过以下环境变量配置HumHub LDAP认证：

HUMHUB_LDAP_ENABLED                               [0]  # 是否启用LDAP
HUMHUB_LDAP_HOSTNAME                              []  # LDAP主机名
HUMHUB_LDAP_PORT                                  []  # LDAP端口
HUMHUB_LDAP_ENCRYPTION                            []  # 加密方式
HUMHUB_LDAP_USERNAME                              []  # LDAP用户名
HUMHUB_LDAP_PASSWORD                              []  # LDAP密码
HUMHUB_LDAP_BASE_DN                               []  # 基础DN
HUMHUB_LDAP_LOGIN_FILTER                          []  # 登录过滤器
HUMHUB_LDAP_USER_FILTER                           []  # 用户过滤器
HUMHUB_LDAP_USERNAME_ATTRIBUTE                    []  # 用户名属性
HUMHUB_LDAP_EMAIL_ATTRIBUTE                       []  # 邮箱属性
HUMHUB_LDAP_ID_ATTRIBUTE                          []  # ID属性
HUMHUB_LDAP_REFRESH_USERS                         []  # 是否刷新用户
HUMHUB_ADVANCED_LDAP_THUMBNAIL_SYNC_PROPERTY      [thumbnailphoto]  # 缩略图同步属性

PHP配置

可通过以下环境变量修改PHP配置，便于容器垂直扩展：

PHP_POST_MAX_SIZE       [16M]  # POST数据最大尺寸
PHP_UPLOAD_MAX_FILESIZE [10M]  # 上传文件最大尺寸
PHP_MAX_EXECUTION_TIME  [60]  # 最大执行时间（秒）
PHP_MEMORY_LIMIT        [1G]  # 内存限制
PHP_TIMEZONE            [UTC]  # 时区

NGINX配置

可通过以下变量配置内置Nginx。配置文件在容器每次启动时重写，不持久化，不建议手动修改。

NGINX_CLIENT_MAX_BODY_SIZE [10m]  # 客户端请求体最大尺寸
NGINX_KEEPALIVE_TIMEOUT    [65]  # 长连接超时时间（秒）
HUMHUB_REVERSEPROXY_WHITELIST ["127.0.0.1"]  # 允许访问/ping端点的IP地址，支持CIDR表示法

贡献

bug报告或功能建议请使用issues页面。欢迎提交pull请求。

特别鸣谢

特别感谢以下贡献者为本镜像所做的杰出工作：

• @jvies
• @madmath03
• @ArchBlood
• @pascalberger
• @bkmeneguello

同时感谢@luke-及其团队开发、构建和维护HumHub。