README EN

OpenBookkeeping是一个利用定期对账来跟踪个人资产负债的开源项目，并且可以绘制丰富的报表，包括资产负债的变化、未来现金流的预测等。

主要特点

• 每月对账一次，避免繁琐记账
• 丰富的报表，帮助对当前财务状况进行评估
• 对过往的资产负债情况进行跟踪，并能查看明细
• 对各项资产负债的现金流进行汇总，预测资产负债的变化
• 开源、免费、自部署，支持docker部署
• 基于sqlite的本地数据管理，保证安全与隐私

安装方式

在debian系linux服务器直接安装

在debian linux服务器上执行以下命令：

git clone git@github.com:nutalk/OpenBookkeeping.git
pip install --no-cache-dir -r requirement.txt
sudo apt install -y gettext
sudo mkdir /data
sudo chmod -R 777 /data
bash docker/init_run.sh

通过docker安装

sudo mkdir /path_to_data
sudo chmod -R 777 /path_to_data
docker pull nutalk/bookkeep:main
docker run -p 7788:7788 -v /path_to_data:/data nutalk/bookkeep:main

安装完成后

打开浏览器，通过http://ip:7788 访问项目主页。

在/path_to_data或者/data目录，你能找到一个db.sqlite3文件，里面是所有的数据文件，记得定期进行备份。

如果希望使用django自带的后台，账号密码如下：

user: admin
password:77887788

数据导出

OpenBookkeeping 支持将数据导出为 JSON 格式，方便迁移到其他系统（如 my_bookkeep）。

导出方法

在项目根目录执行：

python export_data.py

默认会在当前目录生成 export.json 文件。

自定义导出路径

python export_data.py --output /path/to/export.json

指定数据库文件

如果数据库不在默认位置，可以通过 --db 参数指定：

python export_data.py --db /data/db.sqlite3 --output ./export.json

导出 JSON 格式说明

{
"version": "1.0",
"exported_at": "2026-06-09T12:00:00",
"source": "OpenBookkeeping",
"summary": {
"total_props": 5,
"total_details": 50,
"total_assets": 5000000,
"total_liabilities": 2000000,
"net_worth": 3000000
},
"props": [
{
"id": 1,
"name": "账户名称",
"p_type": 0,
"start_date": "01/06/2023",
"term_month": 360,
"rate": 3.8,
"currency": 5000,
"ctype": 1,
"comment": "备注",
"activate": true,
"details": [
{
"id": 1,
"occur_date": "01/06/2023",
"amount": 3000000,
"comment": "初始金额"
}
]
}
]
}

• p_type: 0=固定资产, 1=流动资产, 2=长期负债, 3=流动负债
• ctype: 0=固定现金流, 1=等额本息, 2=先息后本, 3=等额本金, 4=到期还本付息

截图

账户清单页面

每月对账页面

账户概述报表

资产负债的现金流推演