开源记账本自建部署，Cashbook账目管理完全自主可控，NAS极简搭建多人共享记账
作者
小编
发布时间
Cashbook 记账本 - 开源记账应用部署指南
项目介绍
Cashbook 是一款开源的个人记账应用，致力于让财务管理变得简单、易用且完全自主可控。项目采用前后台分离架构，基于 Node.js 和 Nuxt 框架构建，支持多种数据库（PostgreSQL、MySQL、SQLite、SqlServer）。
无论是日常小额支出还是复杂账目统计，Cashbook 都能帮你轻松搞定。它提供了直观的消费日历看板、美观的数据分析图表、支付宝/微信/京东账单导入等实用功能。支持多用户模式和共享账本，让你和家人朋友一起管理账目。界面简洁美观，支持明暗主题切换，完美适配移动端。
项目地址：点我跳转
官方文档：https://doc.cashbook.oldmoon.top
部署安装
如果你想在外网也能访问这个记账本，建议配置内网穿透服务。推荐使用 帕斯内网穿透，先注册好账号备用。具体操作可以参考 内网穿透全平台快速上手教程，几分钟就能搞定。
使用 Docker 快速部署
打开你的 NAS 设备（飞牛、群晖等）或本地 Docker 环境，找到本地镜像管理页面。
点击 添加镜像 - 从 URL 添加，在镜像地址栏填入：
1dingdangdog/cashbook:latest
等待镜像下载完成后，点击启动按钮创建容器。
端口配置
在容器设置中配置端口映射。Cashbook 默认运行在容器内的 9090 端口，你可以将其映射到主机的任何可用端口（比如 9090、8080 等）。如果提示端口已被占用，只需修改主机端口号即可，容器内部端口保持 9090 不变。
存储配置
Cashbook 需要持久化存储数据。请在 NAS 上创建一个文件夹（比如 `/volume1/cashbook/data`），然后将其映射到容器内的 `/app/data` 目录。这样即使容器重启，你的账目数据也不会丢失。
环境变量设置
以下是可配置的关键环境变量：
必须设置：
DATABASE_URL：数据库连接字符串（如果使用外部数据库）
NUXT_ADMIN_USERNAME：后台管理员账号（默认：admin）
NUXT_ADMIN_PASSWORD：后台管理员密码（建议修改默认值）
NUXT_AUTH_SECRET：认证密钥（建议修改）
可选设置：
PORT：应用运行端口（默认：9090）
NUXT_DATA_PATH：数据存储路径（默认：/app/data）
其他变量保持默认即可。特别提醒：如果要部署到公网，一定要修改默认的管理员账号密码和认证密钥！
勾选 开机自动启动 后，点击启动容器。
访问应用
容器启动成功后，打开浏览器访问：
1http://你的NAS地址:9090
即可看到 Cashbook 的登录页面。首次使用可以注册新账号，或使用体验账号 `cashbook`/`cashbook` 登录。
后台管理地址为：
1http://你的NAS地址:9090/admin
使用你设置的管理员账号（默认 `admin`/`admin123456`）登录后台进行系统管理。
功能特性速览
✅ 前后台分离设计，独立后台管理系统
✅ 用户注册与多用户隔离
✅ 支付宝、微信、京东账单一键导入
✅ 直观的消费日历看板
✅ 丰富的数据分析图表（支出统计、流水分析等）
✅ 多账本管理，账本间数据独立
✅ 共享账本功能，支持多人协作
✅ 小票图片上传
✅ 账本数据导入导出
✅ 自助平账功能
✅ 明暗主题切换
✅ 完美适配移动端
总结
通过上述步骤，你已经成功部署了 Cashbook 记账本。现在可以开始记录你的每笔支出，通过精美的图表分析你的消费习惯。如遇到问题，可以查阅 官方文档 或加入 QQ 交流群 564081656 获取帮助。
祝你使用愉快！