NAS记账，支持支付宝微信京东账单导入，铁威马部署Cashbook

大家好，这里是Cherry，喜爱折腾、玩数码，热衷于分享自己的数码玩耍经验~

前言

年后第一个月马上就要结束了，大家伙都拿到新年的第一份工资了吗？！

和往年一样，在新年新开始的时候，我都会对去年全年的收入和支出做一个分析，看看全年最大一笔支出在哪里，看看什么类目是我一年中最花钱的部分，以及看看今年能不能在哪里多省一点儿。

毕竟作为一个吃一半玩一半，买块硬盘又一半的我来说，月光的生活着实难过。

cherry曾经下载过随手记等记账类app，但是因为种种原因都无法坚持下来，要不就是琐碎记账太麻烦，要不就是支付途径没办法导入APP，要不就是担心自己的隐私数据被app后台收集。

在翻了一圈github之后，我找到了一款支持支付宝、微信、京东金融账单导入的本地化记账工具——Cashbook。它是一款基于Docker部署的开源、免费、Web记账软件。

项目特性：

• 前台后台分离，独立后台方便对系统进行管理；

• 支持支付宝CSV 个人账单文件导入；

• 支持微信CSV 个人账单文件导入；

• 支持京东金融CSV 个人账单文件导入；

• 数据导入时，消费类型自动映射转换；

• 直观的消费日历看板；

• 美观的数据分析图表：支出类型统计饼图、支付方式统计饼图、每日流水统计曲线图、每月流水统计柱状图；

• 每个用户可以有多个账本，其账本之间数据独立；

• 上传小票图片；

• 数据快速迁移（导入/导出）；

一、服务部署教程

1、部署机

本项目使用的部署设备是铁威马F6-424 Max。该设备为6盘位NAS，搭载I5-1235U处理器，10核12线程的超强处理能力，能帮助极客和小型团队用户处理各式各样的并发任务。

数据接口方面，F6-424 Max同样给力，双万兆网口 + 双 USB 3.2 + 单 Type-C USB + HDMI，扩展性和数据交互途径也非常多。

2、下载/导入镜像

本项目涉及到数据库postgre和本体两个镜像，我已经上传到阿里和夸克网盘中了，如果网络不好的同学可以自行下载导入。

阿里云盘：https://www.alipan.com/s/4mxoa6oX5rQ

夸克网盘：https://pan.quark.cn/s/5bdfc38417cd

打开铁威马NAS私有云的Docker Manager应用，点击镜像-导入。

3、配置并启动容器

根据下面的yaml文件注释，大家按照自己的要求修改一下【自行修改！】的地方。当然，如果内网运行不修改也没事。

services:

main:

container_name: cashbook4

depends_on:

- "db"

image: dingdangdog/cashbook:latest

restart: always

# network_mode: "host"

volumes:

- ./data:/app/data

environment:

# ↓ 数据库连接URL 【请自行修改！与下面数据库一致】

DATABASE_URL: "postgresql://postgresuser:password@cashbook_db:5432/cashbook?schema=public"

NUXT_DATA_PATH: "/app/data"

# ↓ 服务根路径，需要加上端口号

NUXT_APP_URL: "http://192.168.2.67:29090"

# ↓ 登录授权相关接口地址 【自行修改！以 /api/auth 结尾】

NUXT_AUTH_ORIGIN: "http://192.168.2.67:29090/api/auth"

# ↓ 前台登录加密使用的密钥 【自行修改！】

NUXT_AUTH_SECRET: "auth_secret"

# ↓ 后台登录用户名

NUXT_ADMIN_USERNAME: "admin"

# ↓ 【自行修改】加密的后台登录密码，生成密码可前往`URL/admin/GetPassword`

NUXT_ADMIN_PASSWORD: "fb35e9343a1c095ce1c1d1eb6973dc570953159441c3ee315ecfefb6ed05f4cc"

ports:

# ↓ 账本开放端口 【自行修改！】

- 29090:9090

db:

container_name: cashbook_db

image: postgres

restart: always

shm_size: 128mb

volumes:

- ./db:/var/lib/postgresql/data

environment:

# ↓ 数据库用户名【自行修改！与上方DATABASE_URL一致】

POSTGRES_USER: postgresuser

# ↓ 数据库密码【自行修改！与上方DATABASE_URL一致】

POSTGRES_PASSWORD: password

接着，打开Docker-项目，给项目取个名cashbook，选择好项目路径后，重新创建YAML文件，然后把修改好的compose文件复制进来，验证Yaml并一键部署！

二、系统体验

1、后端配置

系统启动以后，我们首先登陆后端进行配置。首先登陆后端密码生成地址http://192.168.2.67:29090/admin/GetPassword，在这里配置自己的后台admin账号密码点击加密。

把生成的加密密码，替换compose文件中的NUXT_ADMIN_PASSWORD中，然后重新部署该项目。

重新部署完成以后，登陆后台管理地址http://192.168.2.67:29090/admin/，输入账号密码登录。登陆以后，可以在系统设置中，自由选择是否开放前台注册。

在后台中有一个比较重要的模块，叫做类型数据。就是将支付宝、微信、京东金融中的类型，映射为我们自己需要的类型（默认为全映射关系）。

比如将原有的餐饮美食、食品餐饮映射为吃东西，把退款映射成赚到钱啦等等。这样可以方便大家更有针对性的管理费用类型。

配置好后台以后，我们最后再来给前台使用系统注册账号。Cashbook支持多账号使用，每个人的数据都是不互通的，所以就算给家里人用也不怕泄露自己的隐私~

2、各平台个人账单导出的方法

虽然cashbook是支持手动录入费用的，但是对于移动支付时代的我们来说，基本上所有的费用都会通过阿里系、京东系、腾讯系支出，所以我们只需要学会如何导入账单就可以了。

1️⃣支付宝平台：

打开支付宝平台，选择我的-账单，右上角点击三个点，然后点击开具交易流水证明，选择个人对账使用，框定好范围后导出即可。

导出的时候，账单会发送到我们的电子邮箱里，随后支付宝服务消息中会提供一个解压密码，大家下载后解压密码解压即可。这个解压密码过了7天就会失效。

2️⃣微信平台：

微信上，点击服务-钱包进入账单页面，点击右上角账单，常见问题，下载账单。

用途依旧选择个人对账，在框选后范围以后将账单发送到邮箱里。同样的，微信会在微信支付消息通知里提供一个解压密码用于解压账单。

3️⃣京东金融平台：

京东金融主要服务于京东app，在我的-我的账单里，点击右上角三个点，选择账单导出（个人对账），然后框选范围会发送到邮箱，同样会提供一个解压密码。

3、前端使用

最后，我们来到cashbook的前端http://192.168.2.67:29090，使用后台分配的账号密码登录。

初次登陆需要创建一个账本。

点击流水管理-新增，可以以手动记录的方式记录我们的日常花费，这里的类型就是我们后台维护的映射完以后的类型。不多说，这个功能一般用不上。

核心功能在于流水管理的导入导出，可以看到一共有5个功能，前面三个分别是三大平台的CSV数据表导入功能。下方是Json格式的导入和导出，用于迁移、备份数据。

我这里导入了一张支付宝的账单，所有的明细都在表格里会展示，没问题点击确认导入。

三份账单都导入以后，点击数据分析模块，可以看到我们所有的花费和收入都已经被分到了饼状图、波形图、柱形图中，分别是支付类型统计、支付方式统计、每日流水统计、每月流水统计。

QQ_1739694618217.png

单独的流水都可以点开查看细则，这样我们就能知道，到底我每个月的钱都花在哪里了。

在项目首页，我们还可以根据月、日来查看当月、当日的最大支出和收入。

总结

作为一款自托管的记账工具，cashbook在某些程度上比各类app还好用。一是在于项目本身是免费开源的，不害怕数据泄露。二是电脑端的操作远远比手机端简单，对果子系更友好。

NAS现在作为家庭服务中心设备，已经越来越往家电产品的方向靠拢了，除了我们日常需要的数据存储、共享，以及目前比较成熟的家庭智能中枢外，把它作为第三方应用中心的玩法也越来越多。

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