# COS-DEMO

**Repository Path**: gaga-coding/cos-demo

## Basic Information

- **Project Name**: COS-DEMO
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# COS Demo

简易腾讯云 COS 上传 / 下载 Web 界面。服务端通过环境变量配置 COS；浏览器用 `localStorage` 保存最近上传记录（无数据库）。

## 本地运行

```bash
cd cos-demo
python -m venv .venv
# Windows:
.venv\Scripts\activate
# Linux / macOS:
# source .venv/bin/activate

pip install -r requirements.txt
copy .env.example .env
# 编辑 .env，填写 COS_SECRET_ID、COS_SECRET_KEY、COS_REGION、COS_BUCKET

uvicorn main:app --host 0.0.0.0 --port 8000
```

浏览器访问：`http://127.0.0.1:8000/`

## 服务器部署（生产）

在项目目录下安装依赖并配置 `.env` 后，使用 Gunicorn + Uvicorn worker：

```bash
cd /path/to/cos-demo
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env && nano .env

gunicorn main:app -k uvicorn.workers.UvicornWorker -w 4 -b 0.0.0.0:8000
```

- `-w 4`：worker 数量，可按 CPU 调整。
- 前面可加 Nginx 反向代理到 `127.0.0.1:8000`，并配置 HTTPS。

**Windows 服务器**：Gunicorn 不支持 Windows，请用 Uvicorn 多进程（示例）或单进程：

```powershell
# 单进程（简单）
uvicorn main:app --host 0.0.0.0 --port 8000

# 多 worker（需安装 httptools，uvicorn[standard] 已包含）
uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4
```

仅开发 / 小规模可用单进程：

```bash
uvicorn main:app --host 0.0.0.0 --port 8000
```

## 环境变量

见 `.env.example`。`COS_KEY_PREFIX` 可选，上传对象会带此前缀；下载会校验 key 必须以前缀开头。