档案管理软件 Docker 部署：小白也能一次成功的保姆级教程

你是不是也经常被文件搞得焦头烂额？

咱们先说个真事儿。老板让你找去年的合同，你打开电脑，发现文件夹里乱七八糟。全是“最终版”、“绝对不改版”、“再改我是狗版”。你翻得满头大汗，心里那个急啊。要是再找不到，估计得挨批。

其实，你缺的不是硬盘空间，是一个好用的档案管理软件。别一听“软件部署”就头大，觉得那是程序员的事儿。今天我就教你用 Docker 搞定它。别被这名字吓着，说白了就是个能帮你把文件管得服服帖帖的工具。只要你会打字，照着做就能成。看完这篇，你也能轻松搞定。

1. 为什么非要折腾 Docker？

可能你会问，我直接下载个 .exe 安装包不行吗？为啥非要用 Docker？这里面大有门道。听我给你盘道盘道。

1.1 告别环境配置的噩梦

以前咱们装软件，是不是经常报错？一会儿说缺个运行库，一会儿说版本不对。特别是档案管理这种软件，往往还要配数据库。这对普通人来说，简直是劝退。

Docker 就厉害了。它把软件运行需要的一切，都打包在一个“盒子”里。不管你的系统是 Windows 还是 Linux，不管你有没有装乱七八糟的插件，它都能跑。这就好比去饭店吃饭，你不用管菜怎么洗、火怎么开，直接吃就行。

1.2 就像带着房子搬家

传统软件搬家特别麻烦。你换台电脑，得重新装，还得把数据导出来再导进去。稍微不注意，数据就丢了。

用 Docker 部署，就像是住集装箱房。你要搬家，连房子带家具一起搬走。到了新地方（新服务器），放下来通电就能用。里面的配置、数据，一点都不会变。这对咱们这种想长期保存档案的人来说，太重要了。

2. 选个好用的软件：Paperless-ngx

工欲善其事，必先利其器。市面上软件很多，但我强烈推荐你用 Paperless-ngx。这可是开源界的“瑞士军刀”，完全免费，功能还贼强。

2.1 它是扫描文件的“克星”

这个软件最牛的地方是 OCR（文字识别）。你把纸质合同扫描成图片或 PDF，通常是不能搜索内容的。但 Paperless-ngx 能把图片里的字“抠”出来。

举个例子：你扫描了一张发票。上传后，软件自动识别出金额、日期。以后你想搜“5000块”，这张发票直接就弹出来。这比翻纸质袋子快一万倍。

2.2 准备一台“小主机”

要部署这个，你得有台机器。别担心，不用买昂贵的服务器。家里吃灰的旧电脑、笔记本，或者群晖、威联通这种 NAS 都行。只要能装上 Linux 系统（比如 Ubuntu），或者你的 NAS 支持 Docker 容器，就完全 OK。

配置也不用太高，CPU 别太老，内存给个 2GB 以上就能跑得欢。硬盘越大越好，毕竟档案是越存越多的。

3. 三步走，把软件跑起来

好了，机器准备好了，咱们开始动手。这部分我写得细，你一步一步跟着敲命令就行。

3.1 先把 Docker 装上

如果你的机器是裸机（刚装的 Linux 系统），得先装 Docker。别去官网下载安装包，太慢。直接用命令行，一行代码搞定。

你可以直接复制下面这段命令，回车。它会自动下载并安装最新版 Docker。

```bash curl -fsSL https://get.docker.com | sh ```

装完之后，输入 docker -v。如果显示了一串版本号，恭喜你，第一步成功了！

3.2 写个“说明书”（docker-compose.yml）

这是最关键的一步。咱们得告诉 Docker，你想怎么运行这个软件。咱们用 Docker Compose 来管理。你需要建一个文件夹，在里面建个文件，名字叫 docker-compose.yml。

把下面这段代码复制进去。这是配置好的“万能模板”，你不用改太多，注意看注释。

```yaml version: "3.8" services: broker: image: docker.io/library/redis:7 restart: always volumes: - ./redisdata:/data db: image: docker.io/library/postgres:15 restart: always volumes: - ./postgresdata:/var/lib/postgresql/data environment: POSTGRES_USER: paperless POSTGRES_PASSWORD: paperless POSTGRES_DB: paperless webserver: image: ghcr.io/paperless-ngx/paperless-ngx:latest restart: always ports: - "8000:8000" volumes: - ./data:/usr/src/paperless/data - ./media:/usr/src/paperless/media - ./export:/usr/src/paperless/export - ./consume:/usr/src/paperless/consume environment: PAPERLESS_REDIS: redis://broker:6379 PAPERLESS_DBHOST: db PAPERLESS_DBUSER: paperless PAPERLESS_DBPASS: paperless PAPERLESS_DBNAME: paperless PAPERLESS_OCR_LANGUAGE: chi_sim 设置为简体中文识别 depends_on: - db - broker ```

这里有个小细节要注意。代码里的 volumes 部分，冒号左边是路径。比如 ./data，意思是把数据存在你当前目录下的 data 文件夹里。这样即使你把容器删了，文件还在你电脑上，绝对安全。

3.3 输入命令，启动！

文件建好了，咱们在当前目录下打开终端。输入这行命令：

```bash docker compose up -d ```

这时候，Docker 会去网上拉取镜像。第一次会比较慢，因为它要下载大概 1GB 左右的文件。你可以去喝杯茶，等着它跑完。

看到屏幕上出现 Done 或者 Started 之类的字样，就说明启动成功了！打开浏览器，输入 http://你的机器IP地址:8000。比如你的机器 IP 是 192.168.1.5，那就输入 192.168.1.5:8000。

第一次登录，默认账号是 admin，密码也是 admin。进去之后系统会让你改密码，记得改个复杂的。

4. 几个千万别踩的坑

软件跑起来了，不代表万事大吉。我有几个血泪经验分享给你，避开了能省好多事。

4.1 端口别打架

我在配置文件里写的是 8000 端口。但如果你这台机器上还跑了别的软件，也占用了 8000，那就起不来了。

怎么判断？如果启动报错，说端口被占用。你就去改 docker-compose.yml。把 "8000:8000" 改成 "8001:8000"。这样你访问的时候，就得在浏览器里输 8001 端口。这个灵活变通就行。

4.2 数据要存“外面”

再次强调，一定要配置 volumes �射。如果你懒，没配置这一项，数据就会存在容器内部。哪天你想升级软件，把旧容器删了，你的所有档案瞬间灰飞烟灭。那时候你哭都来不及。一定要像我给的模板那样，把数据映射到宿主机的文件夹里。

4.3 中文识别要开好

很多老外写的教程，OCR 语言默认是英语。你传进去中文文档，它识别出来全是乱码。我在配置文件里特意加了 PAPERLESS_OCR_LANGUAGE: chi_sim。这一行千万别漏，不然它就不认识中国字了。

好了，赶紧去试试吧！

方法都交给你了，真的不难。只要你照着做，半小时内就能搭好属于你自己的数字图书馆。以后不管是发票、合同，还是孩子的成长记录，扫一扫传上去，打几个字就能找到。

别光收藏文章不动手。今晚回家，找台旧电脑，跟着教程敲一遍命令。当你第一次在浏览器里搜到那张乱放的发票时，你会回来感谢我的。动起来！