本地最强个人记账应用ezBookkeeping-Docker安装部署和使用

本期来介绍一款优秀的 记账/个人财务 应用工具：ezBookkeeping，适合个人使用，界面友好、功能强大。

img

一、ezBookkeeping是什么

ezBookkeeping 是一款轻量级、自托管的个人财务应用，拥有简洁易用的界面和强大的记账功能。它以简洁易用和可移植性为设计理念，易于部署、易于使用，并且占用的系统资源极少，非常适合微服务器、NAS 设备、软路由，甚至 树莓派，也能在 PC、Mac 甚至云服务器上流畅运行。 部署起来非常简单，只要你有 Docker，一行命令就能搞定。

二、功能特点

• 安装简单： 支持 Docker

• 开源 & 自托管： 专为隐私与数据自主而设计

• 轻量 & 快速： 性能优化，即便在资源有限的设备上也运行流畅

• 现代且友好的用户界面： 针对手机与桌面优化的 UI，支持 PWA

• 本地化与国际化支持 ：多语言与多币种支持

• 强大的记账功能：

• 二级账户与分类结构

• 支持为交易添加图片附件

• 记录交易地理位置并在地图上展示

• 支持周期性交易

• 高级筛选、搜索、数据可视化与分析功能

• 安全可靠： 两步认证 (2FA)、登录频次限制、应用锁

• 数据导入/导出：支持 CSV、OFX、QFX、QIF、IIF、Camt.053、MT940、GnuCash、FireFly III、Beancount、随手记、支付宝以及微信账单 等多种格式

• AI 驱动： 支持 MCP

三、通过Docker安装部署

镜像差异：

#最新发布版本： mayswind/ezbookkeeping:latest #最新每日构建： mayswind/ezbookkeeping:latest-snapshot

3.1、一条Docker命令安装

docker run -p 8080:8080 mayswind/ezbookkeeping

3.2、创建本地目录&使用Docker Compose方式安装

1、可以使用命令行或界面创建本地存储目录文件夹

mkdir -p /opt/ezbookkeeping cd /opt/ezbookkeeping mkdir -p ./data ./log ./storage chown -R 1000:1000 ./data ./log ./storage

2、创建Docker Compose文件

services: ezbookkeeping: image: mayswind/ezbookkeeping:latest container_name: ezbookkeeping restart: unless-stopped ports: - 8082:8080 # 仅监听本地端口，由反向代理访问 environment: - "EBK_SERVER_DOMAIN=https://ez.yourdomain.com" # 将这里替换为你的实际域名 - "EBK_SERVER_ENABLE_GZIP=true" - "EBK_LOG_MODE+file" # 务必修改为一个随机字符串 - "EBK_SECURITY_SECRET_KEY=its_should_be_a_random_string" volumes: - /opt/ezbookkeeping/data:/ezbookkeeping/data - /opt/ezbookkeeping/storage:/ezbookkeeping/storage - /opt/ezbookkeeping/log:/ezbookkeeping/log

3、执行以下命令来拉取镜像并启动服务 docker compose up -d

3.3、飞牛配置

1、创建本地目录

img

2、拉取镜像 搜索并下载最新镜像

img

3、容器相关配置 端口号：

img

存储位置映射：

img

其他配置用默认就行

3.4、Docker安装默认路径说明

数据库默认用的sqlite3，也可以改成MySQL 配置文件： /ezbookkeeping/conf/ezbookkeeping.ini 数据库 (for sqlite3 database): /ezbookkeeping/data/ezbookkeeping.db 日志文件: /ezbookkeeping/log/ezbookkeeping.log 对象存储 (for local_filesystem object storage): /ezbookkeeping/storage/

四、使用说明

1、登录后，先注册一个账号

img

2、使用默认交易/支出/收入模板 内置了很多支出/收入分类模板，覆盖常用场景，很方便

img

3、导入第三方App数据 比如随手记、淘宝、微信支付等数据源

参考官方操作 导入数据参考

4、关闭注册 如果只是个人使用，可以在完成账户注册之后，关闭 ezBookkeeping 的注册功能

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～