Actual Budget 服务器 Docker 部署指南

项目概述

Actual Budget 是一款开源的个人财务管理工具，其服务器组件 actual-server 提供了数据存储和同步功能。本文将详细介绍如何使用 Docker Compose 快速部署 Actual Budget 服务器。

部署准备

在开始部署前，请确保您的系统已安装以下组件：

• Docker 引擎
• Docker Compose

核心配置解析

基础服务配置

在 docker-compose.yml 文件中，我们定义了一个名为 actual_server 的服务：

services:
  actual_server:
    image: docker.io/actualbudget/actual-server:latest
    ports:
      - '5006:5006'
    volumes:
      - ./actual-data:/data
    restart: unless-stopped

关键配置说明：

1. image: 指定使用官方最新版的 actual-server 镜像
2. ports: 将容器内的 5006 端口映射到主机的 5006 端口
3. volumes: 将主机上的 ./actual-data 目录挂载到容器的 /data 目录，用于持久化存储
4. restart: 设置容器自动重启策略

端口配置

默认情况下，Actual Budget 服务器监听 5006 端口。如果需要更改端口，可以修改 ports 配置：

ports:
  - '8080:5006'  # 将主机端口改为8080

或者通过环境变量修改容器内部监听端口：

environment:
  - ACTUAL_PORT=8080

数据持久化

数据持久化是部署中的关键环节。通过 volumes 配置，我们将主机目录挂载到容器中：

volumes:
  - ./actual-data:/data

建议：

1. 将 ./actual-data 替换为绝对路径，如 /var/actual-data
2. 确保挂载目录有正确的读写权限

高级配置选项

Actual Budget 服务器支持多种环境变量配置：

environment:
  - ACTUAL_HTTPS_KEY=/data/selfhost.key
  - ACTUAL_HTTPS_CERT=/data/selfhost.crt
  - ACTUAL_UPLOAD_FILE_SYNC_SIZE_LIMIT_MB=20
  - ACTUAL_UPLOAD_SYNC_ENCRYPTED_FILE_SYNC_SIZE_LIMIT_MB=50
  - ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB=20

常见配置说明：

1. HTTPS 证书配置：启用 HTTPS 需要提供证书和密钥文件
2. 文件大小限制：可以调整同步文件的大小限制
3. 加密文件限制：单独设置加密文件的大小限制

部署步骤

1. 创建 docker-compose.yml 文件，填入上述配置
2. 在文件所在目录执行：docker-compose up -d
3. 服务器将在后台启动，可通过 http://localhost:5006 访问

维护与管理

日志查看

docker-compose logs -f actual_server

服务重启

docker-compose restart actual_server

数据备份

由于数据已持久化到主机目录，只需定期备份挂载目录即可。

常见问题

1. 端口冲突：如果 5006 端口已被占用，修改 ports 配置中的第一个端口号
2. 权限问题：确保挂载目录对 Docker 进程可写
3. HTTPS 配置：需要将证书文件放入挂载目录，并配置正确路径

最佳实践建议

1. 生产环境建议启用 HTTPS
2. 定期检查并更新镜像版本
3. 设置适当的文件大小限制，防止滥用
4. 考虑使用反向代理（如 Nginx）提供额外安全层

通过以上配置，您可以快速搭建一个稳定运行的 Actual Budget 服务器，为个人或家庭财务管理提供可靠的后端支持。