Docker开源项目 基于Ubuntu系统部署ExpenseOwl自托管记账工具实战教程一、ExpenseOwl介绍1.1 ExpenseOwl 简介1.2 ExpenseOwl主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取ExpenseOwl镜像五、部署ExpenseOwl服务5.1 创建部署目录5.2 编辑部署文件5.3 创建ExpenseOwl容器5.4 查看ExpenseOwl容器状态5.5 查看ExpenseOwl容器日志六、访问ExpenseOwl服务七、Lunalytics基本使用7.1 设置货币单位7.2 添加消费项目7.3 新增收入项目7.4 费用统计八、总结一、ExpenseOwl介绍1.1 ExpenseOwl 简介ExpenseOwl是一款极简、可自托管的个人财务记账工具专为家庭实验室部署设计拥有美观的用户界面支持离线运行保障数据隐私。1.2 ExpenseOwl主要特点快速记账仅需输入日期、金额和类别即可快速添加收支记录。单用户专注专为单个用户设计非常适合个人或家庭财务管理。周期性交易支持设置定期发生的收入和支出如工资或房租。自定义设置可自定义分类、货币符号及账本起始日期满足个性化需求。标签分类支持为交易添加可选标签实现更精细的分类管理。美观界面提供简洁现代的用户界面并支持明亮与暗黑两种主题模式。离线自包含以独立二进制文件或容器镜像运行完全无需联网保障数据安全。多架构容器提供支持多硬件架构的 Docker 镜像并可挂载持久化存储。PWA 支持支持作为渐进式网页应用PWA安装到手机方便移动使用。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为Ubuntu 22.04.1。hostnameIP地址操作系统版本Docker版本部署项目jeven01192.168.3.88Ubuntu 22.04.1 LTS27.1.1ExpenseOwl2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署ExpenseOwl自托管费用跟踪系统。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven01:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/lib/systemd/system/docker.service;enabled;vendor preset: enabled)Active: active(running)since Fri2025-07-18 07:25:10 UTC;3days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:810(dockerd)Tasks:104Memory:191.8M CPU: 5min40.472s CGroup: /system.slice/docker.service ├─810/usr/bin/dockerd-Hfd://--containerd/run/containerd/containerd.sock3.2 检查Docker版本检查Docker版本rootjeven01:~# docker -vDocker version27.1.1, build63125853.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven01:~# docker compose versionDocker Compose version v2.19.1四、拉取ExpenseOwl镜像拉取ExpenseOwl容器镜像如下所示dockerpull tanq16/expenseowl:v4.0五、部署ExpenseOwl服务5.1 创建部署目录创建部署目录mkdir-p/data/expenseowlcd/data/expenseowl5.2 编辑部署文件使用docker-cli方式部署命令参考如下dockerrun-d\--restartalways\--nameexpenseowl\-p9200:8080\-v/data/expenseowl/data:/app/data\tanq16/expenseowl:v4.0在部署目录下创建docker-compose.yaml文件内容如下所示vimdocker-compose.yamlversion:3.9services:expenseowl:image:tanq16/expenseowl:v4.0volumes:-/data/expenseowl/data:/app/dataports:-9200:8080container_name:expenseowlrestart:always5.3 创建ExpenseOwl容器执行以下命令创建ExpenseOwl容器。dockercompose up-d5.4 查看ExpenseOwl容器状态检查ExpenseOwl容器运行状态确保ExpenseOwl容器正常启动。rootjeven01:/data/expenseowl# docker compose psWARN[0000]/data/expenseowl/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS expenseowl tanq16/expenseowl:v4.0./expenseowlexpenseowl37seconds ago Up37seconds0.0.0.0:9200-8080/tcp,[::]:9200-8080/tcp5.5 查看ExpenseOwl容器日志检查ExpenseOwl容器运行日志确保ExpenseOwl服务正常运行。dockercompose logs六、访问ExpenseOwl服务浏览器地址http://个人的服务器IP:9200访问ExpenseOwl的初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。七、Lunalytics基本使用7.1 设置货币单位在系统设置中选择货币单位为 CNY()后点击“save”保存配置。7.2 添加消费项目填写消费项目、类别、消费金额后新增即可。7.3 新增收入项目类型选择【income】勾选Report Gain选项计入收入类别中如下所示7.4 费用统计在 ExpenseOwl 的主页中我们可以通过一个直观的饼状图查看整体支出或收入的分布统计情况。八、总结通过本次实践成功使用Docker快速部署了ExpenseOwl整个过程简洁高效。利用多架构镜像可轻松在不同硬件环境中运行并实现数据持久化。Web界面美观易用PWA支持使其在手机上也能获得接近原生应用的体验。ExpenseOwl功能专注且完全离线运行是个人财务管理中兼顾隐私与实用性的理想选择。