noah231515/receipt-wrangler-desktop

Receipt Wrangler Desktop Container 镜像文档

镜像概述

Receipt Wrangler Desktop Container 是 Receipt Wrangler 桌面应用程序的 Docker 容器化版本，旨在提供轻量、可移植的收据管理解决方案。该容器封装了桌面应用的核心功能，允许用户通过容器化方式快速部署和运行 Receipt Wrangler，实现收据的数字化采集、组织与管理。

核心功能与特性

• 收据采集：支持通过扫描设备或导入电子文件（如PDF、JPG、PNG）获取收据数据
• 智能分类：可按日期、类别（餐饮、交通、办公等）、金额等维度对收据进行自动或手动分类
• 数据管理：提供结构化收据存储，支持搜索、筛选与标签管理功能
• 数据导出：支持将收据记录导出为CSV、Excel或PDF格式，便于财务对账与报销
• 容器化优势：简化部署流程，隔离应用运行环境，降低系统依赖冲突风险

使用场景与适用范围

• 个人用户：日常收据数字化存档，替代纸质收据管理，减少文件堆积
• 小型团队/自由职业者：集中管理团队或个人的各类 expense 收据，简化报销流程
• 开发/测试环境：在容器化环境中快速搭建收据管理功能，用于集成测试或演示

使用方法与配置说明

基本部署（docker run）

通过以下命令拉取并启动容器：

bash
docker run -d \
  --name receipt-wrangler \
  -p 8080:8080 \  # 默认Web访问端口（具体以实际镜像为准）
  -v /host/path/to/data:/app/data \  # 挂载本地目录用于收据数据持久化
  receipt-wrangler/desktop:latest

环境变量配置

容器支持通过环境变量自定义运行参数，常用配置如下：

示例（指定时区与存储目录）：

bash
docker run -d \
  --name receipt-wrangler \
  -p 8080:8080 \
  -v /my/local/receipts:/custom-storage \
  -e TZ=Asia/Shanghai \
  -e STORAGE_DIR=/custom-storage \
  -e MAX_UPLOAD_SIZE=20 \
  docker.xuanyuan.run/receipt-wrangler/desktop:latest

数据持久化配置

为避免容器重启导致收据数据丢失，需通过 -v 参数挂载本地目录至容器内的存储路径（默认 /app/data 或通过 STORAGE_DIR 指定的路径）。挂载目录需确保具有读写权限：

bash
# 示例：创建本地数据目录并授权
mkdir -p /opt/receipt-wrangler/data
chmod 755 /opt/receipt-wrangler/data

# 启动容器时挂载该目录
docker run -d \
  --name receipt-wrangler \
  -p 8080:8080 \
  -v /opt/receipt-wrangler/data:/app/data \
  docker.xuanyuan.run/receipt-wrangler/desktop:latest

访问与使用

容器启动后，通过以下方式访问应用：

1. Web界面：在浏览器中访问 http://<主机IP>:8080（默认端口，具体以实际镜像为准）
2. 初始配置：首次访问需完成管理员账户创建（用户名/密码设置）
3. 功能使用：通过界面上传收据文件、配置分类规则、执行搜索或导出操作

注意事项

• 数据备份：定期备份挂载的本地数据目录，防止数据丢失
• 权限管理：确保挂载目录的权限设置正确（建议使用非root用户运行容器，通过 --user 参数指定）
• 镜像更新：通过 docker pull docker.xuanyuan.run/receipt-wrangler/desktop:latest 获取最新版本，更新前建议备份数据
• 资源需求：根据收据文件数量调整容器资源（如 -m 2g 限制内存使用）