# FlaskFileShare

**Repository Path**: zjh1023/flask-file-share

## Basic Information

- **Project Name**: FlaskFileShare
- **Description**: 使用Python Flask服务器开发的简易局域网文件传输工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-08
- **Last Updated**: 2025-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Flask, Python

## README

# FlaskFileShare ——极简单的局域网分享工具

## 1. Docker部署（推荐）

**（以linux为例）**

在releases界面下载镜像

**导入镜像**

```bash
docker load < ./flask-file-share.tar
```

### 1.1 创建并启动容器

```bash
docker run --restart=no -d --name flask-file-share1 -p 3005:8011 -v flask-file-share1:/app/data flask-file-share
```

访问`localhost:3005`或`<宿主机ip地址>:3005`访问服务。

同网段下其他终端可以通过`<宿主机ip地址>:3005`访问服务。

**卷**存在于宿主机的 `/var/lib/docker/volumes`。

### 1.2 其他docker命令列举：

**推荐博客（https://blog.csdn.net/m0_63653444/article/details/139130248）**

查看现有容器

```bash
sudo docker ps
```

停止容器

```bash
sudo docker stop <container-id>
```

删除容器

```bash
sudo docker rm <container-id>
```

查看现有镜像

```bash
sudo docker images
```

删除镜像

```bash
sudo docker rmi <image-id>
```

保存镜像到本地

```bash
sudo docker save -o <文件路径>/<文件名> <镜像名>:latest
```

## 2. 本地部署

### 2.1 Flask服务器的启动

检查当前目录下是否存在`.data/`文件夹，如果没有需要新建：

```bash
mkdir data
```

**确保你在虚拟环境里（推荐）**
 创建并激活虚拟环境（可选但强烈推荐）：

```bash
python -m venv venv
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # Windows
```

**安装依赖** 使用 pip 安装 `requirements.txt` 中的所有依赖：

```bash
pip install -r requirements.txt
```

**启动flask服务器** 在bash中运行下面命令：

```bash
python ./run.py
```

终端显示例如：

```bash
$ /home/zjh/Desktop/documents/code/web3/FlaskFileShare/.venv/bin/python /home/zjh/Desktop/documents/code/web3/FlaskFileShare/run.py
启动HTTP服务: http://198.18.0.1:8011/static 服务所在的文件目录是 ./data
 * Serving Flask app 'app'
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:8011
 * Running on http://10.105.37.173:8011
Press CTRL+C to quit
```

在浏览器中访问http://10.105.37.173:8011，就通过web可以在同一个局域网内的不同设备上访问`./data`文件夹下的所有内容。

### 2.2 个性化设置

1. 如果你对共享文件夹`./data`的大小有限制，可以更改app.py文件的第20行，默认大小为1GB

   ```python
   app.config['MAX_CONTENT_LENGTH'] = 1 * 1024 * 1024 * 1024  # Default 1GB
   ```

2. 如果你想更改共享文件夹为其他文件夹，可以更改app.py文件的第15行，默认共享的文件夹为`./data`

   ```python
   ROOT_PATH = './data'
   ```

3. ...