面向盘锦中小单位的本地档案管理系统部署纯干货全流程
一、前期准备（软硬件/数据要求）
所有操作从基础环境搭建开始，盘锦中小单位无需采购昂贵设备，按以下清单准备即可：
1.1 硬件环境
- 电脑主机：Windows 10/11 64位（最低4GB内存、128GB SSD；推荐8GB+256GB SSD，长期存扫描件需加机械硬盘）
- 可选配件：扫描仪（必须支持双面彩色，分辨率≥300dpi，推荐佳能DR-M160II/爱普生DS-410，驱动统一官网下载对应型号）
1.2 软件基础
- 免费数据库MySQL 8.0.39：下载地址 https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.39.0.msi
- 开源档案系统——Mayan EDMS精简版：本文用GitHub开源压缩包，下载地址 https://github.com/mayan-edms/mayan-edms/releases/download/v4.4.21/mayan-edms-4.4.21.tar.gz
- Python 3.10.12（64位）：Mayan EDMS依赖此版本，下载地址 https://www.python.org/ftp/python/3.10.12/python-3.10.12-amd64.exe
- Git Bash 64位：用于解压执行压缩包内脚本（避免Windows CMD兼容性问题），下载地址 https://github.com/git-for-windows/git/releases/download/v2.42.0.windows.1/Git-2.42.0-64-bit.exe
1.3 数据规范
现有纸质档案先分类按“全宗号-年度-保管期限-件号”手写编号，扫描件命名格式必须为全宗号_年度_保管期限_件号_档案标题.jpg（保管期限填永久/30年/10年）。
二、基础软件安装与配置
2.1 安装Python 3.10.12
打开下载的Python安装包，按以下关键步骤操作：
- 勾选界面底部的「Add Python 3.10 to PATH」
- 点击「Customize installation」→ 全选Optional Features → 点击「Next」→ 勾选「Install for all users」→ 自定义安装路径为「D:\Python310」（不要有中文或空格）→ 点击「Install」
验证安装：打开Git Bash，输入python --version，显示「Python 3.10.12」即为成功。
2.2 安装MySQL 8.0.39
打开下载的MySQL安装包，按以下关键步骤操作：
- 选择「Developer Default」→ 点击「Next」→ 检查依赖，点击「Execute」安装缺失组件
- 进入「Product Configuration」→ 点击「Next」→ 选择「Standalone MySQL Server / Classic MySQL Replication」→ 点击「Next」
- 保持默认端口3306 → 点击「Next」→ 设置root用户密码为Panjin2024!（必须包含大小写字母、数字、特殊符号）→ 点击「Next」→ 全选「Windows Service」配置项，服务名设为「MySQLMayan」→ 点击「Next」→ 点击「Execute」完成安装
- 打开Git Bash，输入
mysql -uroot -pPanjin2024!，进入MySQL命令行后依次执行以下代码（创建Mayan专用数据库和用户）：
2.3 安装Git Bash
打开下载的Git安装包，所有步骤保持默认，点击「Next」直到「Install」完成。
三、Mayan EDMS精简版部署
3.1 解压并初始化系统
打开Git Bash，依次执行以下命令（全程不要关闭Git Bash窗口）：
- 切换到D盘根目录：
cd /d/ - 创建部署文件夹：
mkdir MayanPanjin - 移动下载的压缩包到该文件夹（手动操作也可，Git Bash命令更快速）：
mv /c/Users/你的用户名/Downloads/mayan-edms-4.4.21.tar.gz MayanPanjin/（把「你的用户名」换成Windows登录名） - 进入部署文件夹：
cd MayanPanjin/ - 解压压缩包：
tar -zxvf mayan-edms-4.4.21.tar.gz - 重命名解压后的文件夹：
mv mayan-edms-4.4.21 mayan - 创建虚拟环境（隔离依赖）：
python -m venv venv - 激活虚拟环境：
source venv/Scripts/activate（激活后Git Bash命令行前会出现「(venv)」） - 升级pip到最新版：
pip install --upgrade pip - 安装Mayan EDMS依赖（耗时约10-20分钟，取决于网速）：
pip install -e mayan/
3.2 修改Mayan配置文件（连接MySQL）
手动打开路径「D:\MayanPanjin\venv\Lib\site-packages\mayan\settings\local.py」，如果没有该文件，复制同文件夹下的「local.py.sample」重命名为「local.py」，删除所有内容后粘贴以下完整配置：
```python from mayan.settings.production import DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'mayan_edms', 'USER': 'mayan', 'PASSWORD': 'MayanPanjin2024!', 'HOST': 'localhost', 'PORT': '3306', 'OPTIONS': { 'charset': 'utf8mb4', 'init_command': "SET sql_mode='STRICT_TRANS_TABLES'", }, } } ALLOWED_HOSTS = [''] 允许局域网内其他电脑访问（输入部署电脑IP:8000即可） LANGUAGE_CODE = 'zh-hans' 切换为简体中文 TIME_ZONE = 'Asia/Shanghai' 设置为北京时间 ```3.3 初始化数据库并创建管理员账号
回到激活虚拟环境的Git Bash窗口，依次执行以下命令：
- 同步数据库结构：
mayan-edms.py migrate - 创建超级管理员：
mayan-edms.py createsuperuser（按提示输入用户名、邮箱、密码，密码设为PanjinAdmin2024!方便记忆） - 收集静态文件（图片、样式等）：
mayan-edms.py collectstatic --noinput - 启动Mayan服务：
mayan-edms.py runserver 0.0.0.0:8000
四、系统使用与数据导入
4.1 登录系统
打开部署电脑的浏览器（推荐Chrome/Edge），输入地址「http://127.0.0.1:8000」，局域网内其他电脑输入「http://部署电脑IP:8000」（查看部署电脑IP的方法：打开Git Bash输入ipconfig，找到IPv4 Address后的内容），用刚才创建的超级管理员账号登录。
4.2 创建档案分类与规则
登录后按以下步骤操作：
- 点击左侧菜单「设置」→「文档类型」→「创建文档类型」，填写名称「盘锦本地文书档案」，点击「保存」
- 点击左侧菜单「设置」→「智能规则」→「创建智能规则」，名称填「自动匹配文书命名」，触发事件选「上传新文档后」，添加操作「设置文档的元数据」→ 配置元数据映射（将「全宗号」映射为文件名中的「第1个下划线前的内容」，以此类推），点击「保存」
4.3 批量导入扫描件
- 点击左侧菜单「文档」→「上传」→「批量上传」，选择整理好的规范命名扫描件文件夹，文档类型选「盘锦本地文书档案」，点击「开始上传」
- 上传完成后点击「文档列表」即可查看已归档的档案，支持按全宗号、年度、保管期限等条件搜索
五、后续维护
- 重启服务：关闭Git Bash窗口后重新打开，依次执行
cd /d/MayanPanjin/、source venv/Scripts/activate、mayan-edms.py runserver 0.0.0.0:8000 - 备份数据库：每周执行一次，打开Git Bash输入
mysqldump -uroot -pPanjin2024! mayan_edms > /d/MayanPanjin/backup_$(date +%Y%m%d).sql
相关文章
