从零搭建可直接用的网络版档案管理系统 实操全指南

一、前期准备（5分钟完成）

你需要先安装Python 3.8+环境，不同系统安装命令直接复制执行：

• Ubuntu/Debian：sudo apt update && sudo apt install python3 python3-pip -y
• CentOS/RHEL：sudo yum install python3 python3-pip -y
• MacOS（需提前装Homebrew）：brew install python3
• Windows：直接下载安装包（务必勾选Add Python to PATH）：https://www.python.org/ftp/python/3.11.4/python-3.11.4-amd64.exe

二、核心搭建步骤（10分钟完成）

1. 创建项目与虚拟环境

在任意路径下执行命令，创建项目目录并初始化虚拟环境（隔离依赖，避免冲突）：

创建项目目录：执行 mkdir archive_net && cd archive_net

激活虚拟环境：

• Linux/Mac：source venv/bin/activate（执行后终端前会出现(venv)标识）
• Windows：venv\Scripts\activate（执行后命令提示符前会出现(venv)标识）

2. 安装必须依赖

在激活的虚拟环境中执行命令，安装Web框架与文件处理工具：

pip install flask werkzeug sqlite3（sqlite3是Python内置库，无需额外安装）

3. 编写核心代码（完整复制即可）

在项目目录下创建 app.py 文件，复制以下代码（无需修改，直接运行）：

```python import os from flask import Flask, render_template, request, send_from_directory from werkzeug.utils import secure_filename 初始化应用 app = Flask(__name__) 配置参数 UPLOAD_FOLDER = './archives' ALLOWED_EXTENSIONS = {'txt', 'pdf', 'doc', 'docx', 'xls', 'xlsx', 'jpg', 'png'} app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER 确保上传目录存在 os.makedirs(UPLOAD_FOLDER, exist_ok=True) 检查文件类型是否合法 def allowed_file(filename): return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS 首页：上传+档案列表 @app.route('/') def index(): files = os.listdir(app.config['UPLOAD_FOLDER']) return render_template('index.html', files=files) 上传档案接口 @app.route('/upload', methods=['POST']) def upload_file(): if request.method == 'POST': file = request.files['file'] if file and allowed_file(file.filename): filename = secure_filename(file.filename) file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename)) return '上传成功！返回首页' return '文件类型不支持或未选择文件！返回首页' 下载档案接口 @app.route('/download/') def download_file(filename): return send_from_directory(app.config['UPLOAD_FOLDER'], filename, as_attachment=True) if __name__ == '__main__': 监听所有网卡，允许局域网访问（核心：0.0.0.0） app.run(host='0.0.0.0', port=5000, debug=True) ```

4. 编写前端页面（必须步骤）

在项目目录下创建 templates 文件夹，再在其中创建 index.html 文件，复制以下代码：

```html 网络版档案管理系统

上传档案

已上传档案

{% for file in files %}

{{ file }}

{% else %}

暂无档案，请先上传

{% endfor %}

```

三、启动与访问（必操作）

1. 启动服务

在激活的虚拟环境终端中执行：python app.py，终端会输出类似：Running on http://0.0.0.0:5000 的提示。

2. 局域网内访问

获取本机IP（关键）：

• Windows：执行 ipconfig，找到「IPv4地址」（比如192.168.3.105）
• Linux/Mac：执行 ip addr（Linux）或 ipconfig getifaddr en0（Mac），找到inet后的地址

访问方式： 同一局域网内的其他设备，打开浏览器输入：http://[你的本机IP]:5000（比如http://192.168.3.105:5000）

网络连通问题解决： 若无法访问，检查本机防火墙是否开放5000端口，Windows可在防火墙设置中添加入站规则允许5000端口通行；Linux可执行 sudo ufw allow 5000

四、日常操作指南

• 上传档案：打开地址后，选择文件点击上传，支持txt、pdf、doc等8种常用格式
• 查看/下载档案：首页直接显示所有已上传文件，点击文件名即可直接下载
• 临时关闭服务：在启动服务的终端按 Ctrl+C 即可停止运行
• 重启服务：需先激活虚拟环境，再重复执行 python app.py