十分钟搞定公有云部署档案管理系统实操指南

一、云服务器基础环境配置

你需要购买一台云服务器。推荐配置为2核4G内存、40G硬盘，操作系统选择Ubuntu 22.04 LTS。购买完成后，必须在云控制台的安全组中开放以下端口：80（HTTP）、443（HTTPS）、22（SSH）。

使用SSH工具连接到服务器：

ssh root@你的服务器公网IP

连接成功后，执行以下命令更新系统源并安装必要的工具：

apt update && apt upgrade -y
apt install -y curl wget git vim

二、安装Docker与Docker Compose环境

为了简化部署流程，我们将使用Docker容器化技术。执行以下一键安装命令（配置了阿里云镜像加速，适合国内网络环境）：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

安装完成后，启动Docker服务并设置开机自启：

systemctl start docker
systemctl enable docker

接着安装Docker Compose插件：

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

验证安装是否成功：

docker --version
docker-compose --version

三、部署Paperless-ngx核心服务

本文以开源界最流行的Paperless-ngx为例进行实操。创建项目目录：

mkdir -p /data/paperless
cd /data/paperless

创建必要的持久化数据目录：

mkdir -p consume export media db redis

创建docker-compose.yml配置文件，直接复制以下完整内容：

version: "3.4"
services:
broker:
image: docker.io/library/redis:7
restart: always
volumes:
- ./redis:/data
db:
image: docker.io/library/postgres:15
restart: always
volumes:
- ./db:/var/lib/postgresql/data
environment:
POSTGRES_DB: paperless
POSTGRES_USER: paperless
POSTGRES_PASSWORD: paperless
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
restart: always
depends_on:
- db
- broker
ports:
- "8000:8000"
volumes:
- ./data:/usr/src/paperless/data
- ./media:/usr/src/paperless/media
- ./export:/usr/src/paperless/export
- ./consume:/usr/src/paperless/consume
env_file:
- .env
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000"]
interval: 30s
timeout: 10s
retries: 5
consumer:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
restart: always
depends_on:
- db
- broker
volumes:
- ./data:/usr/src/paperless/data
- ./media:/usr/src/paperless/media
- ./export:/usr/src/paperless/export
- ./consume:/usr/src/paperless/consume
env_file:
- .env
command: /usr/src/paperless/src/manage.py document_consumer

在同级目录下创建.env环境变量文件，这是系统运行的关键配置：

 基础配置
PAPERLESS_REDIS=redis://broker:6379
PAPERLESS_DBHOST=db
PAPERLESS_DBPORT=5432
PAPERLESS_DBNAME=paperless
PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=paperless
管理员配置（首次启动后生效）
PAPERLESS_ADMIN_USER=admin
PAPERLESS_ADMIN_PASSWORD=your_secure_password
PAPERLESS_TIME_ZONE=Asia/Shanghai
OCR配置（启用中文识别）
PAPERLESS_OCR_LANGUAGE=chi_sim+eng
PAPERLESS_OCR_MY_LANGUAGE=chi_sim+eng
禁用自动更新，保证生产环境稳定
PAPERLESS_ENABLE_UPDATE_CHECK=false

注意：请将 your_secure_password 修改为一个高强度的密码。

四、配置Nginx反向代理与HTTPS

为了安全访问，必须配置SSL证书。首先安装Nginx和Certbot：

apt install -y nginx certbot python3-certbot-nginx

编辑Nginx配置文件 /etc/nginx/sites-available/paperless.conf：

server {
listen 80;
server_name your-domain.com;  请替换为你的域名或公网IP
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}

创建软链接并启用配置：

ln -s /etc/nginx/sites-available/paperless.conf /etc/nginx/sites-enabled/
rm /etc/nginx/sites-enabled/default
nginx -t
systemctl reload nginx

申请SSL证书（执行命令后根据提示选择域名并同意条款）：

certbot --nginx -d your-domain.com

证书申请成功后，Certbot会自动修改Nginx配置以支持HTTPS。

五、启动服务与初始化配置

回到项目目录，启动所有容器：

cd /data/paperless
docker-compose up -d

查看容器运行状态，确保所有服务都是 Up 状态：

docker-compose ps

如果启动失败，使用以下命令查看日志排查错误：

docker-compose logs webserver

服务启动大约需要1-2分钟。等待完成后，在浏览器中访问 https://your-domain.com。你将看到Paperless-ngx的登录界面。

使用 .env 文件中配置的 PAPERLESS_ADMIN_USER 和 PAPERLESS_ADMIN_PASSWORD 登录。登录后，系统会自动引导你完成初始设置，包括设置文档归档路径和OCR语言偏好。

至此，一套完整的、支持中文OCR识别、具备HTTPS加密的档案管理系统已在公有云上成功部署。你可以通过上传PDF或图片，系统将自动识别其中的文字内容，便于后续检索和管理。