开源项目ExpenseOwl使用教程

开源项目ExpenseOwl使用教程

ExpenseOwl Extremely simple expense tracker with nice UI. Intended for home lab use. 项目地址: https://gitcode.com/gh_mirrors/ex/ExpenseOwl

1. 项目介绍

ExpenseOwl是一个极其简单的自我托管费用跟踪系统，具有现代化的月度饼图可视化功能。它能够追踪日常开销，可视化月度消费模式，并维护财务习惯的概览。该项目旨在为用户提供一个不具备复杂功能的费用跟踪工具，仅提供月度饼图和表格视图，没有任何复杂的搜索或编辑功能。

2. 项目快速启动

安装

Go安装

go install github.com/tanq16/expenseowl/cmd/expenseowl@latest

Docker安装

docker pull tanq16/expenseowl:main
docker run -d \
--name expenseowl \
-p 8080:8080 \
-e EXPENSE_CATEGORIES="Rent,Food,Transport,Fun,Bills" \
-e CURRENCY=jpy \
-v expenseowl_data:/app/data \
tanq16/expenseowl:main

注意：EXPENSE_CATEGORIES 和 CURRENCY 是可选配置。

使用Docker Compose

version: "3.8"
services:
  budgetlord:
    image: tanq16/expenseowl:main
    restart: unless-stopped
    ports:
      - 5006:8080
    volumes:
      - /home/tanq/expenseowl:/app/data

源代码构建

git clone https://github.com/tanq16/expenseowl.git &&
cd expenseowl
go build ./cmd/expenseowl

使用

部署完成后，使用浏览器访问以下地址：

• 仪表盘：http://localhost:8080/
• 表格视图：http://localhost:8080/table

请注意，该应用没有认证机制，因此请谨慎部署。它非常适合在家庭实验室环境中使用，并且可以与反向代理如Nginx Proxy Manager配合使用。

3. 应用案例和最佳实践

ExpenseOwl主要适用于个人或小型团队的日常费用跟踪。以下是一些使用案例和最佳实践：

• 个人财务管理：使用ExpenseOwl跟踪日常开支，以便更好地控制预算。
• 团队协作：小型团队可以共享一个ExpenseOwl实例来跟踪团队共同的开支。
• 自动化：通过REST API自动添加费用记录，例如通过脚本或自动化工具。

4. 典型生态项目

目前开源社区围绕ExpenseOwl的项目还不是很多，但以下是一些可以与之配合使用的典型项目：

• Nginx Proxy Manager：用于代理ExpenseOwl，增加安全性。
• Docker容器管理工具：如Portainer或Docker，用于更方便地部署和管理ExpenseOwl容器。
• Kubernetes：对于需要高可用性的部署，可以使用Kubernetes进行扩展。

通过上述教程，您可以快速上手并使用ExpenseOwl进行个人或团队的费用跟踪。

ExpenseOwl Extremely simple expense tracker with nice UI. Intended for home lab use. 项目地址: https://gitcode.com/gh_mirrors/ex/ExpenseOwl