fthffs/paperless

paperless-ngx OCR语言扩展镜像

镜像概述

本镜像为paperless-ngx的扩展版本，在基础镜像之上添加了OCR语言支持，并优化配置以实现无root用户运行。paperless-ngx是一款文档管理系统，用于扫描、存档和搜索纸质文档，本镜像进一步增强其多语言OCR处理能力并提升运行安全性。

核心功能与特性

• OCR语言扩展：预安装额外OCR语言包，扩展文档识别支持范围
• 无root运行：优化用户权限配置，支持以非root用户身份运行容器，提升系统安全性
• 兼容性：完全兼容paperless-ngx官方镜像的功能和配置方式

使用场景与适用范围

适用于需要处理多语言文档的paperless-ngx用户，特别是对运行环境安全性有要求、需要遵循最小权限原则的场景，如企业文档管理、个人纸质文档数字化等。

使用方法与配置说明

基本使用

本镜像使用方式与paperless-ngx官方镜像一致，可直接替代官方基础镜像进行部署。

Docker Run示例

bash
docker run -d \
  --name paperless-ngx-ocr \
  -p 8000:8000 \
  -v /path/to/data:/usr/src/paperless/data \
  -v /path/to/media:/usr/src/paperless/media \
  -v /path/to/consume:/usr/src/paperless/consume \
  -v /path/to/export:/usr/src/paperless/export \
  --user 1000:1000 \  # 指定非root用户ID和组ID
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3.8'

services:
  paperless-ngx:
    image: your-image-name:latest
    container_name: paperless-ngx
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - ./data:/usr/src/paperless/data
      - ./media:/usr/src/paperless/media
      - ./consume:/usr/src/paperless/consume
      - ./export:/usr/src/paperless/export
    user: "1000:1000"  # 非root用户运行
    environment:
      - PAPERLESS_OCR_LANGUAGE=deu+eng  # 配置OCR语言（示例：德语+英语）
      # 其他paperless-ngx环境变量请参考官方文档

配置参考

• 用户权限：通过--user参数指定非root用户ID和组ID（如1000:1000），确保容器以低权限运行
• OCR语言配置：通过PAPERLESS_OCR_LANGUAGE环境变量指定需要使用的OCR语言，多个语言用+分隔（如eng+fra+spa表示英语+法语+西班牙语）
• 完整配置选项：请参考paperless-ngx官方文档：paperless-ngx 安装文档

相关资源

• OCR语言支持与无root运行讨论：https://github.com/paperless-ngx/paperless-ngx/discussions/4019
• paperless-ngx官方文档：[***]