环境与背景 #

• 设备：树莓派5
• 系统：Debian Trixie
• 部署方式：Docker安装Paperless-ngx，已成功运行
• 已上传文档现状：在/paperless-ngx/media/documents/originals目录下的文件均为扁平化命名，具体列表如下：

-rw-r--r-- 1 pierrot 166300 14 jan 19:59 0000001.pdf
-rw-r--r-- 1 pierrot 453908 14 jan 20:09 0000002.pdf
-rw-r--r-- 1 pierrot 171460 14 jan 20:25 0000003.pdf
-rw-r--r-- 1 pierrot 632003 14 jan 21:33 0000004.pdf
-rw-r--r-- 1 pierrot 218267 14 jan 22:02 0000005.pdf
-rw-r--r-- 1 pierrot 354021 14 jan 22:12 0000006.pdf
-rw-r--r-- 1 pierrot 248148 14 jan 22:20 0000007.pdf
-rw-r--r-- 1 pierrot 244836 14 jan 23:11 0000008.pdf
-rw-r--r-- 1 pierrot 768796 14 jan 23:19 0000009.pdf

需求与配置操作 #

我了解到可以通过PAPERLESS_FILENAME_FORMAT配置项定义文档的分层存储结构，想要实现的最终路径格式为：/{{created_year}}/{{correspondent}}/{{document_type}}/{{title}}.pdf（比如/2025/company/bill/filename.pdf）。

具体配置操作：

1. 编辑paperless-ngx/docker-compose.env文件，添加目标配置项，最终相关配置内容如下：

PAPERLESS_URL=http://s.server.ch
PAPERLESS_TIME_ZONE=Europe/Zurich
PAPERLESS_OCR_LANGUAGE=fra
PAPERLESS_SECRET_KEY='pEIWILLqchangedme3bX*k!siCHANGEMEK+ZBl|'
PAPERLESS_FILENAME_FORMAT={{created_year}}/{{correspondent}}/{{document_type}}/{{title}}

2. 保存配置文件后，重启了树莓派，同时尝试在Paperless-ngx界面中重新保存已上传的文档

问题现象 #

整个过程没有出现任何报错，但/paperless-ngx/media/documents/originals目录下的文件结构完全没有变化，依然是原来的扁平化数字命名格式，没有生成按年/联系人/文档类型/标题分层的文件夹结构。

已尝试的排查与操作 #

1. 查阅相关信息得知，修改PAPERLESS_FILENAME_FORMAT后需要手动运行文档重命名工具
2. 执行docker ps查看运行中的容器，结果如下：

88691b0f1fdd   ghcr.io/paperless-ngx/paperless-ngx:latest    paperless-webserver-1
7baf29d6bb65   redis:8                                                                paperless-broker-1
f9e74337bba7   postgres:18                                                             paperless-db-1

3. 尝试进入webserver容器执行重命名命令：

docker exec -it paperless-webserver-1 document_renamer

但执行完成后，文件结构还是没有任何变化。

求助 #

有没有朋友遇到过类似的问题？或者能指出我哪里操作有误，该怎么调整才能让Paperless-ngx按照我设置的格式生成对应的文件夹结构？麻烦指点一下，非常感谢！