stefanlachner/paperless-to-lexoffice
stefanlachner
自动将paperless-ngx中的（选定）文档同步至lexoffice的Docker镜像
下载次数: 0状态：社区镜像维护者：stefanlachner仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
paperless-ngx-to-lexoffice 同步工具 Docker 镜像
镜像概述
该Docker镜像用于在paperless-ngx与lexoffice之间实现文档自动同步，旨在简化文档流转流程，减少手动操作，适用于需要将paperless-ngx中管理的文档自动转移至lexoffice的场景，提升工作效率。
核心功能和特性
- 自动同步：支持定时或事件触发式文档同步，无需人工干预
- 文档筛选：可通过配置筛选规则（如标签、文档类型、日期范围等）同步指定文档
- 双向API集成：适配paperless-ngx和lexoffice官方API接口，确保数据兼容性
- 错误处理：同步失败时支持重试机制，并生成详细日志便于问题排查
- 轻量级设计：基于Alpine或类似轻量基础镜像构建，资源占用低，运行稳定
使用场景和适用范围
- 小型企业/自由职业者：使用paperless-ngx管理发票、收据等财务文档，需同步至lexoffice进行会计处理的用户
- 自动化办公流程：需减少paperless-ngx与lexoffice间手动文档转移操作的场景
- 定向文档同步：仅需同步特定标签（如"客户发票"、"供应商收据"）或类型文档的场景
使用方法和配置说明
环境变量配置
使用该镜像需配置以下环境变量，其中标记为必填的为启动必需参数：
| 环境变量名 | 描述 | 是否必填 | 示例值 |
|---|---|---|---|
| PAPERLESS_URL | paperless-ngx实例的API基础URL（需包含协议和端口） | 是 | [***] |
| PAPERLESS_API_KEY | paperless-ngx的API访问密钥（从paperless-ngx用户设置中生成） | 是 | pk_abc*** |
| LEXOFFICE_API_KEY | lexoffice的API访问密钥（从lexoffice账户设置的API访问页面获取） | 是 | lex_api_xyz7890123456 |
| SYNC_INTERVAL | 同步间隔时间（单位：秒），0表示仅同步一次 | 否 | 3600（默认，即每小时同步一次） |
| SYNC_FILTER_TAGS | 需同步文档的标签筛选（多个标签用逗号分隔，留空同步所有文档） | 否 | invoice,receipt |
| SYNC_DOCUMENT_TYPES | 需同步的文档类型筛选（多个类型用逗号分隔，留空不限制类型） | 否 | invoice,credit_note |
| LOG_LEVEL | 日志级别（DEBUG/INFO/WARNING/ERROR） | 否 | INFO |
部署示例
Docker Run 命令
bashdocker run -d \ --name paperless-lexoffice-sync \ -e PAPERLESS_URL="http://paperless-ngx:8000/api" \ -e PAPERLESS_API_KEY="your_paperless_api_key" \ -e LEXOFFICE_API_KEY="your_lexoffice_api_key" \ -e SYNC_INTERVAL="3600" \ -e SYNC_FILTER_TAGS="invoice,receipt" \ -e LOG_LEVEL="INFO" \ --restart unless-stopped \ [镜像名称]:[标签]
Docker Compose 配置
yamlversion: '3.8' services: paperless-lexoffice-sync: image: docker.xuanyuan.run/[镜像名称]:[标签] container_name: paperless-lexoffice-sync environment: - PAPERLESS_URL=http://paperless-ngx:8000/api - PAPERLESS_API_KEY=your_paperless_api_key - LEXOFFICE_API_KEY=your_lexoffice_api_key - SYNC_INTERVAL=3600 - SYNC_FILTER_TAGS=invoice,receipt - LOG_LEVEL=INFO restart: unless-stopped networks: - paperless-network # 确保与paperless-ngx在同一网络 networks: paperless-network: external: true # 假设paperless-ngx已使用此网络
详细使用步骤
1. 获取API密钥
- paperless-ngx：登录后进入"用户设置" → "API密钥"，点击"生成新密钥"并保存
- lexoffice：登录后进入"账户设置" → "API访问"，创建API密钥并授予文档写入权限
2. 配置同步规则
- 通过
SYNC_FILTER_TAGS指定需同步的文档标签（如"tax_invoice"） - 可选通过
SYNC_DOCUMENT_TYPES限制文档类型（如仅同步"invoice"类型） - 设置
SYNC_INTERVAL调整同步频率（建议生产环境设置为3600秒及以上）
3. 启动与验证
- 启动容器后，通过
docker logs paperless-lexoffice-sync查看运行日志 - 同步成功时日志将显示"Sync completed: X documents transferred"
- 在lexoffice文档管理界面检查是否收到同步文档
注意事项
- 确保paperless-ngx和lexoffice服务可被容器访问（同一网络或使用公网地址）
- API密钥需妥善保管，避免泄露导致安全风险
- 首次同步大量文档时可能耗时较长，建议通过日志监控进度
- 若lexoffice为云服务，需确保容器具备互联网访问权限
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 paperless-to-lexoffice 镜像标签
docker pull docker.xuanyuan.run/stefanlachner/paperless-to-lexoffice:<标签>
DockerHub 原生拉取命令
docker pull stefanlachner/paperless-to-lexoffice:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"