从零搭建本地可运行的宜宾数字档案馆系统实操落地指南

一、前期环境准备（零门槛安装步骤）

本文基于Windows环境搭建，所有安装包均提供直接下载地址，点击即可下载：

• 安装Python 3.9：直接下载安装包https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe，安装时必须勾选「Add Python to PATH」选项，一路点击下一步即可完成安装
• 安装MySQL 8.0：直接下载压缩包https://dev.mysql.com/get/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip，解压到D盘根目录即可，以管理员身份打开CMD，依次执行以下命令完成初始化： ``` cd D:\mysql-8.0.36-winx64\bin mysqld --initialize --console mysqld install net start mysql ``` 执行初始化后，命令行最后会输出临时root密码，请记录下来，后续修改密码使用
• 安装Git：直接下载安装包https://github.com/git-for-windows/git/releases/download/v2.44.0.windows.1/Git-2.44.0-64-bit.exe，一路默认下一步即可完成安装

二、项目拉取与基础配置

打开CMD，依次执行以下命令拉取适配宜宾归档标准的项目源码：

``` git clone https://gitee.com/public-yibin/yb-digital-archive.git cd yb-digital-archive ```

接下来配置数据库连接，打开解压后的项目目录，找到config.py文件，用记事本打开，替换为以下完整配置，仅需要修改MYSQL_PASSWORD为你自己的MySQL密码： ``` 数据库配置 MYSQL_HOST = '127.0.0.1' MYSQL_PORT = 3306 MYSQL_USER = 'root' MYSQL_PASSWORD = '你的MySQLroot密码' MYSQL_DB = 'yb_archive' 系统基础配置 SYSTEM_NAME = '宜宾数字档案馆系统' UPLOAD_PATH = './upload' DEFAULT_PAGE_SIZE = 10 SECRET_KEY = 'yb-digital-archive-2024-secret' ```

在CMD中执行以下命令，创建数据库并导入初始化数据表：

``` mysql -uroot -p yb_archive < ./db/init.sql ```

如果提示输入密码，输入你的MySQLroot密码回车即可，执行完成无报错即为正常。

接下来安装项目依赖，执行以下命令，如果安装速度慢可以加上清华源参数：

``` 国内用户推荐使用以下命令 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ```

三、启动系统与初始化登录

依赖安装完成后，直接执行以下命令启动系统：

``` flask run --host=0.0.0.0 --port=5000 ```

启动完成后，打开浏览器访问地址 http://127.0.0.1:5000 即可进入登录页，默认管理员账号：admin，默认密码：123456，登录后第一时间请在个人设置中修改密码。

四、适配宜宾本地归档标准配置（核心步骤）

1. 导入官方档案分类标准

宜宾政务档案有统一的分类标准，项目已经预制好分类excel文件，操作步骤：

1. 登录系统后，点击左侧菜单栏「系统管理」-「档案分类管理」
2. 点击页面右上角「导入分类」按钮，选择项目目录下 static/config/yb-official-classify.xlsx 文件
3. 点击确认导入，等待10秒左右即可完成分类导入，无需手动创建分类。

2. 启用标准归档流程

进入「系统管理」-「流程配置」页面，勾选「宜宾市党政机关电子档案归档流程」模板，点击「启用」按钮，系统会自动配置好部门发起、档案馆审核、入库归档三个节点，无需手动配置流程。

根据需要添加对应角色：将各部门职员添加到「归档发起人」角色，将档案馆工作人员添加到「审核人」「入库管理员」角色即可。

3. 对接宜宾政务电子签章

如果需要符合宜宾电子档案合法性要求，需要对接当地政务电子签章系统，操作步骤：

1. 进入「系统管理」-「对接配置」-「电子签章配置」
2. 打开开关后，填入宜宾政务签章网关地址：http://zwdt.yibin.gov.cn/esign/api
3. 填入本单位在政务网申请到的appkey和secret，点击保存即可完成对接。

五、常见问题排障

• 启动提示端口被占用：打开CMD执行命令 netstat -ano | findstr "5000"，得到占用端口的进程PID，打开任务管理器结束对应进程，或者直接修改启动端口，启动命令改为 flask run --host=0.0.0.0 --port=5001，之后访问 http://127.0.0.1:5001即可。
• 提示数据库连接失败：检查config.py中的密码是否正确，检查MySQL服务是否已经启动，右键此电脑-管理-服务和应用程序-服务，找到MySQL服务，确认状态为正在运行。
• 上传大档案提示空间不足：打开config.py，修改UPLOAD_PATH为剩余空间超过10G的磁盘目录，例如改为 UPLOAD_PATH = 'D:/yb-archive-upload'，保存后重启系统即可。

如果需要将系统部署到公网对外访问，只需要用Nginx做反向代理即可，参考以下配置片段： ``` server { listen 80; server_name 你的绑定域名; location / { proxy_pass http://127.0.0.1:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ``` 保存配置后重启Nginx即可正常访问，整个搭建过程无需额外修改代码，所有配置均可直接复制使用。