webhippie/invoiceninja

Invoice Ninja Docker镜像

概述

这些是运行Invoice Ninja的Docker镜像，基于https://github.com/dockhippie/php-apache构建，用于便捷部署和运行Invoice Ninja开源发票管理应用，支持发票创建、客户管理、支付跟踪等财务流程。

版本

可用版本请查看：

• https://hub.docker.com/r/webhippie/invoiceninja/tags
• Quay
• https://github.com/dockhippie/invoiceninja中的现有文件夹

卷

• /var/lib/invoiceninja: 持久化存储应用数据（配置、上传文件、数据库迁移等）

端口

• 8080: 应用HTTP服务监听端口

可用环境变量

以下环境变量用于配置应用行为，未指定则使用默认值：

console
INVOICENINJA_ABLY_KEY =                  # Ably实时通信API密钥
INVOICENINJA_ADMIN_TOKEN =               # 管理员操作令牌
INVOICENINJA_API_SECRET =                # API访问密钥
INVOICENINJA_APP_DEBUG = false           # 调试模式开关（true/false）
INVOICENINJA_APP_DIR = ${INVOICENINJA_BASE_DIR}/app  # 应用核心目录
INVOICENINJA_APP_DOMAIN =                # 应用域名
INVOICENINJA_APP_ENV = production        # 运行环境（production/development）
INVOICENINJA_APP_KEY =                   # 应用加密密钥（必填，用于数据加密）
INVOICENINJA_APP_LOCALE = en             # 应用语言（如en, zh-CN等）
INVOICENINJA_APP_LOGO =                  # 自定义Logo URL
INVOICENINJA_APP_NAME = Invoice Ninja    # 应用名称
INVOICENINJA_APP_TIMEZONE = UTC          # 时区设置（如Asia/Shanghai）
INVOICENINJA_APP_URL = http://localhost  # 应用访问URL（必填，如https://invoice.example.com）
INVOICENINJA_DB_CONNECTION = mysql       # 数据库类型（mysql/pgsql/sqlite）
INVOICENINJA_DB_HOST = mysql             # 数据库主机地址
INVOICENINJA_DB_DATABASE = invoiceninja  # 数据库名称
INVOICENINJA_DB_USERNAME = root          # 数据库用户名
INVOICENINJA_DB_PASSWORD = root          # 数据库密码
INVOICENINJA_DB_PORT = 3306              # 数据库端口
INVOICENINJA_MAIL_HOST =                 # 邮件服务器地址（如smtp.example.com）
INVOICENINJA_MAIL_PORT = 587             # 邮件服务器端口
INVOICENINJA_MAIL_USERNAME =             # 邮件服务器用户名
INVOICENINJA_MAIL_PASSWORD =             # 邮件服务器密码
INVOICENINJA_MAIL_ENCRYPTION = tls       # 邮件加密方式（tls/ssl/none）
INVOICENINJA_MAIL_FROM_ADDRESS = invoiceninja@localhost  # 发件人邮箱
INVOICENINJA_CACHE_DRIVER = file         # 缓存驱动（file/redis/memcached）
INVOICENINJA_QUEUE_CONNECTION = sync     # 队列驱动（sync/database/redis）

完整环境变量列表见镜像文档，以上为核心配置项。

继承的环境变量

该镜像基于以下基础镜像构建，支持其环境变量配置：

• https://github.com/dockhippie/php-apache#available-environment-variables%EF%BC%88PHP%E5%92%8CApache%E9%85%8D%E7%BD%AE%EF%BC%89
• https://github.com/dockhippie/apache#available-environment-variables%EF%BC%88Apache%E6%9C%8D%E5%8A%A1%E9%85%8D%E7%BD%AE%EF%BC%89
• https://github.com/dockhippie/alpine#available-environment-variables%EF%BC%88%E5%9F%BA%E7%A1%80%E7%B3%BB%E7%BB%9F%E9%85%8D%E7%BD%AE%EF%BC%89

部署示例

使用docker run快速启动

bash
docker run -d \
  --name invoiceninja \
  -p 8080:8080 \
  -v invoiceninja-data:/var/lib/invoiceninja \
  -e INVOICENINJA_APP_URL=http://your-domain.com:8080 \
  -e INVOICENINJA_APP_KEY=your-encryption-key \
  -e INVOICENINJA_DB_HOST=mysql \
  -e INVOICENINJA_DB_USERNAME=invoiceninja \
  -e INVOICENINJA_DB_PASSWORD=secure-password \
  -e INVOICENINJA_DB_DATABASE=invoiceninja \
  webhippie/invoiceninja:latest

使用docker-compose部署（含MySQL）

yaml
version: '3.8'

services:
  invoiceninja:
    image: webhippie/invoiceninja:latest
    ports:
      - "8080:8080"
    volumes:
      - invoiceninja-data:/var/lib/invoiceninja
    environment:
      - INVOICENINJA_APP_URL=http://localhost:8080
      - INVOICENINJA_APP_KEY=your-32-char-encryption-key
      - INVOICENINJA_DB_CONNECTION=mysql
      - INVOICENINJA_DB_HOST=mysql
      - INVOICENINJA_DB_PORT=3306
      - INVOICENINJA_DB_USERNAME=root
      - INVOICENINJA_DB_PASSWORD=root-password
      - INVOICENINJA_DB_DATABASE=invoiceninja
      - INVOICENINJA_APP_ENV=production
      - INVOICENINJA_APP_DEBUG=false
      - INVOICENINJA_APP_TIMEZONE=Asia/Shanghai
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - MYSQL_DATABASE=invoiceninja
    restart: unless-stopped

volumes:
  invoiceninja-data:
  mysql-data:

使用场景

• 小型企业/自由职业者：自动化发票生成、发送与跟踪
• 财务团队：集中管理客户信息、发票状态及支付记录
• 多场景集成：通过API对接电商平台、CRM系统实现财务流程自动化

贡献

采用 Fork -> Patch -> Push -> Pull Request 流程参与贡献。

作者

• https://github.com/tboerger

许可

MIT许可证

版权

console
Copyright (c) 2015 Thomas Boerger <http://www.webhippie.de>