jhonderson/actual-http-api Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

围绕Actual Budget的NodeJS API构建的基础HTTP接口，旨在为无法直接使用Node.js库的环境提供与Actual服务器实例交互的能力。

核心功能和特性

• 互操作性支持：作为Actual Budget NodeJS API的HTTP包装层，实现跨语言访问能力
• 基础授权机制：通过单一API密钥控制访问权限，适用于所有调用者
• 简单部署：支持Docker容器化部署，配置简单，易于集成到现有系统

使用场景和适用范围

适用于需要与Actual Budget服务器实例进行交互，但无法直接导入Node.js库的场景，例如：

• 使用非Node.js编程语言开发的应用
• 跨平台集成系统
• 需要通过HTTP协议标准化访问Actual Budget功能的环境

使用方法和配置说明

环境变量配置

运行该镜像需配置以下环境变量：

Docker运行示例

使用docker run命令部署：

bash
docker run -d --name actualhttpapi -v ./data:/data:rw -p 5007:5007 \
  -e 'ACTUAL_SERVER_URL=http://localhost:5006/' \
  -e 'ACTUAL_SERVER_PASSWORD=my-actual-server-password' \
  -e 'API_KEY=my-strong-api-key' \
  --restart=on-failure jhonderson/actual-http-api:latest

Docker Compose部署

创建docker-compose.yml文件后，执行：

bash
docker-compose up -d

文档访问

服务启动后，可通过以下地址访问API文档：
http://localhost:5007/api-docs/