lsiodev/paperless-ng

linuxserver/paperless-ng

LinuxServer.io团队提供的Paperless-ng Docker镜像，具备定期应用更新、用户权限映射（PUID/PGID）、基于s6 overlay的自定义基础镜像、每周操作系统更新及安全更新等特性。

https://github.com/jonaswinkler/paperless-ng%E6%98%AF%E7%94%B1Daniel Quinn及其贡献者开发的应用，用于索引扫描文档，支持文档搜索和元数据存储。

支持的架构

该镜像支持多种架构，可通过Docker manifest实现多平台识别。直接拉取lscr.io/linuxserver/paperless-ng即可获取对应架构的镜像，也可通过标签指定特定架构：

应用设置

Web界面默认登录凭据为admin:admin，访问地址：http://%E6%9C%8D%E5%8A%A1%E5%99%A8IP:%E7%AB%AF%E5%8F%A3%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E5%8F%82%E8%A7%81https://github.com/jonaswinkler/paperless-ng%E3%80%82

容器提供管理命令别名，可执行上游文档中记录的https://paperless-ng.readthedocs.io/en/latest/administration.html%EF%BC%8C%E6%A0%BC%E5%BC%8F%E4%B8%BA%EF%BC%9A%60docker exec -it <容器名称> manage <命令>。例如：docker exec -it paperless manage document_retagger -tT`。

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  paperless-ng:
    image: docker.xuanyuan.run/linuxserver/paperless-ng
    container_name: paperless-ng
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
      - REDIS_URL= #可选
    volumes:
      - <主机配置文件路径>:/config
      - <主机数据文件路径>:/data
    ports:
      - 8000:8000
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=paperless-ng \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=America/New_York \
  -e REDIS_URL= `#可选` \
  -p 8000:8000 \
  -v <主机配置文件路径>:/config \
  -v <主机数据文件路径>:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/paperless-ng

参数

容器运行时通过参数配置，格式为<外部>:<内部>：

环境变量从文件（Docker secrets）

可通过FILE__前缀从文件设置环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

此命令会将/run/secrets/mysecretpassword文件内容作为PASSWORD环境变量的值。

应用运行的Umask设置

可通过-e UMASK=022覆盖容器内服务的默认umask设置。注意umask是权限减法而非加法，详情参见umask说明。

用户/组标识符

使用卷挂载时，可通过指定PUID（用户ID）和PGID（组ID）避免主机与容器间的权限问题。确保主机卷目录归属于指定的用户/组。

通过id user命令获取当前用户的PUID和PGID：

bash
$ id 用户名
  uid=1000(用户名) gid=1000(组名) groups=1000(组名)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=paperless-ng&query=%24.mods%5B%27paperless-ng%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=paperless-ng "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=universal "查看通用mods")

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8%E5%8F%8A%E9%80%9A%E7%94%A8mods%E3%80%82

支持信息

• 容器运行时进入shell：docker exec -it paperless-ng /bin/bash
• 实时查看容器日志：docker logs -f paperless-ng
• 获取容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' paperless-ng
• 获取镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/paperless-ng

更新信息

大多数镜像为静态版本，需更新镜像并重建容器以更新应用。以下是更新容器的方法：

通过Docker Compose

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull paperless-ng
• 重建容器：docker-compose up -d（或docker-compose up -d paperless-ng重建单个容器）
• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull docker.xuanyuan.run/linuxserver/paperless-ng
• 停止容器：docker stop paperless-ng
• 删除容器：docker rm paperless-ng
• 使用原参数重建容器（配置文件通过卷挂载保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅用于忘记原始参数时）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once paperless-ng

注意：不建议使用Watchtower进行自动化更新，长期推荐使用https://docs.linuxserver.io/general/docker-compose%E3%80%82

镜像更新通知 - Diun（Docker Image Update Notifier）

推荐使用https://crazymax.dev/diun/%E6%8E%A5%E6%94%B6%E6%9B%B4%E6%96%B0%E9%80%9A%E7%9F%A5%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E5%AE%B9%E5%99%A8%E7%9A%84%E5%B7%A5%E5%85%B7%E3%80%82

本地构建

如需本地修改或自定义镜像：

bash
git clone https://github.com/linuxserver/docker-paperless-ng.git
cd docker-paperless-ng
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/paperless-ng:latest .

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

注册后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 21年11月30日：添加jbig2enc。
• 21年10月07日：修复决定是否本地运行Redis的变量。
• 21年10月01日：因WebSocket问题将uwsgi替换为gunicorn。
• 21年07月24日：修复目录配置文件（sqlite数据库）的存储位置。
• 21年07月23日：修复初始用户创建。
• 21年07月10日：首次发布。