本地部署文书档案系统零门槛实操落地详细指南

前置准备

需准备的工具与环境：1. 任意运行Windows/macOS/Linux的电脑；2. 已安装Docker Desktop（Windows/macOS）或Docker Engine（Linux）；3. 电脑至少2G可用内存（Docker默认占用1.5G左右）。

Docker官方下载地址：Windows/macOS：https://www.docker.com/products/docker-desktop；Linux（Ubuntu）执行安装命令：

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

实操部署步骤

步骤1：创建部署专用目录

打开终端（Windows按Win+R输入cmd，macOS打开启动台的终端，Linux按Ctrl+Alt+T），执行命令：

``` mkdir -p ~/local-docs-system && cd ~/local-docs-system ```

注意：Linux系统请勿加sudo执行，避免后续权限异常。该目录所有配置与数据将统一存放，方便管理与备份。

步骤2：编写Docker Compose配置文件

在当前部署目录创建名为docker-compose.yml的文件，直接复制以下完整内容，请勿修改：

```yaml version: '3.8' services: openkm: image: openkm/openkm-ce:latest container_name: local-archives ports: - "8080:8080" volumes: - ./openkm/repository:/usr/local/tomcat/webapps/ROOT/WEB-INF/classes/repository - ./openkm/database:/usr/local/tomcat/webapps/ROOT/WEB-INF/classes/database environment: - JAVA_OPTS=-Xmx1024m -Xms512m restart: always postgres: image: postgres:14 container_name: local-archives-db environment: - POSTGRES_USER=openkm - POSTGRES_PASSWORD=openkm123 - POSTGRES_DB=openkm volumes: - ./postgres/data:/var/lib/postgresql/data restart: always ```

配置说明：将启动两个容器，分别为文书档案服务（OpenKM）和数据库（PostgreSQL），数据挂载到本地目录，删除容器不会丢失数据。

步骤3：启动部署

在部署目录执行命令，全程不要关闭终端或断开网络：

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

等待3-5分钟，系统会自动下载镜像并启动，容器状态变为“Up”即部署完成。

步骤4：验证系统可用性

打开浏览器，必须输入完整地址：http://localhost:8080/OpenKM，加载后出现登录界面则部署成功。

默认登录账号：admin，默认密码：admin，第一次登录会强制要求修改密码，需设置8位以上包含字母与数字的新密码。

核心日常操作

1. 创建文书档案分类

登录后，左侧菜单点击「分类」→「新建分类」，输入分类名称（如“合同档案”“项目文档”），点击确定后会出现在左侧树状菜单，后续档案可按分类存放。

2. 上传档案文件

选中目标分类，点击右上角「上传」，支持拖拽本地Word、Excel、PDF等常用格式文件，单文件默认限制100MB，后续可调整。支持批量上传，无需逐个操作。

3. 权限配置

选中某个分类，点击「权限」→「添加用户」，选择需授权的账号后，可设置该用户的权限（查看、编辑、删除），默认仅admin账号拥有全部权限。

常见问题排查

问题1：容器启动后无法访问页面

先执行命令查看容器状态：

``` docker ps -a ```

若状态不是“Up”，查看错误日志：

``` docker logs local-archives ```

常见原因：内存不足，Windows/macOS需进入Docker Desktop设置，将内存调整为2G以上；Linux需确认Docker服务已启动，执行：

``` sudo systemctl start docker ```

问题2：上传文件超过100MB失败

执行命令进入OpenKM容器：

``` docker exec -it local-archives bash ```

修改上传大小限制为1GB，执行命令：

``` sed -i 's/maxUploadSize="104857600"/maxUploadSize="1048576000"/g' /usr/local/tomcat/webapps/ROOT/WEB-INF/classes/context.xml ```

重启容器生效：

``` docker-compose restart ```

日常维护操作

数据备份

在部署目录执行命令，将所有数据打包为带日期的备份文件：

``` tar -zcvf archives-backup-$(date +%Y%m%d).tar.gz ./openkm ./postgres ```

备份文件会存放在部署目录，建议每周执行1次备份。

系统版本更新

更新前务必执行备份，步骤如下：

1. 停止运行中的容器：
``` docker-compose down ```
2. 拉取最新版本镜像：
``` docker-compose pull ```
3. 启动新容器：
``` docker-compose up -d ```

更新后登录系统，检查分类与文件是否正常。