开源项目ExpenseOwl安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00614/article/details/146939211

开源项目ExpenseOwl安装与配置指南

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

1. 项目基础介绍

ExpenseOwl是一个极其简单的自托管费用跟踪系统，它具备现代的月度饼图可视化功能。它可以跟踪日常支出，可视化月度消费模式，并维护财务习惯的概览。该项目主要使用Go语言开发。

2. 项目使用的关键技术和框架

编程语言：Go
前端框架：未知（从提供的资料中未明确指出）
后端框架：可能使用了某些Go的web框架，但具体未明确
数据存储：平面文件系统（JSON格式）
容器化：支持Docker容器
可视化：使用饼图进行数据展示
REST API：提供RESTful API接口进行数据操作

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下环境和工具：

Git：用于克隆项目仓库
Go：Go语言环境，至少1.16版本以上
Docker（可选）：如果您计划使用Docker容器进行部署
Make工具或类似构建工具

详细安装步骤

克隆项目仓库

首先，您需要从GitHub上克隆该项目：

git clone https://github.com/Tanq16/ExpenseOwl.git

构建项目

进入项目目录后，构建项目：

cd ExpenseOwl
go build ./cmd/expenseowl

使用Docker进行部署

如果您选择使用Docker，可以按照以下步骤操作：

拉取ExpenseOwl的Docker镜像：
```
docker pull tanq16/expenseowl:main
```

运行Docker容器：

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，可以使用以下YAML定义：

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

记得根据您的实际目录调整/home/tanq/expenseowl路径。

直接运行可执行文件

如果您不使用Docker，可以直接运行编译后的可执行文件：

./expenseowl

或者指定数据存储路径：

./expenseowl -data /custom/path

使用REST API

ExpenseOwl提供了一个API，允许通过自动化或简单的cURL命令添加支出。例如，添加支出的API调用如下：

curl -X PUT http://localhost:8080/expense \
-H "Content-Type: application/json" \
-d '{
    "name": "Groceries",
    "category": "Food",
    "amount": 75.50,
    "date": "2024-03-15T14:30:00Z"
}'

获取所有支出的API调用如下：