基于国内三家知名档案管理系统开源版快速搭建公司轻量测试环境

发布时间: 2026年06月04日 03:10:03 来源: 安答联动浏览量: 0

前期准备：3家头部开源档案系统的筛选与资源获取

筛选规则说明

本次选取的开源系统需满足：开源协议友好（Apache 2.0/GPL v3，可内部商用测试）、有中文文档、部署流程标准化、GitHub/Gitee Star≥5k的三个国内厂商开源产品：

奥思维奥奇档案开源版
鸿翼档案管理开源版Lite
档掌柜云档案开源版基础版

资源获取与环境依赖

环境统一要求：Windows 10/11 或 Ubuntu 20.04 LTS 64位，内存≥4GB，磁盘≥20GB。

依赖包/软件下载（复制对应地址/命令即可）：

奥奇档案开源版：https://gitee.com/osway-os/aoqi-file/releases/tag/v2.0.0
鸿翼Lite：https://gitee.com/hongyilite/hongyi-archives-lite/releases/tag/v1.2.0
档掌柜基础版：https://gitee.com/dangzhanggui/dangzhanggui-cloud/releases/tag/v3.0.0
通用依赖（Windows下）：Docker Desktop 4.20.0（https://www.docker.com/products/docker-desktop/），安装后开启Hyper-V/WSL2并切换到Linux容器；Ubuntu下：执行sudo apt update && sudo apt install docker.io docker-compose -y

实操1：奥思维奥奇档案开源版一键部署

奥奇开源版基于Spring Boot+MySQL，采用Docker Compose打包，部署最快。

步骤1：解压下载的资源包

下载后解压aoqi-file-v2.0.0-docker-compose.zip到本地任意目录（如D:\aoqi-docker）。

步骤2：修改配置文件（可选，推荐）

打开解压目录下的.env文件，可修改MySQL初始密码、服务端口：

默认端口：前端8080，后端8081，MySQL3306；若端口冲突，将AQ_PORT_FRONTEND=8080这类参数改为未占用端口（如AQ_PORT_FRONTEND=8082）
默认MySQL密码：root123456；建议修改为自己的强密码

步骤3：启动服务

Windows：在解压目录空白处按住Shift+右键，选择“在终端中打开”，输入docker-compose up -d
Ubuntu：进入解压目录，执行sudo docker-compose up -d

验证步骤：打开浏览器访问http://本机IP:前端端口（如本机IP是192.168.1.100，端口改了8082则访问http://192.168.1.100:8082），默认账号密码：admin / admin123。

实操2：鸿翼档案管理开源版Lite轻量部署

基于国内三家知名档案管理系统开源版快速搭建公司轻量测试环境

鸿翼Lite基于Node.js+PostgreSQL，无Docker也可部署，适合不想装Docker的环境。

步骤1：补充环境依赖（非Docker方式）

Node.js 16.x LTS：https://nodejs.org/dist/v16.20.2/node-v16.20.2-x64.msi（Windows）或Ubuntu下执行curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - && sudo apt install -y nodejs
PostgreSQL 14.x：https://www.postgresql.org/download/windows/（Windows安装时记住初始密码，端口默认5432）或Ubuntu下执行sudo apt install postgresql-14 -y

步骤2：配置PostgreSQL数据库

打开PostgreSQL的pgAdmin（Windows）或Ubuntu下执行sudo -u postgres psql，依次输入以下SQL：

```sql -- 创建数据库 CREATE DATABASE hongyi_lite; -- 创建用户 CREATE USER hongyi_user WITH PASSWORD 'hongyi123456'; -- 授权 GRANT ALL PRIVILEGES ON DATABASE hongyi_lite TO hongyi_user; -- 切换到新数据库（Ubuntu） \c hongyi_lite; -- 授权schema权限（Ubuntu） GRANT ALL ON SCHEMA public TO hongyi_user; ```

步骤3：修改配置文件

解压hongyi-archives-lite-v1.2.0.zip到本地，打开config/config.js，修改数据库配置：

```javascript module.exports = { db: { host: '127.0.0.1', port: 5432, user: 'hongyi_user', password: 'hongyi123456', database: 'hongyi_lite' }, server: { port: 3000 // 可修改未占用端口 } }; ```

步骤4：初始化与启动

在解压目录终端执行npm install安装依赖
执行npm run init-db初始化数据库表结构
执行npm start启动服务

验证步骤：访问http://本机IP:3000，默认账号密码：admin / admin123。

实操3：档掌柜云档案开源版基础版集群最小配置部署

档掌柜基础版是微服务架构，但提供最小1节点部署包，适合想体验微服务档案系统的场景。

步骤1：解压并配置Docker Compose

解压dangzhanggui-cloud-v3.0.0-minimal.zip到本地，打开docker-compose-minimal.yml，确认端口未冲突：

前端端口：80；后端网关：8080；MySQL：3307；Redis：6380；若冲突，将对应ports下的"外部端口:内部端口"外部部分修改

步骤2：启动微服务集群

Windows终端进入解压目录，输入docker-compose -f docker-compose-minimal.yml up -d
Ubuntu终端进入解压目录，输入sudo docker-compose -f docker-compose-minimal.yml up -d

验证步骤：启动成功后需等待3-5分钟（微服务初始化慢），访问http://本机IP:外部前端端口，默认账号密码：sysadmin / sysadmin123。

轻量测试环境的基础操作验证

三个系统部署完成后，统一做以下基础验证，确保环境可用：

创建档案分类：登录后进入“档案管理-分类管理”，新增“2024年行政档案”分类
上传测试档案：进入“档案管理-档案录入”，选择刚创建的分类，上传1-2个PDF/Word文档
检索与下载：在首页搜索框输入文档关键词，验证检索结果，点击下载确认文件完整性
用户权限分配：进入“系统管理-用户管理”，新增测试用户，分配“档案录入员”权限，用测试账号登录验证权限是否生效

常见卡壳问题解决

Docker镜像拉取慢：Windows打开Docker Desktop设置→Docker Engine，添加镜像源配置： ```json { "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ] } ``` 保存重启Docker；Ubuntu编辑/etc/docker/daemon.json，添加同样内容后执行sudo systemctl restart docker
奥奇档案后台提示数据库连接失败：打开解压目录的docker-compose.yml，确认aq-mysql服务启动顺序在aq-backend之前
鸿翼Lite npm install 失败：使用淘宝镜像源，执行npm config set registry https://registry.npmmirror.com后重新安装
档掌柜基础版登录报错：再次确认等待时间是否足够，或执行docker logs dangzhanggui-gateway查看网关日志