共计 5459 个字符,预计需要花费 14 分钟才能阅读完成。
自己的账,放在自己的机器上
Maybe Finance 社区分叉 · Docker 自托管 · Linux 实测 v0.7.6
Sure 自建记账实测
📦 这篇分 6 段,外加一段收尾:
- PART 01 Sure 是什么 → 能干什么、不能干什么
- PART 02 准备 → 一台能跑 Docker 的机器
- PART 03 部署 → 官方 compose 文件,三步起服务
- PART 04 第一次打开 → 注册和三步引导
- PART 05 两种货币进同一个账本 → 设好汇率源,净资产按真实汇率显示
- PART 06 记一笔人民币支出 → 金额旁边把币种改成 CNY
- 收尾 → 备份、更新,适合谁
· · ·
工资进美国的支票账户,国内还有一张储蓄卡,两边的钱我一直没在一个地方看过。这次试的工具叫 Sure,一个开源的个人记账和资产管理网站:装在你自己的电脑、NAS 或云服务器上,用浏览器打开就能记账、看现金流,还能把不同货币的账户换算成一笔净资产。
它要解决的事情很朴素。记账软件要么按年收会员费,要么要你把银行流水交给别人的服务器。Sure 自己搭,不交钱,数据在你自己的硬盘上。
它的前身叫 Maybe Finance。按 README 的说法,原团队在 2021 到 2022 年花了将近 100 万美元做这个产品,生意没做成,2023 年中停了开发,后来把代码开源。Sure 是社区接手继续维护的分支,协议是 AGPL-3.0。
最近一天它在 GitHub 日榜上涨了 1,078 颗星,我写这篇时总数是 12,938。我在 Linux 测试机上把它搭起来,把那两张卡记了进去。设好免费汇率源并同步之后,首页净资产显示 $6,200.60:3,200 美元,加上 2 万人民币按 1 人民币兑 0.15003 美元折算。下面按顺序写怎么搭、怎么把两种货币记进同一个账本。

▲ 示意图:两种货币的账户进同一个账本,按真实汇率换算成一笔净资产
· · ·
PART 01
Sure 是什么
简单讲,它是一个自己托管的记账网站,界面现成,你只管往里记。功能大致这些:
- 记账户:现金、银行卡、投资、加密资产、房产、车辆、贷款、信用卡都能建
- 记交易:支出、收入、转账,自带 22 个默认分类
- 看报表:净资产走势、现金流、按分类的支出,还有预算
- 多币种:每个账户可以用不同货币,首页按你设定的主货币换算
- 可选的 AI 助手:要自己填 OpenAI 等模型的密钥,不填也不影响记账
客户端方面,README 写的是浏览器、macOS 桌面端、手机端、API 都能连。我这次只用了浏览器。

▲ 截图来源:GitHub we-promise/sure 仓库页(北京时间 2026 年 11 月 12 日上午)
🍎 先说清楚它不是什么
它不是手机记账 App,也没有对接微信、支付宝。导入功能认 CSV,另外能从 Mint、YNAB、Actual Budget、Quicken 导入,国内账单得自己整理成 CSV。国外银行可以接 SimpleFIN、Wise 等同步服务,但要另外开通。我这篇全部是手动记账。
· · ·
PART 02
准备
需要一台能跑 Docker 的机器。家里的 NAS、闲置小主机、一台云服务器都行。
我这次的环境:
- Debian 13 的 Linux 测试机,8 核、16GB 内存
- Docker 29.9.3,带 docker compose 插件
跑起来之后我用 docker stats 看了内存:网页服务约 494MB,后台任务约 414MB,数据库 103MB,Redis 26MB,加起来 1GB 出头。三个镜像下载下来一共 1.5GB 左右。
🍎 内存建议 2GB 起步
我这台测试机是 16GB,实际占用大约 1GB 出头。1GB 内存的小云服务器会比较吃紧,建议 2GB 起步。1GB 的机器我没有实测过。
还没装 Docker 的话,先按 Docker 官方文档装好,用 docker run hello-world 能跑通再往下走。
· · ·
PART 03
部署
官方推荐的就是 Docker Compose,一共三步。
下载 compose 文件 → 写 .env 改密钥 → docker compose up -d
第 1 步:建目录,下载官方 compose 文件
mkdir -p ~/docker-apps/sure
cd ~/docker-apps/sure
curl --fail --location --silent --show-error --output compose.yml https://raw.githubusercontent.com/we-promise/sure/main/compose.example.yml预期结果:目录里多了一个 compose.yml,里面定义了 web(网页)、worker(后台任务)、db(PostgreSQL 16)、redis 四个服务,另外还有备份用的服务,默认不启动。
第 2 步:写 .env,换掉默认密钥
官方说只在局域网自己玩可以跳过这步。我的建议是别跳,因为 compose 文件里自带一串默认的 SECRET_KEY_BASE,谁都能在 GitHub 上看到。
curl --fail --location --silent --show-error --output .env https://raw.githubusercontent.com/we-promise/sure/main/.env.example
openssl rand -hex 64把生成的那串字符填进 .env,再给数据库设一个密码:
SECRET_KEY_BASE="刚才生成的那一长串"
POSTGRES_PASSWORD="你自己定的数据库密码"预期结果:.env 和 compose.yml 在同一个目录。
第 3 步:启动
docker compose up -d
docker compose ps预期结果:db 和 redis 显示 healthy,web 和 worker 显示 Up。浏览器打开 http://服务器IP:3000。
我这边拉镜像用了 25 秒,up -d 六秒多就起来了。镜像放在 ghcr.io,国内网络拉起来可能慢很多,这一条我没有在国内网络环境实测过。

▲ 我的测试机上 compose 启动后的真实输出
🍎 精简 VPS 上起不来,先看 iptables
我的测试机是精简过的 Linux,没装 iptables,Docker 服务一启动就退出,日志里写着 iptables not found。正常的 VPS 和 NAS 一般自带 iptables,通常碰不到这件事。真遇到了,先把 iptables 装上再启动 Docker。
我这台装不上,只好关掉 Docker 的 iptables 功能,再让四个服务改走 host 网络才跑起来。这是将就的办法,不建议照搬。
· · ·
PART 04
第一次打开
第一次打开会直接跳到「创建账户」页。界面跟着浏览器语言走,我这边打开就是简体中文。

▲ 第一个注册的账号就是这个实例的管理员
密码要求至少 8 位,大小写字母、数字、特殊符号各一个。注册完是三步引导:
设置(名字、家庭名称、国家) → 偏好(语言、货币、日期格式) → 目标(勾选你想用它做什么)
偏好这一步最要紧的是「货币」。它决定首页净资产用哪种钱来显示。人在美国就选 USD,人在国内选 CNY。日期格式我选了 YYYY-MM-DD,看着习惯。

▲ 货币选好以后,首页所有账户都按它来换算
🍎 自己用的话,记得关注册
注册页对谁都开着。官方文档的做法是:管理员账号建好后,去「设置 → 自托管」,把注册方式改成「关闭注册」或「仅限邀请注册」。
· · ·
PART 05
两种货币进同一个账本,净资产按真实汇率显示
点左上角「新增资产 → 现金 → 手动输入账户余额」,我建了两个账户:
| 账户 | 货币 | 期初余额 | 类型 |
|---|---|---|---|
| 美国支票账户 | USD | 3,200 | 支票账户 |
| 国内储蓄卡 | CNY | 20,000 | 储蓄账户 |
账户建好后,还要给账本接上汇率来源。不然首页还没有换算依据,2 万人民币会先按 1:1 显示成 2 万美元,净资产会先看到 $23,200.00。侧栏顶上也会出现一条黄色提示「缺少历史数据」,让你去配置提供商。下一步就是把这个来源设好。
设置免费汇率源 Frankfurter
去「设置 → 自托管」,往下翻到「金融数据提供商」。汇率提供商默认选的是 Twelve Data,要填它家的 API 密钥。下拉里还有 Yahoo Finance、MOEX、Frankfurter 三个。Frankfurter 是个免费的汇率接口,数据来自各国央行等官方来源,不用密钥,人民币也有。我改成了它。

▲ 设置 → 自托管 → 金融数据提供商 → 汇率提供商
改完以后,进每个账户的详情页,点那个圆形箭头的刷新按钮,同步一次。两个账户都点完,后台马上拉到了汇率:1 人民币兑 0.15003 美元。
首页净资产变成 $6,200.60。拿计算器算一下:3,200 + 20,000 × 0.15003 = 6,200.60,对上了。

▲ 左:还没设汇率源时的显示;右:改成 Frankfurter 并同步后,数字按真实汇率对上了

▲ 示意图:设好汇率源之后,2 万人民币按 0.15003 折算,净资产为 $6,200.60
🍎 两种以上货币的人,部署完先改汇率提供商
只用一种货币的话,这一步可以不管。
· · ·
PART 06
怎么记一笔人民币支出
账户对了,开始记账。右上角「新建交易」,有支出、收入、转账三种。
先点「设置 → 分类」,空的。点「使用默认值(推荐)」,一次生成 22 个分类:餐饮、杂货、交通、公用事业、医疗保健、订阅等。不点这个,记账时分类下拉里只有「未分类」。
我记了四笔:
- Costco 买菜,美国支票账户,$128.50,杂货
- T-Mobile 话费,美国支票账户,$45,公用事业
- 工资,美国支票账户,$2,600,收入
- 给爸妈买药,国内储蓄卡,386 元,医疗保健
记前三笔时,账户和币种都是美元,直接填金额就行。记第四笔人民币支出时,多看一眼金额旁边的币种。
记人民币支出时,把金额旁边的币种改成 CNY
账户选「国内储蓄卡」,金额填 386,金额框右边的币种默认还是 USD,它不会跟着账户自动换成人民币。这里把它改成 CNY,再保存。
如果没改,表单底下会按汇率 6.666 换算出目标金额 2573.16 CNY:也就是把它理解成花了 386 美元,再折成人民币从储蓄卡扣账。改成 CNY 之后,扣的就是 386 元。

▲ 操作提示:选了人民币账户后,把金额旁边的币种改成 CNY
改完保存,交易列表里这笔显示成 -¥386.00,本月支出合计 $231.40:128.50 + 45 + 386 × 0.15003,按主货币折好了。

▲ 人民币那笔显示 ¥386,支出合计按汇率折成美元
🍎 记人民币账户时,填完金额看一眼右边的币种
想先填美元再让它换算成人民币,这个设计反而顺手。平时记国内的账,每笔手动切一下就行。
· · ·
账记上以后:备份、更新、适合谁
备份:一条命令
compose 文件里自带备份服务,在 compose.yml 所在目录执行:
docker compose run --rm backup create
docker compose run --rm backup list我这个只有两个账户、四笔交易的账本,备份出来 592K,按版本号和时间分文件夹放在 ./backups 里。

▲ 备份命令的真实输出
🍎 备份里带着 .env
备份文件夹里有一份 config/.env,里面是你的密钥和数据库密码。传网盘可以,别放到公开的地方。
想每天自动备份,可以用 docker compose --profile backup up -d backup,默认每天 UTC 02:00(北京时间上午 10 点)备份一次,保留 7 天。这条自动备份命令我没有实际跑过,是按官方文档写的。
更新:先备份,再拉新镜像
Sure 默认不会自己更新。官方文档给的更新步骤是先备份,再拉新镜像重启,数据库迁移会自动跑。下面这组命令我也是按官方文档抄的,没有实际跑过更新:
docker compose run --rm backup create
docker compose pull web worker
docker compose up -dcompose 里默认用的是 stable 标签,对应正式版;换成 latest 会跟着测试版走,自己记账的话没必要。
一个日志里的提醒
启动日志里有一段警告:没有配置数据库加密时,你在 Sure 里填的 API 密钥、银行同步 token、两步验证密钥这类敏感信息是明文存的。它给了生成命令 bin/rails db:encryption:init。只手动记账、不接银行的话影响不大;要接银行同步,先把这个处理了。
谁值得搭

▲ 示意图:值得搭和先别急的几种情况
手上有美元、人民币两种以上的账户,想在一个地方看清换算后的总资产,家里又正好有 NAS 或一台云服务器,那 Sure 值得搭一个试试。不想按年交会员费的,也可以试试。
平时主要靠微信、支付宝记账,要的是自动导入账单,Sure 目前帮不上。只想在手机上随手记一笔、不想管服务器和备份的,用手机记账 App 更省事。
我自己会继续留着这个账本,至少汇总美元和人民币两边的余额够用了。在外面也想打开的话,可以配合 Tailscale 这种组网工具,不用把 3000 端口直接暴露到公网。
相关阅读
参考来源
- GitHub 仓库:https://github.com/we-promise/sure
- 官方 Docker 部署文档:https://github.com/we-promise/sure/blob/main/docs/hosting/docker.md
- Frankfurter 汇率接口:https://frankfurter.dev
- Maybe Finance 最终版本说明:https://github.com/maybe-finance/maybe/releases/tag/v0.6.0




