蜜蜂记账(BeeCount)部署教程:不用公网服务器,手机和网页也能共用一本账

蓝色 16 阅读 开源项目

开源记账 App · 自建云同步 · Docker 两种装法 · 家用网络四种连法

这篇教程面向普通用户:你不需要懂服务器、不需要买公网 IP,只要有一台常年开着的电脑(家里的旧笔记本、NAS、软路由都可以),就能给自己的记账软件配一个私有云,手机、平板、网页共用同一本账。全文分四步:准备东西、装好服务、让手机连上、日常维护。

01 为什么值得自建一个记账云

1.1 记账软件常见的三个坑

大多数人换过好几款记账 App,原因往往不是功能不够,而是心里不踏实:账本存在别人的服务器上,能不能导出、会不会被删,全看厂商;想要多设备同步、全家一起记,通常就得开会员;软件停更或下架,几年的账目就成了孤本。

1.2 蜜蜂记账的做法

蜜蜂记账(BeeCount)是一款完全开源的记账 App,账本默认就存在手机本地,不联网也能记。它同时提供一个官方叫 BeeCount Cloud 的同步服务端——这个服务端可以自己装在自己的机器上,于是账本既能在手机、平板、网页之间实时同步,数据又始终留在你自己手里。

• 不用花钱:个人自用完全免费,没有广告和会员墙。

• 改一笔秒同步:手机上记完,网页端几秒内就能看到。

• 自带网页版:一个安装包同时包含服务端和网页界面,浏览器打开就能记账、看报表。

• 全家共记一本:可以给家人各开一个账号,再邀请进同一本账,谁记的、谁改的都有标注。

• 数据随时带走:整个数据就是一个文件夹,拷走就能换台机器继续用。

蜜蜂记账按日汇总收入、支出与结余,月度趋势与分类排行,资产账户

02 动手前,先准备三样东西

2.1 准备清单

• 一台能装 Docker 的机器:家里的旧笔记本、小主机、群晖 / 绿联等 NAS 都行。Docker 可以理解成“一键装软件的工具”,装好之后,我们只需要一条命令就能把这个服务跑起来。单核 1GB 内存就够用。

• 手机上的蜜蜂记账 App:iOS 和 Android 应用商店都能直接下载。

• 一个不会被随手清理的文件夹:用来放账本数据。装好服务后,所有数据都在这个文件夹里,备份就是打包它。

2.2 三个小概念,一看就懂

• 端口 8869:相当于这台机器上的“门牌号”。我们在浏览器或 App 里填地址时,末尾要带上它,例如 http://192.168.1.100:8869。

• 管理员账号:第一次启动时,系统会自动生成一个管理员邮箱和随机密码;也可以用配置里的两行改为自己指定的账号密码。

• 时区:设置成 Asia/Shanghai,自动备份与定时任务才会按北京时间执行。

03 装法一:配置文件安装(推荐,长期用)

这是官方推荐的方式:写一份配置文件,之后升级、重启都由系统照看,适合长期挂着用。

3.1 建目录,写配置文件

在机器上新建一个文件夹,进入后创建一个名为 docker-compose.yml 的文件,内容如下(可直接复制):

# 先建目录
mkdir -p ~/beecount && cd ~/beecount
services:
  beecount-cloud:
    image: sunxiao0721/beecount-cloud:latest
    restart: unless-stopped
    ports:
      - "8869:8080"
    volumes:
      - ./data:/data
    environment:
      TZ: Asia/Shanghai

三行关键信息:ports 前面的 8869 是对外门牌号;volumes 把当前目录下的 data 交付给程序存放数据;TZ是时区。

3.2 启动,并拿到管理员账号

1. 在配置文件所在目录执行:docker compose up -d,程序会在后台启动并自动初始化。

2. 查看首次启动生成的管理员账号:

# 查看管理员账号
docker compose logs beecount-cloud | grep -A 10 "初次启动"

日志里会显示邮箱和一串随机密码。如果日志已刷掉,也可以执行 cat ./data/.initial_admin_password查看。

3.3 浏览器登录,先改密码

在电脑浏览器打开 http://这台机器的IP:8869,用刚才的账号登录,然后到右上角头像里把密码改成自己记得住的。这一步别拖,尤其是这台机器以后要对外网开放时。

登录后的网页控制台,收支、资产构成与趋势一屏可见

04 装法二:一条命令安装(先试一下)

如果你只是想先看看效果,或者用的 NAS 面板更适合粘贴命令,可以直接用一条命令启动。它和装法一是同一个程序,区别只是“用命令描述”还是“用文件描述”。

4.1 直接运行

docker run -d \
  --name beecount-cloud \
  --restart unless-stopped \
  -p 8869:8080 \
  -v "$(pwd)/data:/data" \
  -e TZ=Asia/Shanghai \
  -e BOOTSTRAP_ADMIN_EMAIL=me@example.com \
  -e BOOTSTRAP_ADMIN_PASSWORD=自定义密码 \
  sunxiao0721/beecount-cloud:latest

最后两行是可选的:不写就自动生成随机管理员账号(用 docker logs beecount-cloud 查看),写了就直接用你自己的邮箱和密码登录。

4.2 两种装法怎么选

• 长期使用:选装法一,改配置、升级都更省心。

• 只想试一下:选装法二,不想用时执行 docker rm -f beecount-cloud 就清干净了,数据仍留在 data 文件夹里。

05 没有公网服务器?四种方式让手机连上家里

服务装好之后,剩下的唯一问题是:手机如何访问到这台机器。不需要买公网服务器,按自己的情况选一种即可,从最简单往下试。

5.1 同一个 WiFi 直接连(最简单)

手机和这台机器连在同一个路由器下时,App 里直接填机器的内网地址,例如 http://192.168.1.100:8869。缺点很明显:出门用流量、或者在公司时就访问不到。适合先验证能不能用。

5.2 家里宽带有公网 IP:端口映射 + DDNS 域名

部分家庭宽带会分配一个公网 IP,但它是会变的。做法是两步:在路由器上把 8869 端口映射到那台机器;再用 DDNS(动态域名解析)把一个固定域名指向家里不断变化的 IP,例如路由器自带的 DDNS 功能、花生壳、群晖的 DDNS 等。

判断有没有公网 IP 的土办法:在路由器里看 WAN 口 IP,再在浏览器搜索“我的 IP”对比一次。如果两者不一致,多半是运营商做了共享地址(大内网),这种方式走不通,直接看 5.3。

5.3 没有公网 IP:用 Tailscale 组一个虚拟局域网(推荐)

Tailscale 的作用可以理解为:给家里的机器和你的手机各装一个客户端,登录同一个账号,它们就仿佛接在了同一个路由器下,无论你人在哪里。装好之后,服务器上会得到一个形如 100.x.x.x 的地址,App 里就填 http://100.x.x.x:8869。

• 设备端:服务器安装 Tailscale 客户端并登录;手机装同款 App 登录同一账号。

• App 端:云同步里填 Tailscale 显示的服务器地址,账号密码照常填写。

• 好处:不需要公网 IP、不需要在路由器开端口,外人扫不到你的服务;坏处是每台要访问的设备都得装客户端。

5.4 想要一个外网网址:内网穿透

如果希望用 https://账本.你的域名.com 这样的地址访问,或者要给不装客户端的人用,可以用内网穿透:常见做法是 Cloudflare Tunnel(cloudflared)或 frp(需要一台有公网 IP 的小服务器做中转)。它们会把公网请求转发到家中的服务,同时顺带解决 HTTPS 证书。

无论用哪种,只要涉及公网,请记住一句:不要把明文的 http 端口直接暴露在公网上,一律走 HTTPS,并把管理员密码设成足够强的。另外账号无法自助注册,需要加家人时由管理员在网页后台新增。

06 iPhone 用户不想折腾?iCloud 同步也能用

如果你只用 iPhone 和 iPad,其实完全可以跳过上面所有步骤。蜜蜂记账内置了 iCloud 同步,打开即用、不需要服务器:账本会通过你自己的 iCloud 在几台苹果设备之间同步。

• 只用苹果设备:选 iCloud 同步,零配置,最省事。

• 要用安卓、要网页端、要全家共记一本:才需要自建 BeeCount Cloud。

• 想再加一层保险:iPhone 的“设置 → Apple ID → iCloud → iCloud 云备份”属于整机备份,可以作为额外一层;但它不能替代账本本身的同步与导出,建议每隔一段时间在 App 里导出一次 CSV。

07 让 App 连上,然后开始记账

1. 打开蜜蜂记账 App,进入“我的 → 云同步”。

2. 服务类型选 BeeCount Cloud,填入第 5 节里选定的服务器地址,再加上管理员账号密码。

3. 首次登录会把手机上已有的账本全量上传到服务器;之后任一端改动,其他设备几秒内同步。

4. 要家人一起记同一本账时,用“共享账本”:账本主人在 App 或网页上生成邀请码(默认 24 小时有效),对方输入码加入,各自记的账会标注是谁记的、谁改的。

 

App 的云服务设置页,可切换五种同步方案(来源:BeeCount 开源仓库官方截图)

网页端还能“装”到桌面:在浏览器地址栏点安装图标,之后就像个独立 App 一样打开,断网时也能看缓存的账目。

08 三件小事:备份、升级、连不上怎么办

8.1 备份只要记住一句话

所有数据都在那个 data文件夹里,把它打包就是完整备份;换机器时把文件夹拷过去,同样的配置文件再启动一次就恢复了。

8.2 升级只有两行命令

# 升级
docker compose pull && docker compose up -d

升级时程序会自己完成数据结构调整,data 文件夹不需要动。习惯了之后可以一个月跑一次。若同时用 App,记住先升级服务端、再升级 App。

8.3 连不上,先查这三点

• 门牌号对不对:地址末尾有没有带 :8869,前面是 http 还是 https,两者写错都会连不上。

• 机器之间通不通:先在同一 WiFi 下试局域网地址;出门在外就要确认 Tailscale 或内网穿透是否处于连接状态。

• 能登录但不刷新:多见于把服务放到公网反向代理后面,代理没有正确转发实时连接,检查一下代理配置里对 WebSocket 的支持即可。

最后一条建议:先只在局域网里用上一周,确认同步正常、备份能跑通,再决定要不要对外网开放。账本是很私人的数据,稳一点比快一点重要。