华为云云耀云服务器L实例评测｜云耀云服务器L实例部署paperless-ngx文档管理系统

一、云耀云服务器L实例介绍

1.1 云耀云服务器L实例简介

云耀云服务器L实例是新一代的轻量应用云服务器，专为中小企业和开发者设计，提供便捷的开箱即用体验。该产品提供丰富且经过严格筛选的应用镜像，可一键部署应用，极大程度简化了客户在云端构建电商网站、Web应用、小程序、学习环境以及各类开发测试等任务的过程。

1.2 云耀云服务器L实例特点

• 智能不卡顿：华为云擎天架构加持，软硬协同结合AI算法智能调度，为您提供优质性能。华为云全球存算一张网，数据传输时延比眨眼还短，满足游戏、音视频等低网络时延场景的高要求。

• 价优随心用：超高性价比，超低门槛，敞开随心用。多种实例规格，平衡性能与成本。技术升级优化用云成本，普惠更多初创企业和开发者。

• 上手更简单：多种镜像、资源组合一键下单。严选多款高品质镜像，经过华为云官方严格测试，覆盖七大场景，预置模板，快速搭建，安全可信。自动化编排，资源一键开通，业务分钟级上线。平滑学习曲线，向导式应用搭建，应用轻松启用。

• 管理更省心：拓扑、资源、镜像可视化管理，业务架构透明化管理。贴心服务状态提醒，资源续退一键式操作，实现极简管理。资源负载、安全，使用率实时监控，保障服务永远在线。可选配丰富的安全服务，包括丰富的备份、主机安全等服务，提供最高等级的安全防护。

二、paperless-ngx介绍

2.1 paperless-ngx简介

Paperless-ngx 是一个开源的文档管理系统，可以将您的物理文档转换为可搜索的在线文件，这样您就可以减少纸张的使用。

2.2 paperless-ngx特点

• 使用标签、通讯员、类型等组织和索引扫描的文档。

• 对您的文档执行 OCR，将可选择的文本添加到仅图像文档中，并向您的文档添加标签、通讯员和文档类型。

• 支持 PDF 文档、图像、纯文本文件和 Office 文档（Word、Excel、Powerpoint 和 LibreOffice 等效项）。

• 无纸化将您的文档直接存储在磁盘上。文件名和文件夹采用无纸化管理，格式可自由配置。

• 单页应用程序前端。

• 全文搜索可帮助您找到所需内容。

• 电子邮件处理：无纸化添加来自您的电子邮件帐户的文档。

• 机器学习驱动的文档匹配。

• 针对多核系统进行了优化：Paperless-ngx 并行使用多个文档。

• 集成的完整性检查器可确保您的文档存档状况良好。

三、本次实践介绍

3.1 本次实践简介

1.本次实践为个人测试学习环境，旨在快速部署应用，生产环境请谨慎；
2.本次实践环境为云耀云服务器L实例，使用的应用镜像为Portainer 2.18.4；
3.由于使用的应用镜像为Portainer，云服务器自动已部署好Docker环境；
4.在华为云云耀云服务器L实例上部署paperless-ngx文档管理系统。

3.2 本次环境规划

服务器类别	应用镜像	内网IP地址	Docker版本	Portainer版本
云耀云服务器L实例	Docker可视化Portainer	192.168.0.168	24.0.4	2.18.4

四、购买云耀云服务器L实例

4.1 购买云耀云服务器L实例

• 购买步骤：

1.官网链接：https://www.huaweicloud.com/product/hecs-light.html
2.购买规格：
区域：华北—北京四；
应用镜像：Docker可视化-Portainer；
实例规格：2核2G/系统盘40G/峰值带宽 3Mbps/流量包400G；
实例名称：自定义即可，这里编辑为HECS-L-Portainer；
购买时长：1个月。

• 选择好规格后付款即可。

4.2 查看云耀云服务器L实例状态

查看购买的华为云云耀云服务器L实例状态，启动后正常运行中。

4.3 重置服务器密码

点击远程登录云耀云服务器L实例

重置密码，点击右侧的重置密码选项，需要进行身份验证，选择手机验证后，即可重置密码成功。

五、检查服务器环境

5.1 Xshell远程连接服务器

• 复制云耀云服务器L实例的弹性公网IP地址，在远程连接服务器时使用。

• 在Xshell工具中，填写服务器弹性公网IP地址、账号密码信息，ssh连接远程服务器。

• 成功使用Xshell工具连接到华为云云耀云服务器L实例

5.2 检查操作系统版本

检查云耀云服务器L实例的操作系统版本，当前操作系统版本为Ubuntu 22.04.1 LTS。

root@hcss-ecs-f91c:~# cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.1 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.1 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=jammy

5.3 检查Docker服务状态

检查Docker服务状态，确保Docker服务正常运行。

root@hcss-ecs-f91c:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2023-09-07 18:25:51 CST; 1 week 0 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 30672 (dockerd)
      Tasks: 46
     Memory: 64.1M
        CPU: 8min 23.784s
     CGroup: /system.slice/docker.service

5.4 检查docker compose版本

检查docker compose版本

root@hcss-ecs-f91c:~# docker compose version
Docker Compose version v2.19.1

六、部署paperless-ngx文档管理系统

6.1 下载paperless-ngx镜像

从docker hub下载paperless-ngx相关镜像

docker pull docker.io/library/redis:7
docker pull  docker.io/library/mariadb:10
docker pull ghcr.io/paperless-ngx/paperless-ngx:latest

补充：ghcr.io/paperless-ngx/paperless-ngx:latest镜像拉取过慢时，可以使用我的华为云镜像仓库中的swr.cn-north-4.myhuaweicloud.com/jeven/paperless-ngx:latest

docker pull swr.cn-north-4.myhuaweicloud.com/jeven/paperless-ngx:latest

6.2 创建挂载目录

创建挂载目录/data/ngx/

 mkdir -p /data/ngx  && cd /data/ngx/

6.3 编辑docker-compose.yaml文件

编辑docker-compose.yaml文件

version: "3.6"
services:
  broker:
    image: docker.io/library/redis:7
    restart: unless-stopped
    volumes:
      - redisdata:/data

  db:
    image: docker.io/library/mariadb:10
    restart: unless-stopped
    volumes:
      - dbdata:/var/lib/mysql
    environment:
      MARIADB_HOST: paperless
      MARIADB_DATABASE: paperless
      MARIADB_USER: paperless
      MARIADB_PASSWORD: paperless
      MARIADB_ROOT_PASSWORD: paperless

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - db
      - broker
    ports:
      - "8390:8000"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000"]
      interval: 30s
      timeout: 10s
      retries: 5
    volumes:
      - data:/usr/src/paperless/data
      - media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
#    env_file: docker-compose.env
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBENGINE: mariadb
      PAPERLESS_DBHOST: db
      PAPERLESS_DBUSER: paperless # only needed if non-default username
      PAPERLESS_DBPASS: paperless # only needed if non-default password
      PAPERLESS_DBPORT: 3306


volumes:
  data:
  media:
  dbdata:
  redisdata:

6.4 部署paperless-ngx

使用docker compose部署paperless-ngx文档管理系统

docker compose up -d

6.5 检查paperless-ngx容器状态

检查paperless-ngx容器状态，确保paperless-ngx容器正常启动。

root@hcss-ecs-f91c:/data/ngx# docker compose ps
NAME                IMAGE                                                         COMMAND                  SERVICE             CREATED             STATUS                   PORTS
ngx-broker-1        docker.io/library/redis:7                                     "docker-entrypoint.s…"   broker              3 minutes ago       Up 3 minutes             6379/tcp
ngx-db-1            docker.io/library/mariadb:10                                  "docker-entrypoint.s…"   db                  3 minutes ago       Up 3 minutes             3306/tcp
ngx-webserver-1     swr.cn-north-4.myhuaweicloud.com/jeven/paperless-ngx:latest   "/sbin/docker-entryp…"   webserver           3 minutes ago       Up 3 minutes (healthy)   0.0.0.0:8390->8000/tcp, :::8390->8000/tcp

6.6 检查容器运行日志

检查容器运行日志，确保paperless-ngx服务正常启动。

docker compose logs 

七、访问paperless-ngx

7.1 放行安全组端口

进入云耀云服务器L实例的安全组管理页面，放行入方向安全组端口8390。

7.2 创建登录用户

• 进入 ngx-webserver-1容器中

root@hcss-ecs-f91c:/data/ngx# docker exec -it ngx-webserver-1 /bin/bash
root@5810057966c5:/usr/src/paperless/src#

• 创建超级用户与密码

python3 manage.py createsuperuser

7.3 访问paperless-ngx首页

访问地址：http://弹性公网IP地址:8390，将IP替换为自己服务器的弹性公网IP地址。
使用刚创建账号密码登录即可。

八、paperless-ngx的基本使用

8.1 设置系统语言

设置系统语言为中文，点击保存即可。

8.2 上传新文档

在仪表盘页面的右侧，上传新文档。

8.3 查看文档内容

点击文档模块，浏览文件内容。

8.4 编辑文档

点击编辑文档选项，可以对文件相关内容进行编辑。