Whisper Money快速上手：从1条命令到Docker部署的完整教程，5分钟跑起你的私人财务中心-开发者社区

【免费下载链接】whisper-money

Understand your personal finances. Forget Excels, try Whisper Money.

项目地址：https://gitcode.com/gh_mirrors/wh/whisper-money

Whisper Money 是一款注重隐私的开源个人财务管理应用，帮你记录、分类并理解自己的每一笔支出。本文带你完成 Whisper Money 快速上手：从 1 条命令本地安装，到 Docker 生产镜像部署，5 分钟就能跑起属于自己的私人财务中心。

Whisper Money 是什么？

一句话概括：Forget Excels, try Whisper Money—— 用更优雅的方式告别 Excel 记账。它的核心能力包括：

🔐隐私优先：数据完全归你所有，支持自托管，AI 功能可指向本地模型
🏦多账户管理：手动录入、CSV/Excel 导入，或通过开放银行（Open Banking）直连银行同步
🤖自动分类 + 自动化规则：AI 自动分类交易，规则引擎持续"越用越聪明"
📈财务洞察：现金流分析、预算管理、储蓄目标、月度 AI 报告

技术栈对新手很友好：后端 Laravel 12 + PHP 8.4，前端 React 19 + Inertia.js，数据库 MySQL，缓存/队列 Redis。

第一步：准备部署环境

部署 Whisper Money 需要以下依赖（官方安装脚本会逐项检查，详见 public/setup.sh）：

依赖	版本要求	用途
Git	任意	拉取代码
Docker + Docker Compose	任意	运行 MySQL、Redis 等服务
PHP	≥ 8.2	运行 Laravel 应用
Composer	任意	安装 PHP 依赖
Bun 或 Node.js	任意	构建前端资源

💡 只打算跑Docker 生产镜像的话，机器上只需要 Docker 即可，其余依赖全部打包在镜像里。

第二步：1 条命令快速安装（本地开发模式）

先克隆仓库：

git clone https://gitcode.com/gh_mirrors/wh/whisper-money cd whisper-money

然后运行仓库根目录下的 CLI 脚本 whispermoney，执行安装：

whispermoney install

这一条命令会自动完成全部初始化工作：

复制.env.example生成.env，并配置好APP_URL、数据库与 Redis 地址
启动 Docker 服务：MySQL、Redis、MailHog（本地收信测试）
生成APP_KEY应用密钥
安装 Composer 与前端依赖，构建 Vite 前端资源
执行数据库迁移（migrations）
配置 Portless 本地 HTTPS 代理

完成后，打开浏览器访问https://whisper.money.localhost即可（未启用 HTTPS 时可用http://localhost:8000），注册账号就是你的私人财务中心入口。

⚠️ 重要提示：必须先运行whispermoney install，之后再使用start、stop等命令，否则服务无法启动。

第三步：用 Docker 部署生产镜像

想在服务器或家里的小主机上正式运行，官方提供了生产 Compose 文件 docker-compose.production.yml，只包含两个服务：应用容器 + MySQL 8.0（Redis 已内置在镜像中），并带数据卷持久化。

1. 复制并修改生产环境配置

cp .env.production.example .env

打开.env，至少修改这几项（完整说明见 .env.production.example 里的中文注释）：

APP_URL=https://你的域名或IP DB_PASSWORD=你的强密码

APP_KEY留空没关系——容器首次启动时会自动生成。

2. 一条命令启动

docker compose -f docker-compose.production.yml up -d

打开http://localhost:8080即可访问。想换端口很简单：

APP_PORT=3000 docker compose -f docker-compose.production.yml up -d

3.（可选）一键部署到 Coolify

如果你在用 Coolify 管理自托管服务，仓库自带了现成模板 templates/coolify/whisper-money.yaml：在 Coolify 中新建 Docker Compose 资源 → 选择 Empty Compose File → 粘贴模板内容 → 部署，数据库凭据与数据卷都会自动配好。

日常运维：常用命令速查表

安装完成后，whispermoney就是你的日常运维入口：

命令	作用
`whispermoney start`	启动全部 Docker 服务
`whispermoney stop`	停止全部服务
`whispermoney upgrade`	拉取最新代码、更新依赖、执行迁移并重建前端
`whispermoney logs php`	查看 PHP 服务日志（也可换成`mysql`）
`whispermoney`（不带参数）	打开交互式菜单

脚本还内置了端口冲突自动避让：若 MySQL 默认端口 3307 被占用，会自动寻找空闲端口写回.env，不用手动改配置。

部署完成后：核心功能抢先看

📁导入历史账单：把银行导出的 CSV / Excel 直接拖进上传区，官方文档示例如下：

按向导把文件列映射到"日期、描述、金额"等字段，确认后数据即刻入库，还能在设置里一键撤销导入：

🤖AI 月度财务报告：应用会按月生成 AI 摘要，清晰告诉你净资产变化、支出占比与预算达成情况，告别自己翻账单：

🔒本地化 AI（隐私党福音）：默认 AI 提供商是 Gemini，但只需在.env里设置AI_PROVIDER=ollama并指定OLLAMA_URL，AI 处理就完全留在你自己的机器上，数据一步不出内网。

常见问题速答

端口被占用怎么办？开发模式由脚本自动避让；生产模式把APP_PORT改成空闲端口即可。
升级会丢数据吗？不会。数据存在whisper-mysql（数据库）与whisper-storage（文件存储）两个 Docker 命名卷中，whispermoney upgrade只更新应用本身。
没有银行连接能用吗？能。Open Banking 是可选的付费第三方服务，默认关闭；手动建账户 + 导入账单即可完整使用，券商/交易所（Coinbase、Binance、Wise 等）走各自 API key，不经过第三方。

总结

Whisper Money 提供了两条低门槛的部署路径：本地用whispermoney install1 条命令拉起开发环境；生产环境用docker compose -f docker-compose.production.yml up -d一键上线。5 分钟之后，你拥有的就是一个数据完全自持、支持 AI 洞察的私人财务中心。剩下的，就是把你的第一份账单导进去，开始了解你的钱都去哪儿了 🚀