本地部署开源主流文书档案系统 超详细零门槛实操全指南
一、前置准备
只需满足以下两个条件即可，无需额外安装Java、MySQL等复杂环境：
1. 硬件/系统要求
2核4G以上配置的服务器或个人电脑，支持Windows、Linux、macOS任意系统，预留10G以上磁盘存储空间即可。
2. 安装Docker环境
- Linux系统（Ubuntu/CentOS）直接复制执行以下命令，自动完成安装： ``` curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun curl -L "https://github.com/docker/compose/releases/download/2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose systemctl enable --now docker ```
- Windows/macOS系统直接从官方地址下载安装包，一路下一步即可完成：
https://www.docker.com/products/docker-desktop/
最后确认9999端口未被其他程序占用即可。
二、部署实操步骤
所有配置都可以直接复制，无需手动修改任何参数（需要自定义端口可自行调整）：
1. 创建配置文件
在任意空文件夹下，新建名为docker-compose.yml的文件：
- Linux系统执行命令
vi docker-compose.yml，进入编辑模式后粘贴以下完整内容： - Windows系统需要先开启「文件扩展名显示」，避免文件实际名为docker-compose.yml.txt，右键新建文本文档，重命名为
docker-compose.yml后粘贴内容：
粘贴完成后保存文件退出即可。
2. 启动服务
打开终端/命令提示符，进入存放配置文件的文件夹，执行以下命令：
``` docker-compose up -d ```执行完成后等待3-5分钟，系统会自动完成数据库初始化和服务启动，输入docker logs -f archivesys，看到输出中出现Started Application即为启动成功。
3. 登录系统初始化
打开浏览器，输入访问地址：本地部署输入http://localhost:9999，服务器部署输入http://你的服务器IP:9999，使用默认管理员账号登录：
默认账号：admin，默认密码：admin123
登录后系统会强制要求修改密码，设置新密码后即可进入主界面开始使用。
三、核心配置与归档实操
1. 基础分类配置
使用前需要先按单位需求创建文书档案分类，步骤如下：
- 点击左侧菜单栏档案管理 → 档案分类管理
- 点击右上角「新增分类」，填写分类名称（如：行政公文、项目合同、人事档案），选择档案保存期限（永久/30年/10年）
- 点击「确定」即可完成分类创建，可多级分类嵌套。
2. 文书归档上传
日常归档操作步骤，看完即可直接上手：
- 点击左侧菜单栏在线归档 → 新增归档
- 选择刚刚创建的对应档案分类，填写带的必填项：文书标题、文号、归档日期、责任者、归档人
- 点击「上传附件」，上传对应的PDF/Word格式文书原件，单个文件最大支持50M，可同时上传多个附件
- 确认所有信息无误后，点击「提交归档」，文书就正式存入档案库了。
四、常见问题解决
1. 无法访问系统怎么办？
- 如果是云服务器，先去云服务商控制台的安全组，放行9999端口的TCP入站规则；本地部署则开放防火墙对应端口：
Linux放行命令：ufw allow 9999/tcp，CentOS额外执行：firewall-cmd --add-port=9999/tcp --permanent && firewall-cmd --reload - 如果端口被占用，修改docker-compose.yml中
"9999:8080"，把9999改成其他未占用端口，然后执行docker-compose up -d重启即可。
2. 忘记管理员密码怎么办？
直接复制执行以下命令，即可重置密码为默认的admin123：
``` docker exec archivesys mysql -uroot -parchives123456 -e "UPDATE archivesys.sys_user SET password='e10adc3949ba59abbe56e057f20f883e' WHERE username='admin';" ```3. 如何备份数据？
所有数据都存放在配置文件同目录的archive-data文件夹中，直接复制整个文件夹到其他位置，即可完成全量备份，迁移时直接放到新服务器对应目录即可。
相关文章
