什么是 cashbook ?
cashbook
是一个私人或家庭记账程序,支持私有化部署,商用或其他使用不受约束。建议使用者每年创建一个账本,图表功能可以起到分析全年数据的效果。
官方提供了演示站点,但不建议记录真实数据
- 演示账本钥匙:
fScrX9FwtiE
地址: https://cash.oldmoon.top
安装
环境变量
与 mongo
相关的环境变量
变量 | 缺省值 | 描述 |
---|---|---|
TZ | 无 | 时区 |
MONGO_INITDB_ROOT_USERNAME | 无 | 数据库root用户名 |
MONGO_INITDB_ROOT_PASSWORD | 无 | 数据库root用户的密码 |
与 cashbook
相关的环境变量
变量 | 缺省值 | 描述 |
---|---|---|
TZ | Asia/Shanghai | 时区 |
CASHBOOK_ENVIRONMENT | personal | 个人 |
CASHBOOK_MONGODB_URL | mongodb://localhost:27017/cashbook?authSource=admin | 数据库链接地址 |
CASHBOOK_MONGODB_URL
:一般是 mongodb://[username:password@]host1[:port1][/[database][?options]]
,含义如下:
username:password@
:可选项,表示MongoDB
的用户名和密码,用于进行身份验证。host1[:port1]
:必选项,表示MongoDB
数据库所在的主机和端口号。/database
:可选项,表示连接到MongoDB
的哪个数据库。?options
:可选项,表示连接MongoDB
的其他选项,例如连接超时时间、读写权限等。
docker cli 安装
如果你熟悉命令行,可能用 docker cli
更快捷
# 新建文件夹 cashbook 和 子目录
mkdir -p /volume2/docker/cashbook/data
# 进入 cashbook 目录
cd /volume2/docker/cashbook
# 运行 mongo 容器
# 注意:老苏没有对外暴露端口
docker run -d \
--restart unless-stopped \
--name cashbook_db \
-v $(pwd)/data:/data/db \
-e TZ=Asia/Shanghai \
-e MONGO_INITDB_ROOT_USERNAME=cashbook \
-e MONGO_INITDB_ROOT_PASSWORD=yourpassword \
mongo:4.4.0
# 运行 cashbook 容器
docker run -d \
--restart unless-stopped \
--link cashbook_db:mongo \
--name cashbook_web \
-p 5680:80 \
-e TZ=Asia/Shanghai \
-e CASHBOOK_ENVIRONMENT=personal \
-e CASHBOOK_MONGODB_URL=mongodb://cashbook:yourpassword@mongo:27017/cashbook?authSource=admin \
dingdangdog/cashbook:latest
docker compose 安装
也可以用 docker-compose
安装,将下面的内容保存为 docker-compose.yml
文件
version: "3"
services:
cashbook:
image: dingdangdog/cashbook:latest
container_name: cashbook_web
restart: always
ports:
- 5680:80
environment:
TZ: "Asia/Shanghai"
CASHBOOK_ENVIRONMENT: "personal"
CASHBOOK_MONGODB_URL: "mongodb://cashbook:yourpassword@mongo:27017/cashbook?authSource=admin"
mongo:
image: mongo:4.4.0
container_name: cashbook_db
restart: always
volumes:
- ./data:/data/db
environment:
TZ: "Asia/Shanghai"
MONGO_INITDB_ROOT_USERNAME: cashbook
MONGO_INITDB_ROOT_PASSWORD: yourpassword
然后执行下面的命令
# 新建文件夹 cashbook 和 子目录
mkdir -p /volume2/docker/cashbook/data
# 进入 cashbook 目录
cd /volume2/docker/cashbook
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d
运行
在浏览器中输入 http://群晖IP:5680
就能看到主界面
第一次直接点 创建
输入账本的名称后确定
生成的秘钥,一定要妥善保管
2mf41jdGPvi
新增流水
点 新增
开始输入
确定之后
又随便编了几条数据
日消费统计曲线
打开 日消费统计曲线
,这是按 日期
统计的数据
消费类型统计饼图
打开 消费类型统计饼图
,这是按 消费类型
统计的数据
消费日历
打开 消费日历
,能看到哪天有消费
退出
只要 关闭账本
即可,系统很贴心的会再次展示 账本秘钥
如果你还没保存
账本秘钥
,一定要保存好
确定后就回到了初始界面
你可以创建新的账本
也可以输入 账本秘钥
打开已有的账本
移动端
网页在手机浏览器上也是可以用的
如果你觉得软件能满足你的需要,可以考虑去给作者打个赏,让作者有动力继续完善和更新下去。
参考文档
dingdangdog/cashbook: cashbook(记账本)
地址:https://github.com/DingDangDog/cashbook