phpEnv怎么安装Paperless-ngx phpEnv搭建无纸化办公方法-php教程-PHP中文网

phpenv 不能安装或运行 paperless-ngx，因其是基于 python（django）的 web 应用，依赖 postgresql、redis、tika、tesseract 等服务，而 phpenv 仅支持 php+nginx/apache 环境，不提供 python 运行时、数据库编排及容器化能力。

phpenv怎么安装paperless-ngx phpenv搭建无纸化办公方法

phpEnv 不能安装或运行 Paperless-ngx。

Paperless-ngx 是一个基于 Python（Django）的 Web 应用，依赖 PostgreSQL/MariaDB、Redis、Tika、OCR 引擎（如 Tesseract）等服务，完全不依赖 PHP 环境。而 phpEnv 是用于快速搭建多版本 PHP + Nginx/Apache 的本地开发环境工具（类似 phpbrew 或 laragon），它不提供 Python 运行时、数据库服务编排能力，也不支持容器化部署。

你如果在 Windows/macOS 上用 phpEnv，它默认只管理 php、nginx、mysql（通常是单体 MySQL，非 PostgreSQL），无法满足 Paperless-ngx 的最小运行栈要求。

为什么不能硬套 phpEnv？

常见误操作包括：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

试图把 Paperless-ngx 的 Python 后端丢进 phpEnv 的 www 目录下，期望用 Nginx 反代——会直接 502 或 404，因为没启动 Django gunicorn/uvicorn 服务
改用 phpEnv 自带的 MySQL 替代 PAPERLESS_DBENGINE=postgresql——Paperless-ngx 官方已弃用 MySQL 支持，且 schema 不兼容
手动 pip install 依赖后，在 phpEnv 终端里 runserver——缺少 Redis、Tika、celery worker 等后台服务，文档上传、OCR、分类全部失败

正确路径：绕过 phpEnv，用 Docker Compose 直装

这是目前最稳定、官方主推、且适配中文用户的部署方式。你不需要卸载 phpEnv，只需另开终端执行：

确保已安装 docker 和 docker-compose（v2.20+）
创建空目录：mkdir -p ~/paperless && cd ~/paperless
写入 docker-compose.yml（推荐 SQLite 版，适合个人）：

version: "3.8"
services:
  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:2.20.6
    restart: unless-stopped
    ports: ["9980:8000"]
    volumes:
      - ./data:/usr/src/paperless/data
      - ./media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    environment:
      PAPERLESS_DBENGINE: sqlite
      PAPERLESS_OCR_LANGUAGES: chi_sim+eng
      PAPERLESS_LANGUAGE: zh_CN
      PAPERLESS_TIME_ZONE: Asia/Shanghai
    deploy:
      resources:
        limits: {memory: 1g}