Docker 玩法

飞牛NAS部署 Actual Budget：个人财务管理

2026-07-30 2 admin

在数字化时代，管理个人财务变得尤为重要。无论是跟踪日常开支、规划预算，还是分析消费趋势，一款高效、安全的财务管理工具都能帮上大忙。本文将带你使用飞牛NAS（飞牛OS）的Docker功能，部署一款开源、自托管的个人财务管理应用——Actual Budget。它支持多平台访问、数据完全由你掌控，且无需依赖第三方云服务。

为什么选择Actual Budget？

自托管：所有财务数据存储在你的NAS上，隐私无忧。
跨平台：通过Web浏览器或手机App（需搭配同步工具）访问。
功能全面：支持预算规划、交易分类、报表生成、多账户管理。
轻量高效：基于Node.js开发，资源占用低，适合NAS长期运行。
开源免费：代码透明，社区活跃，持续更新。

准备工作

在开始部署前，请确保：

飞牛NAS已安装并正常运行（本文基于飞牛OS最新版本）。
已启用Docker服务（通常默认支持，可在应用中心确认）。
拥有管理员权限，能通过SSH或飞牛NAS的Web终端执行命令。
计划好存储路径：例如在/volume1/docker/actual-budget下存放数据。

部署步骤

Actual Budget官方推荐使用Docker部署，飞牛NAS的Docker功能完全兼容。我们将采用docker-compose方式，便于管理配置。

1. 创建数据目录

通过SSH登录飞牛NAS，或直接使用飞牛NAS的“文件管理器”创建目录。推荐使用命令行：

# 创建数据持久化目录（根据你的存储池调整路径）
sudo mkdir -p /volume1/docker/actual-budget/data

说明：/volume1是飞牛NAS的默认存储卷，请根据实际情况替换。如果使用其他路径，请确保Docker有读写权限。

2. 编写docker-compose.yml

使用你熟悉的文本编辑器（如vim、nano），在/volume1/docker/actual-budget/下创建docker-compose.yml文件：

version: '3.8'

services:
  actual-budget:
    image: actualbudget/actual-server:latest
    container_name: actual-budget
    restart: unless-stopped
    ports:
      - "5006:5006"  # 宿主机端口映射，可自定义，如3000:5006
    volumes:
      - /volume1/docker/actual-budget/data:/data  # 数据持久化
    environment:
      - ACTUAL_UPLOAD_FILE_SIZE_LIMIT=100mb  # 可选：上传文件大小限制
    # 如果飞牛NAS有防火墙，确保开放对应端口（默认5006）

3. 启动容器

进入配置目录，执行以下命令：

cd /volume1/docker/actual-budget
sudo docker-compose up -d

等待镜像拉取并启动。首次启动可能需要几分钟（取决于网络速度）。完成后，检查容器状态：

sudo docker ps | grep actual-budget

应显示类似Up X minutes的状态。

4. 访问并初始化

打开浏览器，访问http://你的飞牛NAS IP:5006（例如http://192.168.1.100:5006）。你将看到Actual Budget的初始设置页面：

创建用户：设置管理员邮箱和密码（请牢记）。
选择语言：支持中文界面（在设置中可切换）。
配置预算：按引导创建第一个预算文件。

进阶配置

启用HTTPS（推荐）

由于财务管理涉及敏感数据，强烈建议通过反向代理（如Nginx Proxy Manager）或飞牛NAS自带的证书功能启用HTTPS。飞牛NAS的“网络服务”中可配置Let's Encrypt证书，然后通过反向代理将域名指向localhost:5006。

数据备份

定期备份/volume1/docker/actual-budget/data目录。Actual Budget的数据以SQLite数据库文件存储，直接复制该目录即可。也可结合飞牛NAS的“备份与还原”功能自动化。

更新版本

当Actual Budget发布新版本时，更新很简单：

cd /volume1/docker/actual-budget
sudo docker-compose pull
sudo docker-compose up -d

使用技巧

导入银行数据：支持CSV、OFX、QIF等格式，在“导入”功能中上传即可。
多用户共享：通过设置不同权限的账户，家庭成员可共同管理预算。
移动端访问：虽然Actual Budget没有原生App，但可将Web应用添加至手机主屏幕（PWA），体验接近原生。
分类与规则：创建交易规则自动分类，减少手动操作。

常见问题

Q：页面无法访问？ A：检查端口是否被占用，或防火墙是否放行。尝试sudo docker logs actual-budget查看日志。

Q：数据目录权限错误？ A：确保/volume1/docker/actual-budget/data目录的属主为Docker用户（通常为1000:1000），或直接赋予777权限（不推荐生产环境）。

Q：如何修改端口？ A：编辑docker-compose.yml中的ports映射，例如改为"3000:5006"，然后docker-compose down && docker-compose up -d。

结语

通过飞牛NAS部署Actual Budget，你获得了一个完全自主掌控的个人财务中心。无论是日常记账还是年度预算分析，它都能高效胜任。随着使用深入，你还可以探索其丰富的插件和API扩展。现在，就开始用数据驱动你的财务决策吧！

本文基于Actual Budget v24.10.0及飞牛OS v0.8.17测试。如有版本差异，请参考官方文档调整。