11notes/paperless-ngx

PAPERLESS-NGX

!size!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-paperless-ngx/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/main/img/markdown/transparent5x2px.png!swiss_made

默认以无root权限运行paperless-ngx（无SUID）！

简介 📢

一个社区支持的增强型文档管理系统：扫描、索引和归档所有文档。

概述 📖

此镜像能做什么？ 该镜像将通过s6运行paperless-ngx，但以无root权限方式运行。

独特价值 💶

为什么选择此镜像而非其他现有镜像？ 好问题！因为...

• ...此镜像以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%8C%E7%94%A8%E6%88%B7ID/%E7%BB%84ID%E4%B8%BA1000:1000
• ...通过CI/CD自动更新至最新版本
• ...包含健康检查
• ...在发布前后自动扫描CVE漏洞
• ...通过安全且固定的CI/CD流程构建

如果您重视安全性、简洁性和极致优化，此镜像可能适合您。

卷 📁

• /usr/src/paperless/consume - 待处理文档目录
• /usr/src/paperless/media/documents/originals - 原始导入文档目录
• /usr/src/paperless/media/documents/archive - 已处理文档归档目录
• /usr/src/paperless/media/documents/thumbnails - 文档缩略图目录
• /usr/src/paperless/data - 应用内部相关文件和配置目录
• /usr/src/paperless/export - 文档导出目录

Docker Compose 配置 ✂️

yaml
name: "dms"
services:
  postgres:
    image: "11notes/postgres:16"
    read_only: true
    environment:
      TZ: "Europe/Zurich"
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      # 每天03:00执行完整压缩数据库备份
      POSTGRES_BACKUP_SCHEDULE: "0 3 * * *"
    volumes:
      - "postgres.etc:/postgres/etc"
      - "postgres.var:/postgres/var"
      - "postgres.backup:/postgres/backup"
    tmpfs:
      # 只读模式所需
      - "/postgres/run:uid=1000,gid=1000"
      - "/postgres/log:uid=1000,gid=1000"
    networks:
      backend:
    restart: "always"

  redis:
    image: "11notes/redis:7.4.0"
    environment:
      REDIS_PASSWORD: ${REDIS_PASSWORD}
      TZ: Europe/Zurich
    volumes:
      - "redis.etc:/redis/etc"
      - "redis.var:/redis/var"
    networks:
      backend:
    restart: always

  paperless-ngx:
    depends_on:
      postgres:
        condition: "service_healthy"
        restart: true
      redis:
        condition: "service_healthy"
        restart: true
    image: "11notes/paperless-ngx:2.20.10"
    environment:
      TZ: "Europe/Zurich"
      PAPERLESS_REDIS: "redis://:${REDIS_PASSWORD}@redis:6379"
      PAPERLESS_DBPASS: ${POSTGRES_PASSWORD}
      PAPERLESS_CONSUMER_POLLING: "60"
      PAPERLESS_CONSUMER_POLLING_DELAY: "30"
      PAPERLESS_CONSUMER_POLLING_RETRY_COUNT: "3"
      PAPERLESS_OCR_SKIP_ARCHIVE_FILE: "never"
      PAPERLESS_CONSUMER_RECURSIVE: "false"
      PAPERLESS_OCR_LANGUAGES: "eng deu"
      PAPERLESS_OCR_LANGUAGE: "deu"
      PAPERLESS_SECRET_KEY: ${PAPERLESS_NGX_SECRET_KEY}
      PAPERLESS_TIME_ZONE: "Europe/Zurich"
      PAPERLESS_URL: "https://${PAPERLESS_NGX_FQDN}"
      # 用于ADDS的LDAP模块，使用UPN登录
      DJANGO_SETTINGS_MODULE: "paperless.settings_ldap"
      PAPERLESS_AD_AUTH_URL: "ldaps://${PAPERLESS_NGX_LDAP_FQDN}:636"
      PAPERLESS_AD_DOMAIN: ${PAPERLESS_NGX_LDAP_FQDN}
      PAPERLESS_AD_UPN_DOMAIN: ${PAPERLESS_NGX_LDAP_UPN}
      PAPERLESS_AD_AUTH_SEARCH_BASE: ${PAPERLESS_NGX_LDAP_SEARCH_CN}
      PAPERLESS_AD_AUTH_USER: ${PAPERLESS_NGX_LDAP_USER}
      PAPERLESS_AD_AUTH_PASSWORD: ${PAPERLESS_NGX_LDAP_PASSWORD}
      PAPERLESS_AD_USER_GROUP_CN: ${PAPERLESS_NGX_LDAP_USERS_CN}
      PAPERLESS_AD_ADMIN_GROUP_CN: ${PAPERLESS_NGX_LDAP_ADMINS_CN}
    volumes:
      - "paperless-ngx.consume:/usr/src/paperless/consume"
      - "paperless-ngx.originals:/usr/src/paperless/media/documents/originals"
      - "paperless-ngx.archive:/usr/src/paperless/media/documents/archive"
      - "paperless-ngx.data:/usr/src/paperless/data"
      - "paperless-ngx.export:/usr/src/paperless/export"
      - "paperless-ngx.thumbnails:/usr/src/paperless/media/documents/thumbnails"
    networks:
      frontend:
      backend:
    ports:
      - "3000:8000/tcp"
    restart: "always"

volumes:
  postgres.etc:
  postgres.var:
  postgres.backup:
  redis.etc:
  redis.var:
  paperless-ngx.consume:
  paperless-ngx.originals:
  paperless-ngx.archive:
  paperless-ngx.data:
  paperless-ngx.export:
  paperless-ngx.thumbnails:  

networks:
  frontend:
  backend:
    internal: true

如需修改容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

默认设置 🗃️

环境变量 📝

主要标签 🏷️

以下是镜像的主要标签。同时也提供每个提交及其sha256短哈希值对应的标签。

• https://hub.docker.com/r/11notes/paperless-ngx/tags?name=2.20.10
• https://hub.docker.com/r/11notes/paperless-ngx/tags?name=2.20.10-unraid
• https://hub.docker.com/r/11notes/paperless-ngx/tags?name=2.20.10-nobody

没有latest标签，如何处理更新？

个人认为:latest标签是不良习惯，不应使用。许多开发者在新版本中引入破坏性变更，这会给使用:latest的用户带来问题。如果不想手动更改标签至最新语义化版本，可使用语义化版本的短版本。例如，使用:2或:2.20而非:2.20.10。这些标签会在每个新版本发布时更新至最新软件版本，效果类似于:latest，但至少固定在主版本或次版本，理论上不会引入破坏性变更。

如果仍希望使用最新版本，可使用:rolling标签，但请注意！这将立即获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库 ☁️

docker pull 11notes/paperless-ngx:2.20.10
docker pull ghcr.io/11notes/paperless-ngx:2.20.10
docker pull quay.io/11notes/paperless-ngx:2.20.10

UNRAID版本 🟠

此镜像默认支持unraid。只需在任何标签后添加**-unraid**，镜像将以99:100而非1000:1000运行。

NOBODY版本 👻

此镜像默认支持nobody用户。只需在任何标签后添加**-nobody**，镜像将以65534:65534而非1000:1000运行。

源码 💾

• https://github.com/11notes/docker-paperless-ngx

基础镜像 🏛️

• https://hub.docker.com/r/paperlessngx/paperless-ngx

构建工具 🧰

• https://github.com/paperless-ngx/paperless-ngx
• https://github.com/11notes/docker-util

通用提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

注意事项 ⚠️

• 由于此镜像是无root权限的，与官方镜像不同，默认仅支持EN（英语）、DE（德语）、FR（法语）、IT（意大利语）和ES（西班牙语）。如果需要其他OCR语言，请 fork 此镜像并安装所需的tesseract-ocr-{LANGUAGE}包。无法默认添加所有语言。

ElevenNotes™️

此镜像按"原样"提供，风险自负。更新镜像版本前请务必备份。查看https://github.com/11notes/docker-paperless-ngx/releases%E4%BA%86%E8%A7%A3%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E3%80%82%E4%BD%BF%E7%94%A8%E4%B8%AD%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-paperless-ngx/issues%E3%80%82%E5%A6%82%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BAhttps://github.com/11notes/docker-paperless-ngx/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E5%8F%AF%E5%9C%A8https://github.com/11notes?tab=repositories%E6%9F%A5%E7%9C%8B%E3%80%82

创建于 05.03.2026, 06:59:57 (CET)