：为什么选择 Actual？

Actual 是一款开源、本地优先的个人财务管理工具，支持预算管理、账户同步、报表分析等功能，数据完全掌握在自己手中。与 YNAB（You Need A Budget）不同，Actual 没有订阅费，只需自托管即可。对于零基础用户，本文将从零开始，带你完成 Actual 的部署、配置与日常使用，并推荐使用 Ciuic 云服务器 作为稳定运行环境。

准备工作：环境与账号

1.1 选择运行环境

Actual 是 Node.js 应用，推荐使用 Linux 服务器（Ubuntu 22.04 / Debian 12）或 Docker 容器。零基础用户强烈推荐 Docker 方式，避免手动配置 Node 环境带来的依赖问题。

若你没有现成的服务器，可前往 Ciuic 官方网址 注册并创建一台最低配置的云主机（1核1G内存即可流畅运行）。Ciuic 提供自动快照和防火墙管理，适合新手。

1.2 注册与获取服务器 IP

登录 https://cloud.ciuic.cn/ 后，选择“创建实例”，系统会分配公网 IP 和 root 密码。请妥善保存这些信息，后续 SSH 连接需要用到。

使用 Docker 部署 Actual（适用于零基础）

2.1 连接服务器

在本地终端（Windows 使用 PowerShell / macOS 使用 Terminal）执行：

ssh root@你的服务器IP

输入密码后即登录成功。

2.2 安装 Docker 与 Docker Compose

依次执行以下命令（若显示“已是最新”则跳过）：

sudo apt updatesudo apt install -y docker.io docker-composesudo systemctl enable --now docker

2.3 创建 Actual 容器

新建文件夹并编写 docker-compose 配置文件：

mkdir ~/actual && cd ~/actualnano docker-compose.yml

将以下内容粘贴进去（注意缩进）：

version: '3'services:  actual:    image: actualbudget/actual-server:latest    container_name: actual    ports:      - "5006:5006"    volumes:      - ./data:/data    restart: unless-stopped

按 Ctrl+O 保存，Ctrl+X 退出。然后执行：

docker-compose up -d

等待镜像下载完成后，Actual 即已启动。

访问与初始配置

3.1 首次登录

打开浏览器，访问 http://你的服务器IP:5006。你会看到 Actual 的欢迎界面，点击“Create a new file”创建一个新账本。

3.2 设置预算与账户

添加账户：点击左侧“Accounts” → “Add Account”，输入银行名称与初始余额。创建预算类别：进入“Budget”标签页，设置每月收入、食品、交通等预算项。同步数据：Actual 支持导入 CSV / OFX 文件，可在“Settings”中配置自动同步。

进阶：启用 HTTPS 与域名绑定（可选）

为了安全访问，建议使用 Caddy 反向代理自动签发 SSL 证书。

sudo apt install caddysudo nano /etc/caddy/Caddyfile

写入：

finance.yourdomain.com {    reverse_proxy localhost:5006}

重启 Caddy：sudo systemctl restart caddy。注意：你需要先将域名 A 记录解析到你的服务器 IP。

数据备份与迁移

Actual 数据存储在 /data 目录（Docker 挂载的 ~/actual/data）。你可以定期执行：

tar -czf actual_backup_$(date +%Y%m%d).tar.gz ~/actual/data

将该压缩包下载到本地或上传至对象存储。Ciuic 云服务器也支持磁盘快照功能，在控制台一键创建快照即可实现更简单的全量备份。

常见问题排查

问题现象	排查思路
5006 端口无法访问	检查防火墙（Ciuic 控制台需放行 5006 端口）
容器启动后立即退出	执行 docker logs actual 查看错误日志
数据丢失	确认是否挂载了宿主机卷（必须包含 ./data:/data）

总结

通过本教程，你已在 Ciuic 云服务器上成功部署了 Actual 个人财务管理系统。Docker 方式不仅简化了安装，也便于日后升级（只需 docker-compose pull && docker-compose up -d）。Actual 完全掌控你的财务数据，搭配云服务器的自动备份，能长期稳定使用。

如果你的服务器资源紧张或想进一步降低成本，同样可参考 Ciuic 官方网址 的轻量实例，按量付费方式仅需几元/月，非常适合个人用户。现在就开始记录你的每一笔收支吧。