benbrummer/invoiceninja Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

基于FrankenPHP的Invoice Ninja镜像

![Docker镜像大小]([] ![Docker拉取量]([] ![构建状态]([***]

镜像概述

本镜像为Invoice Ninja提供基于FrankenPHP的部署方案，支持arm64和amd64架构。镜像每日（'55 11 * * *'）更新，以跟进Invoice Ninja的最新版本，并发布至Docker Hub。

核心功能与特性

与invoiceninja-debian保持功能对齐，并扩展以下特性：

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

使用场景

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

使用方法

镜像标签

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

从其他镜像或部署迁移

使用官方备份功能进行数据迁移：

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

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

支持

• 镜像相关问题：在GitHub仓库创建issue
• Invoice Ninja本身支持：通过官方渠道
  • 论坛
  • GitHub仓库
  • 官方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