actualbudget/actual-server

Actual Docker镜像文档

镜像概述

Actual Docker镜像是Actual预算管理工具的容器化部署包，集成了Actual服务器与Web应用程序，提供本地化的个人/家庭预算管理服务。该镜像封装了应用运行所需的全部依赖，支持快速部署、数据持久化及多场景使用，适用于通过容器化方式管理财务数据的用户。

核心功能和特性

• 预算规划：支持自定义预算类别创建、预算目标设置及执行进度跟踪。
• 交易管理：记录收入/支出交易，支持分类、标签及备注管理。
• 财务报表：生成收支趋势、预算使用占比等可视化分析报表。
• 数据同步：支持多设备数据同步（需配置同步服务）。
• 本地存储：数据默认存储于本地，保障隐私安全。
• 数据导入导出：支持CSV格式交易数据导入，支持数据备份导出。
• 轻量部署：基于精简基础镜像构建，资源占用低，运行高效。

使用场景和适用范围

• 个人财务管理：跟踪日常收支、管理月度预算、规划财务目标。
• 家庭预算规划：家庭成员共享预算数据，协同管理家庭收支。
• 财务记录存档：长期存储财务交易数据，支持历史数据分析。
• 离线预算管理：本地部署模式下，无需依赖云端服务即可使用。

使用方法和配置说明

基础要求

• Docker引擎版本20.10+
• 持久化存储：需为预算数据配置独立存储卷或目录

docker run 命令示例

bash
docker run -d \
  --name actual \
  -p 3000:3000 \
  -v /host/path/to/data:/actual/data \
  -e PORT=3000 \
  -e DATA_DIR=/actual/data \
  actualbudget/actual:latest

参数说明：

• -p 3000:3000：端口映射，将容器3000端口映射至主机3000端口，用于Web访问
• -v /host/path/to/data:/actual/data：挂载主机目录至容器数据目录，实现数据持久化
• -e PORT=3000：指定应用监听端口（默认3000）
• -e DATA_DIR=/actual/data：指定容器内数据存储路径（默认/actual/data）

docker-compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  actual:
    image: actualbudget/actual:latest
    container_name: actual
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - actual_data:/actual/data
    environment:
      - PORT=3000
      - DATA_DIR=/actual/data
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      # - HTTPS=true  # 启用HTTPS（需额外配置证书）
      # - SSL_CERT_PATH=/actual/certs/cert.pem
      # - SSL_KEY_PATH=/actual/certs/key.pem

volumes:
  actual_data:
    driver: local

启动服务：

bash
docker-compose up -d

环境变量说明

注：完整环境变量列表请参考官方文档。

数据持久化

Actual数据默认存储于容器内/actual/data目录，需通过以下方式实现持久化：

• 命名卷：使用Docker命名卷（如上述docker-compose示例中的actual_data）
• 绑定挂载：挂载主机目录（如-v /host/path:/actual/data）

应用访问

服务启动后，通过浏览器访问 http://<主机IP>:3000 打开Web应用。首次访问需完成账户创建及初始配置，具体流程参考应用内引导。

注意事项

• 数据备份：定期备份持久化数据目录，防止数据损坏或丢失
• 版本更新：更新镜像前建议备份数据，避免版本兼容问题
• 安全配置：公网访问时建议启用HTTPS并设置强密码
• 依赖检查：确保Docker引擎版本满足要求，低版本可能导致运行异常

参考链接

• 官方GitHub仓库：https://github.com/actualbudget/actual
• 官方文档：[***]