mhzawadi/invoiceplane

InvoicePlane Docker镜像文档

镜像概述

InvoicePlane是一款自托管的开源应用，用于管理发票、客户和付款。本Docker镜像提供了便捷的容器化部署方式，简化InvoicePlane的安装和运行流程。

更多信息请访问InvoicePlane官网或尝试演示版本。

核心功能与特性

• 容器化部署：简化InvoicePlane的安装和环境配置
• 灵活的数据库连接：支持链接MySQL数据库容器
• 多平台支持：提供amd64、arm64、arm/v7等架构版本
• 环境变量配置：通过环境变量轻松配置应用参数
• 持久化存储：支持配置文件持久化，确保设置不丢失

使用场景

• 小型企业或自由职业者需要自托管的发票管理系统
• 开发或测试环境中快速部署InvoicePlane应用
• 需要跨平台运行InvoicePlane的场景

使用方法

MySQL数据库配置

首先运行专用的MySQL数据库容器：

bash
$ docker run --name invoiceplane-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -v /my_dir/invoiceplane:/var/lib/mysql -d mysql:5.6

说明：此命令将MySQL数据存储在主机的/my_dir/invoiceplane目录，并设置了root密码my-secret-pw。

运行InvoicePlane容器

bash
$ docker run -ti -d -p 80:80 --name invoiceplane --link invoiceplane-mysql:mysql mhzawadi/invoiceplane

说明：该命令将InvoicePlane容器与MySQL容器链接，并暴露80端口。需设置HOST_URL供Nginx接收请求。

Docker Compose部署

使用Docker Compose一键部署：

bash
curl https://github.com/mhzawadi/invoiceplane/blob/master/docker-compose.yml
docker-compose up -d

Docker Swarm部署

若使用Docker Swarm，可部署stack：

bash
curl https://github.com/mhzawadi/invoiceplane/blob/master/stack-invoiceplane.yml
docker stack deploy --compose-file stack-invoiceplane.yml invoiceplane

持久化配置

在Docker Swarm环境中，可将配置文件挂载到容器中以实现持久化：

将配置文件挂载至 /var/www/html/ipconfig.php

环境变量配置

Docker Hub标签

Docker Hub提供以下标签：

• latest - 最新稳定版本
• v1.5.9.1 - 1.5.9版本的最新稳定构建（构建号1）

构建方法

• latest标签：当推送到GitHub仓库后，Docker Hub自动构建
• ARM版本：通过buildx工具在本地构建多平台镜像：

bash
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t mhzawadi/invoiceplane:v1.5.10.1 --push .