常见问题

目录

1. ezBookkeeping 支持哪些操作系统
2. ezBookkeeping 需要使用多少系统资源
3. 为什么在 Windows 系统上双击 ezbookkeeping.exe 无法打开应用程序
4. ezBookkeeping 有哪些必须要设置的设置项
5. ezBookkeeping 启动时提示没有权限（“permission denied”）
6. ezBookkeeping 文件存储的位置
   1. 数据库文件
   2. 对象存储文件
7. 如何迁移 ezBookkeeping 的数据
   1. 迁移数据库
   2. 迁移对象存储
8. ezBookkeeping 是否提供电脑桌面应用或手机 App
9. 如何将 ezBookkeeping 添加到手机主屏幕
10. ezBookkeeping 的默认用户是什么
11. 为什么无法添加交易
12. 如何记录退款
13. 转账交易如何记录手续费
14. 如何记录别人借我的钱
15. 如何修改账户余额
16. 添加交易时无法设置货币信息
17. 如何修改添加交易时默认的账户
18. 如何更改金额的颜色
19. 移动版如何编辑、删除交易、账户
20. 如何使用交易模板创建交易
21. 如何使用AI识图创建交易
22. 定时交易没有自动创建新的交易
23. 为什么上传的用户头像和交易图片无法显示
24. 为什么总金额时不包含特定货币的金额
25. 为什么删除交易后数据库里的记录没有删除
26. 为什么删除交易图片后对象存储里的图片文件没有删除
27. 如何修改验证邮件或密码重置邮件中的内容
28. 如何修改AI识图等请求大语言模型（LLM）的提示词
29. ezBookkeeping 使用了哪些第三方服务，以及是否会使用我的个人数据

本页面列举了一些常见问题及答案。

如果页面中没有您要找的问题，您可以访问 GitHub Discussions 或 GitHub Issues 查找更多内容。

ezBookkeeping 支持哪些操作系统

运行 ezBookkeeping 服务端的操作系统与 Golang 支持的操作系统相同，下表列出了 ezBookkeeping 各个版本依赖的 Golang 的版本以及支持操作系统的最低版本。

上述 Linux 版本仅表示 amd64、arm64 和 armv6/v7 架构下的版本，其他架构下支持的版本请参考 Golang 官方文档。更多 Golang 支持的操作系统的信息，请访问 Golang 官方文档：https://go.dev/wiki/MinimumRequirements。

如果你已经部署了 ezBookkeeping 的服务端程序，你可以直接使用你的浏览器访问 ezBookkeeping，下表列出了 ezBookkeeping 各个版本支持的浏览器的最低版本。

ezBookkeeping 需要使用多少系统资源

ezBookkeeping 是基于 Golang 编写的轻量软件，需要资源非常少。ezBookkeeping 的二进制文件及依赖的静态文件大约占用 40MB 左右的磁盘空间，在 Linux/amd64 平台运行时只需要使用约 30MB 左右内存。

为什么在 Windows 系统上双击 ezbookkeeping.exe 无法打开应用程序

ezBookkeeping 并不是一个桌面应用，而是一个自托管的服务端程序，你可以参考 安装 文档中的步骤启动该服务端程序。当服务端程序运行后，你就可以使用你各种设备上的各种浏览器访问 ezBookkeeping。

当然，如果你愿意，你也可以在个人电脑上运行 ezBookkeeping 的服务端程序，并使用本机的浏览器访问它。

ezBookkeeping 有哪些必须要设置的设置项

ezBookkeeping 是开箱即用的，无需设置任何额外的设置项即可启动运行。但是如果你正式使用它，还需要正确配置以下几个配置项：

1. security 节中的 secret_key（环境变量 EBK_SECURITY_SECRET_KEY）：需要设置为一个随机字符串，随机字符串也可以使用 ezBookkeeping 命令行工具生成 ezbookkeeping security gen-secret-key
2. server 节中的 domain（环境变量 EBK_SERVER_DOMAIN）：需要设置为用户访问的域名或者 IP 地址（例如 ezbookkeeping-demo.mayswind.net 或 192.168.1.2）。如果设置错误将会导致用户头像或交易图片无法显示，以及 ezBookkeeping 发送的邮件中的链接地址错误

如果你想使用 Nginx 等反向代理，并且暴露给用户的协议、端口号与 ezBookkeeping 的 Web 服务器设置不同，还需要设置 server 节中的 root_url（环境变量 EBK_SERVER_ROOT_URL），例如 https://ezbookkeeping-demo.mayswind.net/。

如果你想使用 MySQL 作为数据库，需要设置 database 节中的 type（环境变量 EBK_DATABASE_TYPE） 为 mysql，同时设置数据库主机 host（例如 mysql.domain:3306 或 /var/run/mysqld/mysqld.sock）、数据库名 name、数据库访问用户 user、数据库访问密码 passwd。

如果你想使用 PostgreSQL 作为数据库，需要设置 database 节中的 type（环境变量 EBK_DATABASE_TYPE） 为 postgres，同时设置数据库主机 host（例如 pg.domain:5432，或 /var/run/postgresql）、数据库名 name、数据库访问用户 user、数据库访问密码 passwd。

如果你想存储用户头像或交易图片，请检查或设置 配置-对象存储 中的设置。此外，ezBookkeeping 的汇率数据源、地图提供者、大语言模型（LLM）提供者等都可以自定义，具体请参考 配置。

ezBookkeeping 启动时提示没有权限（“permission denied”）

ezBookkeeping 的 data 目录（使用 SQLite 数据库时）、storage 目录（使用 local_filesystem 对象存储类型时）、log 目录都需要有运行 ezBookkeeping 进程用户的读写权限。以及 conf/ezbookkeeping.ini 文件需要有运行 ezBookkeeping 进程用户的读权限。

如果你使用 Docker 镜像部署，运行 ezBookkeeping 进程的用户 UID 为 1000、组 GID 为 1000，如果你将外部目录挂载到 Docker 容器内，需要保证对应目录有该 UID/GID 的权限。

ezBookkeeping 文件存储的位置

ezBookkeeping 大部分数据都存储在数据库中，用户的头像、交易的图片文件存储在对象存储中。

数据库文件

如果你使用 SQLite 作为数据库，则数据库文件的默认位置为 ezBookkeeping 可执行文件目录下的 data/ezbookkeeping.db，如果你使用 Docker 镜像部署，则数据库文件的默认路径为容器内的 /ezbookkeeping/data/ezbookkeeping.db。你可以通过配置文件修改这个路径，更多信息见 配置-数据库 中的 db_path。

如果你使用 MySQL 或 PostgreSQL，数据库文件通过数据库系统进行管理。

对象存储文件

如果你使用 local_filesystem 对象存储类型，则对象存储文件的默认位置为 ezBookkeeping 可执行文件目录下的 storage 目录，如果你使用 Docker 镜像部署，则数据库文件的默认路径为容器内的 /ezbookkeeping/storage/。你可以通过配置文件修改这个路径，更多信息见 配置-对象存储 中的 local_filesystem_path。

如果你使用 minio 或 webdav 对象存储类型，对象存储的文件通过对象存储系统进行管理。

如何迁移 ezBookkeeping 的数据

若您使用 MySQL 或 PostgreSQL 作为数据库，同时使用 minio 或 webdav 对象存储类型（或不存储用户头像或交易图片文件），则 ezBookkeeping 本身是无状态的，不需要迁移任何数据。

迁移数据库

1. SQLite → SQLite：只需要复制数据库目录下（默认为 data）下的 .db 文件即可
2. 其他组合（例如 SQLite → MySQL / PostgreSQL，或相反）：请在使用 ezBookkeeping 初始化新的数据库后，使用第三方工具将之前数据库的数据迁移到新的数据库中

ezBookkeeping 建议仅测试时使用 SQLite 数据库。如果您确定使用 ezBookkeeping，最好使用 MySQL 或 PostgreSQL 数据库，以避免后续迁移的成本。

迁移对象存储

1. local_filesystem → local_filesystem：只需要复制对象存储目录下（默认为 storage）下所有文件即可
2. 其他组合（例如 local_filesystem → minio / webdav，或相反），请在使用 ezBookkeeping 初始化新的对象存储目录后，使用第三方工具将存储的文件进行同步

ezBookkeeping 是否提供电脑桌面应用或手机 App

ezBookkeeping 是一个自托管的软件，通过你的浏览器进行访问，并不提供独立的桌面应用或手机 App。ezBookkeeping 为移动设备和电脑桌面提供了两套原生的用户界面，在手机上你可以将 ezBookkeeping 添加到主屏幕，使用体验如同手机原生应用。

如何将 ezBookkeeping 添加到手机主屏幕

ezBookkeeping 支持 PWA（Progressive Web Apps），你可以使用系统浏览器将其添加到手机屏幕，系统会自动缓存必须的静态文件。从手机主屏幕直接打开 ezBookkeeping 时会像手机原生应用一样。

详细步骤，参考教程。

ezBookkeeping 的默认用户是什么

在你第一次启动 ezBookkeeping 服务端后，ezBookkeeping 的数据库是空的，你需要新注册一个账号。ezBookkeeping 没有默认账号。

为什么无法添加交易

ezBookkeeping 中的每一笔交易都需要包含账户和交易分类，并且交易分类是按交易类型分为支出分类、收入分类和转账分类，每一笔交易都需要设置一个分类的二级分类。如果你还没有创建账户和对应交易类型的二级分类，则无法创建新的交易。

如何记录退款

你可以创建一笔支出交易，交易金额为负数。

转账交易如何记录手续费

你可以创建一笔单独的支出交易，交易金额为手续费的金额。

如何记录别人借我的钱

你可以创建一个账户分类为 “应收款项” 的账户，然后创建一笔从你支出账户到该应收款项账户的转账交易。如果你在 ezBookkeeping 创建了默认的交易分类，你可以选择 “贷款债务 > 借出” 交易类型。

如何修改账户余额

ezBookkeeping 只允许用户创建新账户时设置期初余额。在账户创建后，用户不能直接修改其余额。如果需要调整账户的余额，你需要记录一笔支出或收入交易。

当然，你可以在对账单页面中更新期末余额，系统会自动计算预期期末余额与实际余额的差异，并将金额填写到创建新交易的页面中。

添加交易时无法设置货币信息

ezBookkeeping 的货币信息不与每笔交易所关联，而是与账户所关联，每一个账户有且只能有一个货币。如果你现实中的账户支持多种货币，你可以将该账户的账户类型设置为 “多个子账户”，然后为每个货币设置一个子账户。

如何修改添加交易时默认的账户

进入用户信息修改页面，可以修改创建新交易时默认使用的账户。

如何更改金额的颜色

进入用户信息修改页面，可以更改支出与收入金额的颜色。

移动版如何编辑、删除交易、账户

在 ezBookkeeping 移动版中，你可以在交易、账户的列表页面的每项内容左滑，即会出现 “编辑”、“删除” 按钮，轻触 “编辑” 即可进入编辑页面。

如何使用交易模板创建交易

1. 在移动版中，长按主界面底部导航栏的创建交易按钮，弹出的列表中包含用户创建的交易模板，轻触即可使用该模板创建交易
2. 在桌面版中，将鼠标移动到交易列表页的添加交易按钮，下拉列表中包含用户创建的交易模板，点击即可使用该模板创建交易

如何使用AI识图创建交易

首先，需要设置大语言模型（LLM）设置。在 llm 节中启用 transaction_from_ai_image_recognition 以允许AI识图创建交易。然后在 llm_image_recognition 节中设置 llm_provider 以及对应大语言模型提供者的 API Key、模型ID等设置。请确保指定的模型支持图片识别。更多信息见 配置-大语言模型 (LLM)。

在完成设置大语言模型的配置后，

1. 在移动版中，长按主界面底部导航栏的创建交易按钮，轻触弹出列表中的 “AI识图” 即可
2. 在桌面版中，将鼠标移动到交易列表页的添加交易按钮，点击下拉列表中的 “AI识图” 即可

定时交易没有自动创建新的交易

ezBookkeeping 的定时交易当到达预定日期时会自动创建一笔交易，这笔生成的交易与用户自己创建的交易完全相同。在预定日期到达之前，没有交易会被创建。你需要保持 ezBookkeeping 的服务端一直运行。

为什么上传的用户头像和交易图片无法显示

请确保配置中的 domain 设置正确，如果你使用了 Nginx 等反向代理，并且访问协议或端口号与 ezBookkeeping 服务端提供的不同，还需要修改 root_url，具体请参考 配置-服务器。ezBookkeeping 中用户上传的用户头像、交易图片的地址均依赖上述地址。

如果完成了上述设置，但图片依然无法显示，你可以通过浏览器的开发者工具检查图片的地址是否与设置的地址相同。如果不同请检查 ezBookkeeping 启动时输出的配置文件的内容是否与预期的一致，如果不同请检查设置或重新启动 ezBookkeeping。

为什么总金额时不包含特定货币的金额

ezBookkeeping 计算不同货币的总金额时依赖汇率数据，你需要确保当前用户的默认货币和所有参与计算总金额的货币均包含在当前汇率数据中。你可以参考 汇率 设置汇率数据源。

为什么删除交易后数据库里的记录没有删除

为了尽可能减少误删除后数据恢复的难度，ezBookkeeping 中交易、账户、分类和标签的删除操作都是逻辑删除，删除后只会在数据库中标记为删除，并不会真实从数据库物理删除这条记录。

为什么删除交易图片后对象存储里的图片文件没有删除

为了尽可能减少误删除后数据恢复的难度，ezBookkeeping 中交易图片的删除操作都是逻辑删除，只会对数据库中的交易图片记录标记为删除，并不会从数据库中物理删除交易图片记录，也不会物理删除对象存储中的图片文件。

如何修改验证邮件或密码重置邮件中的内容

你可以直接修改 ezBookkeeping 目录中 templates/email/ 目录下的 .tmpl 文件。如果使用 Docker 部署 ezBookkeeping，也可以直接将修改后的文件挂载到该目录下。需要保证该文件有权限被 ezBookkeeping 的进程启动用户读取。修改后需要重新启动 ezBookkeeping 服务端程序生效。

如何修改AI识图等请求大语言模型（LLM）的提示词

你可以直接修改 ezBookkeeping 目录中 templates/prompt/ 目录下的 .tmpl 文件。如果使用 Docker 部署 ezBookkeeping，也可以直接将修改后的文件挂载到该目录下。需要保证该文件有权限被 ezBookkeeping 的进程启动用户读取。修改后需要重新启动 ezBookkeeping 服务端程序生效。

ezBookkeeping 使用了哪些第三方服务，以及是否会使用我的个人数据

ezBookkeeping 中的汇率数据、地图以及大语言模型（LLM）服务依赖第三方服务，具体如下：

1. 汇率数据：当用户使用 ezBookkeeping 的汇率数据时，会通过 ezBookkeeping 的服务端程序获取你指定的汇率数据源数据，获取过程不包含当前用户或用户使用 ezBookkeeping 的设备和浏览器的任何信息
2. 地图：当用户使用 ezBookkeeping 中的地图功能查看交易位置时，用户的浏览器或 ezBookkeeping 的服务端程序会获取第三方的地图数据，获取过程中包含用户浏览器的 User-Agent，即会包含用户的设备和浏览器信息，但不包含具体的位置及 ezBookkeeping 用户信息。如果你的地图提供者设置为 Google 地图、百度地图或高德地图，ezBookkeeping 使用地图提供者的官方 JavaScript SDK，虽然 ezBookkeeping 本身不会与这些服务共享任何用户信息，但地图提供者可能会收集用户的浏览器、设备及位置数据，详情请参考地图提供方的隐私策略
3. 大语言模型-AI识图：当用户使用 ezBookkeeping 的AI识图功能时，ezBookkeeping 会将上传的收据图片以及用户所有的交易分类名称、账户名称和交易标签名称数据发送给大语言模型提供者。ezBookkeeping 默认不启用AI识图功能，同时 ezBookkeeping 建议使用自托管的大语言模型服务。如果你使用第三方的大语言模型服务，请注意潜在的隐私风险，并采取措施减少数据的泄露（例如，上传收据图片前去除敏感信息，以及避免在交易分类名、账户名、交易标签名中存储敏感信息等）