benbrummer/invoiceninja

基于FrankenPHP的Invoice Ninja镜像

https://github.com/benbrummer/dockerfiles/actions/workflows/bake.yaml/badge.svg](https://github.com/benbrummer/dockerfiles/actions/workflows/bake.yaml)

镜像概述

本镜像为Invoice Ninja提供基于FrankenPHP的部署方案，支持arm64和amd64架构。镜像每日（'55 11 * * *'）更新，以跟进https://github.com/invoiceninja/invoiceninja/releases%E7%9A%84%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%EF%BC%8C%E5%B9%B6%E5%8F%91%E5%B8%83%E8%87%B3Docker Hub。

核心功能与特性

与https://github.com/invoiceninja/dockerfiles/tree/debian%E4%BF%9D%E6%8C%81%E5%8A%9F%E8%83%BD%E5%AF%B9%E9%BD%90%EF%BC%8C%E5%B9%B6%E6%89%A9%E5%B1%95%E4%BB%A5%E4%B8%8B%E7%89%B9%E6%80%A7%EF%BC%9A

• FrankenPHP - 高性能PHP运行时
• Octane - Laravel高性能服务端
• Chromium - 用于PDF生成
• MariaDB - 关系型数据库
• Valkey - 高性能键值存储

使用场景

适用于需要部署Invoice Ninja发票管理系统的个人或企业，尤其适合需要高效PDF生成、数据库集成和缓存支持的场景，支持一体化快速部署或多服务拆分部署。

使用方法

镜像标签

• *-aio：一体化部署，包含Laravel应用、worker和调度器，通过supervisord管理多进程
• 多镜像模式：按Laravel角色拆分的专用镜像
  • -app：应用服务
  • -scheduler：调度服务
  • -worker：工作进程服务

从其他镜像或部署迁移

使用https://invoiceninja.github.io/en/import-and-export/#backup-function%E8%BF%9B%E8%A1%8C%E6%95%B0%E6%8D%AE%E8%BF%81%E7%A7%BB%EF%BC%9A

1. 基于dockerfiles/compose目录中的示例创建compose.yaml并根据需求调整。可通过以下命令查看镜像帮助菜单（开发中）：

   bash
   docker run --rm benbrummer/invoiceninja:5-octane-app --help
   

2. 环境变量需在.env文件中设置，而非直接写在compose.yaml中。复制sample.env为.env文件：

   bash
   cp sample.env .env
   

3. 编辑.env文件，设置APP_URL、APP_KEY及其他必要变量。

生成APP_KEY

通过以下命令生成APP_KEY：

bash
# 若容器未启动：
docker run --rm -it benbrummer/invoiceninja:5-octane php artisan key:generate --show

# 若容器已运行：
docker compose exec app php artisan key:generate --show

将生成的完整字符串复制到.env文件的APP_KEY=base64....处。

初始账户设置

首次启动容器前，在.env文件中设置IN_USER_EMAIL和IN_PASSWORD作为主账户信息。启动后可删除这两个变量。

⚠️ 警告
若未设置IN_USER_EMAIL和IN_PASSWORD，默认用户和密码分别为""和"changeme!"。

启动容器：

bash
docker compose up -d

启动后通过浏览器访问：http://localhost:8012/

更新镜像

升级到新版本镜像：

bash
docker compose pull
docker compose up -d

建议更新前进行数据备份。

支持

• 镜像相关问题：在https://github.com/benbrummer/dockerfiles/issues%E5%88%9B%E5%BB%BAissue
• Invoice Ninja本身支持：通过官方渠道
  • 论坛
  • https://github.com/invoiceninja/invoiceninja
  • https://github.com/invoiceninja/dockerfiles

自定义PHP设置

镜像内置/usr/local/etc/php/conf.d/invoiceninja.ini（基于./php.ini）。如需自定义PHP配置，可通过挂载ini文件到/usr/local/etc/php/conf.d/目录（文件按字母顺序加载，后加载的配置覆盖前加载的）：

yaml
volumes:
  # 自定义php.ini覆盖镜像内置配置
  - ./php/php.ini:/usr/local/etc/php/conf.d/invoiceninja.ini

构建镜像

ℹ️ 如需为特定平台构建，可在bake命令中添加--set *.platform=linux/amd64

构建最新版本

bash
docker buildx bake -f docker-bake.hcl

基于version.txt构建特定版本

bash
source version.sh
docker buildx bake -f docker-bake.hcl