luv2codedotnet/paperless-ai

Papelio (Paperless AI)

Paperless-ngx 值得拥有的AI助手。
单一容器内实现自动文档分析、智能元数据提取、语义搜索和合同管理。

• 8080端口提供Web UI和REST API
• 连接现有https://github.com/paperless-ngx/paperless-ngx%E5%AE%9E%E4%BE%8B
• 多AI提供商支持：OpenAI · Azure OpenAI · Anthropic · Ollama · LM Studio

---

快速开始

1. 创建空目录并放入以下两个文件（docker-compose.yml 和 .env）
2. 在 .env 中填写密钥信息
3. 启动服务栈：

bash
docker compose up -d

4. 打开 http://<主机>:8080 并创建第一个管理员用户

服务栈包含：

• paperless-ai（本镜像）— 8080端口提供API和前端
• postgres:16-alpine — 应用数据库
• qdrant/qdrant — 用于RAG/语义搜索的向量数据库
• datalust/seq — 结构化日志（可选）

---

镜像标签

可通过 .env 中的 PAPERLESS_AI_VERSION 指定特定版本。

---

docker-compose.yml

yaml
services:
  postgres:
    image: postgres:16-alpine
    container_name: paperless-ai-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: paperless_ai
      POSTGRES_USER: paperless_ai
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - paperless-ai
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U paperless_ai -d paperless_ai"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s

  qdrant:
    image: qdrant/qdrant:latest
    container_name: paperless-ai-qdrant
    restart: unless-stopped
    # 安全提示：Qdrant 没有内置身份验证。
    # 仅本地调试时取消注释，切勿暴露到互联网。
    # ports:
    #   - "127.0.0.1:6333:6333"
    #   - "127.0.0.1:6334:6334"
    volumes:
      - qdrant_data:/qdrant/storage
    networks:
      - paperless-ai
    healthcheck:
      test: ["CMD-SHELL", "timeout 1 bash -c '</dev/tcp/localhost/6333' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s

  seq:
    image: datalust/seq:latest
    container_name: paperless-ai-seq
    restart: unless-stopped
    # Seq 控制台：本地访问时取消注释。远程访问使用SSH隧道。
    # ports:
    #   - "127.0.0.1:5341:80"
    environment:
      ACCEPT_EULA: "Y"
      SEQ_FIRSTRUN_ADMINPASSWORD: ${SEQ_ADMIN_PASSWORD}
    volumes:
      - seq_data:/data
    networks:
      - paperless-ai
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  paperless-ai:
    image: luv2codedotnet/paperless-ai:${PAPERLESS_AI_VERSION:-latest}
    container_name: paperless-ai
    restart: unless-stopped
    ports:
      - "8080:8080"
    stop_grace_period: 30s
    networks:
      - paperless-ai
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://+:8080
      - ConnectionStrings__DefaultConnection=Host=postgres;Database=paperless_ai;Username=paperless_ai;Password=${POSTGRES_PASSWORD}
      - Jwt__Secret=${JWT__SECRET}
      - Jwt__Issuer=PaperlessAI
      - Jwt__Audience=PaperlessAI
      - Jwt__AccessTokenExpirationMinutes=15
      - Jwt__RefreshTokenExpirationDays=7
      - Encryption__Key=${ENCRYPTION__KEY}
      - Qdrant__Url=http://qdrant:6333
      - Serilog__WriteTo__1__Args__serverUrl=http://seq
      - Paperless__Url=${PAPERLESS__URL}
      - Paperless__Token=${PAPERLESS__TOKEN}
      - Urls__PublicUrl=${URLS__PUBLICURL}
    depends_on:
      postgres:
        condition: service_healthy
      qdrant:
        condition: service_healthy
      seq:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

networks:
  paperless-ai:
    name: paperless-ai

volumes:
  postgres_data:
    name: paperless-ai-postgres-data
  qdrant_data:
    name: paperless-ai-qdrant-data
  seq_data:
    name: paperless-ai-seq-data

---

.env

使用 openssl rand -base64 32 生成强密钥，并在首次启动前替换占位符。

env
# Docker镜像标签（使用"latest"或固定特定版本）
PAPERLESS_AI_VERSION=latest

# PostgreSQL密码（至少16个字符；首次启动后不易更改）
POSTGRES_PASSWORD=change-me-openssl-rand-base64-24

# JWT签名密钥（至少32个字符；更改会使所有会话失效）
JWT__SECRET=change-me-openssl-rand-base64-32

# 用于存储API密钥/Paperless令牌/OIDC密钥的AES-256加密密钥
# 32字节，Base64编码。更改会导致现有密钥无法读取。
ENCRYPTION__KEY=change-me-openssl-rand-base64-32

# 用户在浏览器中输入的公共URL（用于CORS和OIDC重定向）
# 必须与浏览器显示完全一致，非标准端口需包含端口号
URLS__PUBLICURL=https://paperless-ai.example.com

# Paperless-ngx连接（从容器内部可访问 — 非localhost）
PAPERLESS__URL=http://paperless:8000
PAPERLESS__TOKEN=your-paperless-admin-api-token

# 可选：Seq日志查看器的管理员密码
# SEQ_ADMIN_PASSWORD=admin

---

必需环境变量

可选环境变量

---

端口与卷

命名卷（需备份以保留数据）：

• paperless-ai-postgres-data — 应用数据库
• paperless-ai-qdrant-data — 向量嵌入
• paperless-ai-seq-data — 日志

---

创建Paperless-ngx管理员令牌

PAPERLESS__TOKEN 必须属于Paperless-ngx的超级用户：

bash
docker exec paperless python manage.py generate_token <管理员用户名>

或通过Paperless-ngx的Django管理界面：设置 → Django管理 → 令牌。

---

© Digital B - IT Consulting GmbH