Skip to content

Nathan-Peng/HTTPS-FileServer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HTTPS-FileServer

Python License Platform Auto-SSL Version

轻量、安全、开箱即用的纯 Python 局域网 HTTPS 文件服务
无 OpenSSL 依赖、无需额外配置、快速部署、自动生成 SSL 证书,适合内网设备互传、资源托管、私有文件共享。

✨ 项目亮点

  • 全自动 SSL 证书:基于 cryptography 纯代码生成,跨平台,启动即用
  • 全站 HTTPS 加密:禁用明文 HTTP,仅保留高强度 TLS 加密,内网传输安全
  • 单文件极简部署:所有前端页面内嵌代码,仓库干净无冗余静态文件
  • 分级权限控制:本机回环 IP 只读,局域网设备可上传/删除,安全隔离
  • 双重上传防护:后缀黑名单 + 文件魔数校验,拦截伪装与可执行文件
  • 现代化自适应 UI:明暗主题自动切换,移动端/桌面端完美适配
  • 智能日志清洗:自动过滤乱码与无效字符,日志整洁易排查

📁 项目结构

HTTPS-FileServer/
├── HTTPS 文件服务.py        # 主程序
├── 生成SSL证书.py        # 生成自签名证书,仅首次需运行
├── 启动.bat        # 程序入口
├── LICENSE        # MIT 开源协议
└── .gitignore     # 项目忽略规则

运行自动生成:

  • server.crt / server.key:自动生成 SSL 证书
  • uploaded/:上传文件目录
  • server.log:服务运行日志

🚀 快速开始

环境依赖

Python 3.8+

安装依赖

pip install cryptography

启动服务

python 生成SSL证书.py
python HTTPS 文件服务.py

访问地址

  • 本机:https://127.0.0.1:8443
  • 局域网:https://[内网IP]:8443

自签名证书浏览器提示不安全为正常现象,选择「继续访问」即可正常加密使用。

📌 功能路由

路由 功能
/ 目录文件浏览器
/upload.html 批量文件上传页
/uploaded 上传文件归档目录
/dashboard 服务监控面板
/zip.html 目录在线打包工具
/api/status 服务状态接口

🛡️ 安全机制

  • 传输安全:仅启用 TLS 安全协议,关闭老旧弱加密套件,全程 HTTPS
  • 上传安全:禁止可执行文件上传,校验文件真实二进制类型,防止伪装文件
  • 权限安全:本地 IP 只读保护,仅局域网设备具备写入、删除权限
  • 路径防护:严格路径规范化,杜绝目录穿越攻击

📊 服务能力

  • 目录浏览、文件下载、在线删除
  • 拖拽批量上传、自动日期归档
  • 目录一键 ZIP 压缩下载
  • 实时监控运行时长、连接数、请求统计、上传统计
  • Gzip 压缩 + 静态资源缓存,访问速度更快
  • 异常连接容错,稳定后台运行

⚠️ 使用说明

本项目为内网私有服务,适用于家庭、办公局域网、本地开发场景,不建议直接暴露至公网

📄 开源协议

基于 MIT License 开源,可自由使用、修改与分发。

Star History

Star History Chart

About

纯 Python 实现的轻量化局域网 HTTPS 加密文件服务,自动生成 SSL 证书、全页面内嵌单文件部署,支持文件浏览、拖拽上传、目录 ZIP 打包、权限隔离与运行监控面板,内网安全文件共享,开箱即用。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors