Invoice Ninja Docker镜像文档

镜像概述

本镜像为Invoice Ninja（一款开源发票管理系统）的Docker部署版本，基于php:7.2-fpm***镜像构建，用于快速部署功能完善的发票管理系统。支持通过环境变量灵活配置，提供持久化存储方案，并集成SSL支持，适用于需要高效管理发票、客户和支付流程的个人或企业用户。

核心功能与特性

• 基础环境：基于php:7.2-fpm***镜像，确保运行环境稳定可靠
• 持久化存储：需挂载/var/www/app/public/logo（Logo存储）和/var/www/app/storage（数据存储）目录以保持数据持久化
• 环境变量配置：通过环境变量灵活配置应用参数（如数据库连接、邮件设置、应用密钥等）
• SSL支持：默认生成自签名证书，支持通过环境变量提供自定义证书，或禁用证书生成
• docker-compose集成：提供开箱即用的docker-compose配置，简化部署流程

使用场景

适用于需要快速搭建发票管理系统的个人开发者、自由职业者或小型企业，用于创建、发送和管理发票，跟踪支付状态，管理客户信息等。

使用方法

直接运行（docker run）

使用以下命令启动容器，根据实际需求修改环境变量：

docker run -d \
  -e APP_ENV='production' \
  -e APP_DEBUG=0 \
  -e APP_URL='[***] \
  -e APP_KEY='SomeRandom32CharacterLongAlphanumericString' \
  -e DB_TYPE='mysql' \
  -e DB_STRICT='false' \
  -e DB_HOST='localhost' \
  -e DB_DATABASE='ninja' \
  -e DB_USERNAME='ninja' \
  -e DB_PASSWORD='ninja' \
  -e TRUSTED_PROXIES='PROXYCIDR' \
  -e MAIL_DRIVER='smtp' \
  -e MAIL_PORT='587' \
  -e MAIL_ENCRYPTION='tls' \
  -e MAIL_HOST='smtp.example.com' \
  -e MAIL_USERNAME='***' \
  -e MAIL_FROM_ADDRESS='***' \
  -e MAIL_FROM_NAME='Sales Department' \
  -e MAIL_PASSWORD='SUPERSECRETEMAILPASSWORD' \
  -e SSL_HOSTNAME='localhost' \
  -p '80:8000' \
  -p '443:443' \
  invoiceninja/invoiceninja

环境变量说明

完整环境变量列表可参考Invoice Ninja***示例文件，常用变量包括：

• APP_KEY：应用密钥，需32位字母数字字符串
• DB_*：数据库配置（类型、主机、数据库名、用户名、密码等）
• MAIL_*：邮件服务配置（驱动、端口、加密方式、SMTP信息等）
• TRUSTED_PROXIES：可信代理CIDR
• SSL_HOSTNAME：SSL主机名

SSL配置

默认行为

容器默认生成自签名SSL证书。

自定义证书

可通过运行时环境变量提供自定义证书：

• SSL_KEY：SSL私钥内容
• SSL_CERT：SSL证书内容

禁用SSL证书生成

若需禁用自签名证书生成，运行时传递环境变量：GEN_SSL=false

使用docker-compose部署

1. 获取配置文件：在***仓库的docker-compose目录中获取docker-compose配置
2. 配置环境变量：将.env.example重命名为.env，根据需求修改环境变量
3. 持久化路径：配置文件默认将持久化数据挂载到/mnt/user/appdata/invoiceninja/，可根据实际情况调整
4. 启动服务：运行docker-compose up -d启动服务，应用可通过[***]访问

已知问题

• PhantomJS兼容性：PhantomJS在Linux Alpine系统上无法正常工作，相关问题可参考GitHub Issue