简介
InvoiceShelf 是一款免费、开源、可自托管的开票应用,面向个人和小型企业。从第一张报价单到最后一笔收款,整条资金记录都放在你自己控制的服务器上。它不按席位收费,没有 SaaS 订阅费,也不会把你绑定在某个供应商上。项目由社区推动,采用 Laravel + Vue 开发,许可证为 AGPL-3.0。
主要功能
- 发票和报价单:制作带品牌标识的发票和报价单,支持自定义字段、税费和备注,数量不限。
- 定期账单:设置一次聘用费或订阅计划,之后系统会自动生成重复发票。
- 费用与报表:记录费用,并统计销售额、税费、逾期余额和利润,不用再拼凑电子表格。
- 客户门户:客户可以在专属页面查看、下载和支付发票,不必另外处理账户。
- 多公司:一套安装可以管理多家企业,每家公司有各自的品牌、货币和税务规则。
- 收款管理:仪表盘实时显示未收和逾期总额;支持部分付款、贷项通知单(credit notes)和付款历史;可通过 Stripe 在线刷卡收款,并自动发送邮件付款提醒。
- 多币种和税费:支持多种货币和税务设置。
- 电子发票(EN 16931):通过官方免费的 E-Invoicing 模块开具 ZUGFeRD / Factur-X 电子发票。发票 PDF 内嵌会计软件可读取的 EN 16931 XML,也能单独导出 XML,可满足德国 B2B 电子发票的要求。官网将此功能标为 3.0 新功能,而当前最新稳定版是 2.4.7。
- API:提供 API 参考文档,方便与其他系统集成。
目标用户与使用场景
- 需要给客户开票的自由职业者和独立顾问
- 希望掌控财务数据、不想按月付 SaaS 费用的小型企业
- 同时经营多家公司或多个品牌的业主
- 需要开具符合 EN 16931 标准电子发票的欧洲(尤其是德国)企业
核心优势
- 完全免费:自托管即可使用全部功能,没有席位限制、订阅费或付费升级。
- 数据自主:客户、发票和付款记录都保存在你自己的基础设施上。
- 开放透明:源代码托管在 GitHub,任何人都可以阅读代码、提交 issue 或 PR。
安装部署
官方提供两种方式:
- Docker(推荐):拉取官方镜像
invoiceshelf/invoiceshelf(有:latest、:2等标签),或使用官方维护的 compose 文件。镜像内置调度器,不需要另外配置 cron。升级时执行docker compose pull && docker compose up -d。 - 手动安装:下载 ZIP 包上传到服务器,再运行安装向导。需要配置每分钟执行一次的 crontab:
* * * * * cd /path/to/invoiceshelf && php artisan schedule:run >> /dev/null 2>&1
如果主机不支持 crontab,可以用外部调度器调用 /api/cron,但需要在 .env 中设置 CRON_JOB_AUTH_TOKEN,并在请求头 x-authorization-token 中带上相同的值。
技术要求
- 基于 PHP(Laravel),当前 Docker 镜像使用 PHP 8.4。
- 手动安装时,官方建议把服务器 PHP 升级到 8.4.27 或更高版本,以修复相关的严重安全漏洞。
值得注意
- 社区支持主要通过 Discord 提供,完整文档见 docs.invoiceshelf.com。
- 项目由 Ideologix Media DOOEL 运营,官网提供新闻订阅,其中会发布托管版 InvoiceShelf 的相关消息。
发现更多
Firefly III
Firefly III 是一款现代化的财务管理工具,可以帮助你追踪资金动向并进行预算预测。它支持信用卡,拥有功能强大的规则引擎,还能从众多银行导入数据。
AGPL-3.0
PHP
+1Bigcapital
面向中小型企业的财务会计与库存管理软件。
AGPL-3.0
Docker
FOSSBilling
托管与计费自动化系统。可与 WHM、CWP、cPanel 和 HestiaCP 集成,提供完整的 API,并且易于扩展。
Apache-2.0
PHP
+1Ghostfolio
财富管理软件,用于追踪股票、ETF 和加密货币。
AGPL-3.0
Docker
+1Invoice Ninja
一款功能强大的在线客户开票工具。
AAL
PHP
+2Kresus
个人财务管理工具。
AGPL-3.0
Nodejs
+1