# 网络小龙

**Repository Path**: valstrax/draconnet

## Basic Information

- **Project Name**: 网络小龙
- **Description**: 局域网上下传输文件服务器
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-09
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 局域网内文件传输管理器
## 介绍
基于```Python Starlette```和```Vue3```的文件传输web服务器，用于小型局域网内、少量用户、**不关注隐私及安全性**的情况下进行文件传输。换个说法就是我的手机没有内置Samba、ftp文件浏览器，用QQ/WX传又会显得比较多垃圾信息，所以写了个应用

## 开发和构建：  
1. 下载源代码（git clone和直接下载zip都行）  
2. 安装开发依赖  
2.1. 进入```frontend```目录，在那个目录里面执行```npm install```  
2.2. 进入```backend```目录，在那个目录里面执行```pip install -r requirements.txt```  
3. 构建代码（任选一个方式）  
3.1 运行```build.bat```。会生成```release```文件夹，这个文件夹在```backend```和```frontend```旁边（同级）。  
3.2 在```frontend```目录执行```npm run build```，然后把```dist```文件夹复制到```backend```目录下面，然后名称修改成```html```。

## 运行
如果你是build.bat编译的，那么进入```release```文件夹，在里面依次执行：
```shell
python preflight.py
python app.py
```
如果你是手动构建的，那么进入```backend```目录，在里面依次执行：
```shell
python preflight.py
python app.py
```

## 创建独立运行环境
如果你不想污染系统的python，你可以用python-embed来运行。
1. 去[pythong.org](https://github.com/indygreg/python-build-standalone)下载3.13.9的Embedded版本（快捷连接：[windows-amd-x64](https://www.python.org/ftp/python/3.13.9/python-3.13.9-embed-amd64.zip)）。然后整包解压到一个文件夹（如python-3.13.9-embed-amd64）。
2. 在解压生成的文件夹（如python-3.13.9-embed-amd64）里找到```python313._pth```，重命名为```python313.pth```。
3. 在解压生成的文件夹（如python-3.13.9-embed-amd64）里打开命令行，运行```.\python.exe -m ensurepip```
4. 在解压生成的文件夹（如python-3.13.9-embed-amd64）移动到程序目录（```release```或```backend```）里边
5. 在程序目录（```release```或```backend```）里打开命令行，执行安装依赖。
```shell
python-3.13.9-embed-amd64\python.exe -m pip install -r requirements.txt
# python-3.13.9-embed-amd64改成你的运行环境路径
```
6. 运行程序：
```shell
python-3.13.9-embed-amd64\python.exe app.py
#同理替换路径。
```
## docker 部署
如果你是使用```build.bat```构建的，那么```release\draconnet-pkg\```文件夹里面有```dockerfile```和```docker-compose.yml```。可以直接在目录运行```docker-compose up -d```。

## 程序其他信息
### 用户权限等级
- 管理员admin，需要账户密码登录，可以使用所有功能
- 普通用户user，需要账户密码登录，可以使用大部分功能，不能进行一些删除操作、管理API等
- 游客用户guest，不需要账户密码登录，可以在```app-config.yaml```启用或关闭。只能查看文件列表、下载文件
- API机器人，没有会话文件，只能访问一些API功能区定义的url

## TODO   
创建API时的文件选择功能