lingyuzeng/labweb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(supabase): 整理 Storage 文档和示例代码

Browse Source 
- 创建 docs/ 目录存放所有文档
  - QUICK_START.md: 快速入门指南
  - OPERATIONS_GUIDE.md: 完整运维指南
  - VUE_API_INTEGRATION.md: Vue 集成文档
  - DEPLOYMENT_INFO.md: 部署配置信息
  - versions.md: 版本信息

- 创建 examples/ 目录存放示例代码
  - storage_client.py: Python 完整客户端
  - storage_client.js: JavaScript 完整客户端
  - test_https_storage.py: 功能测试脚本

- 新增 README_STORAGE.md 作为 Storage 使用指南

- 修复签名 URL 生成问题（需要 /storage/v1 前缀）
- 测试脚本支持资源已存在的情况
- 所有客户端代码已验证可用

功能特性：
✓ 公网 HTTPS 访问
✓ 文件上传/下载
✓ 生成临时下载链接
✓ 完整的 REST API 客户端
✓ 支持 Python 和 JavaScript
This commit is contained in:
zly
2025-11-22 21:03:00 +08:00
parent 8b068d8171
commit 9fa602f21b
9 changed files with 3261 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

237
supabase-stack/README_STORAGE.md Normal file
View File

@@ -0,0 +1,237 @@
# Supabase Storage 对象存储使用指南
完整的 Supabase 对象存储解决方案，支持公网 HTTPS 访问。
---
## 📚 文档导航
### 快速开始
- **[快速入门](docs/QUICK_START.md)** - 5 分钟快速上手指南
- **[运维指南](docs/OPERATIONS_GUIDE.md)** - 完整的系统架构和运维文档
### 集成文档
- **[Vue API 集成](docs/VUE_API_INTEGRATION.md)** - Vue 应用集成指南
- **[部署信息](docs/DEPLOYMENT_INFO.md)** - 部署配置详情
---
## 💻 客户端代码
所有示例代码位于 `examples/` 目录：
### Python 客户端
```bash
# 查看完整客户端代码
cat examples/storage_client.py
# 使用示例
python3 << 'EOF'
import sys
sys.path.insert(0, 'examples')
from storage_client import SupabaseStorageClient
client = SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
)
# 上传文件
client.upload_file('bucket', 'photo.jpg', 'uploads/photo.jpg')
# 生成临时下载链接
url = client.create_signed_url('bucket', 'uploads/photo.jpg', 3600)
print(f'临时下载链接: {url}')
EOF
```
### JavaScript 客户端
```bash
# 查看完整客户端代码
cat examples/storage_client.js
# 在网页中使用
<script src="examples/storage_client.js"></script>
<script>
const client = new SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
);
// 上传文件
await client.uploadFile('bucket', fileObject, 'uploads/photo.jpg');
// 生成临时下载链接
const url = await client.createSignedUrl('bucket', 'uploads/photo.jpg', 3600);
</script>
```
---
## 🧪 测试
运行完整的功能测试：
```bash
# 测试所有 Storage API 功能
python3 examples/test_https_storage.py
```
测试包含：
- ✓ 列出 Buckets
- ✓ 创建 Bucket
- ✓ 上传/更新文件
- ✓ 下载文件
- ✓ 生成签名 URL（临时下载链接）
---
## 🚀 快速开始
### 1. 启动服务
```bash
# 启动 Supabase + MinIO
docker compose -f docker-compose.yml -f docker-compose.s3.yml up -d
```
### 2. 测试服务
```bash
python3 examples/test_https_storage.py
```
### 3. 使用客户端
**Python**:
```python
from examples.storage_client import SupabaseStorageClient
client = SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-api-key'
)
```
**JavaScript**:
```javascript
// 在浏览器中
const client = new SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-api-key'
);
```
---
## 🌐 访问端点
- **Storage API**: `https://amiap.hzau.edu.cn/supa/storage/v1`
- **Dashboard**: `http://100.64.0.2:18000` (内网)
---
## 📂 项目结构
```
supabase-stack/
├── docs/ # 📚 文档
│ ├── QUICK_START.md # 快速入门
│ ├── OPERATIONS_GUIDE.md # 运维指南
│ ├── VUE_API_INTEGRATION.md # Vue 集成
│ ├── DEPLOYMENT_INFO.md # 部署信息
│ └── versions.md # 版本信息
│
├── examples/ # 💻 示例代码
│ ├── storage_client.py # Python 客户端
│ ├── storage_client.js # JavaScript 客户端
│ └── test_https_storage.py # 测试脚本
│
├── docker-compose.yml # Supabase 核心服务
├── docker-compose.s3.yml # MinIO 对象存储
├── .env # 环境变量配置
│
├── README.md # Supabase 原始说明
├── README_STORAGE.md # Storage 使用指南（本文档）
└── CHANGELOG.md # 版本变更记录
```
---
## 🔑 认证密钥
在 `.env` 文件中：
```bash
# 服务密钥（后端使用，完全权限）
SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
# 匿名密钥（前端使用，受权限控制）
ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```
---
## ⚙️ 服务管理
```bash
# 查看服务状态
docker compose ps
# 查看日志
docker compose logs -f storage
# 重启服务
docker compose restart storage
# 停止服务
docker compose stop
```
---
## 🛠️ 故障排查
查看 [运维指南](docs/OPERATIONS_GUIDE.md) 的故障排查章节。
---
## 📝 更多信息
- **完整文档**: 查看 `docs/` 目录
- **代码示例**: 查看 `examples/` 目录
- **原始 README**: [README.md](README.md)
---
## ✅ 功能特性
- ✅ 公网 HTTPS 访问
- ✅ 子路径支持（无需子域名）
- ✅ 文件上传/下载
- ✅ 生成临时下载链接（签名 URL）
- ✅ Bucket 管理
- ✅ 文件列表/移动/复制/删除
- ✅ Python 和 JavaScript 客户端
- ✅ 完整的 REST API
---
## 🎯 使用场景
1. **Web 应用文件上传** - 用户头像、附件等
2. **临时文件分享** - 生成带过期时间的下载链接
3. **静态资源托管** - 图片、视频、文档
4. **移动应用存储** - 跨平台数据同步
5. **数据备份** - 自动化备份脚本
---
## 📞 技术支持
如有问题，请查看：
1. [快速入门](docs/QUICK_START.md) - 基础使用
2. [运维指南](docs/OPERATIONS_GUIDE.md) - 深入了解
3. 测试脚本 - `python3 examples/test_https_storage.py`
🎉 **开始使用 Supabase Storage！**

293
supabase-stack/docs/DEPLOYMENT_INFO.md Normal file
View File

@@ -0,0 +1,293 @@
# Supabase 部署信息汇总
## 🌐 访问地址
### HTTPS 域名访问（推荐用于 API）
```
API Base URL: https://amiap.hzau.edu.cn/supa
```
### 内网访问（用于 Dashboard）
```
Dashboard: http://100.64.0.2:18000
API Base: http://100.64.0.2:18000
```
---
## 🔑 认证信息
### Dashboard 登录
```
URL: http://100.64.0.2:18000
用户名: lab-admin
密码: 017b7076cfb25bd18410d1e5f4f7ec5a
```
### API Keys（用于前端/后端开发）
```javascript
// ✅ 公开密钥 - 可以在前端使用
ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlIiwiaWF0IjoxNzYzODAyNjY5LCJleHAiOjIwNzkxNjI2Njl9.ltGXvQKpguLaf8Vzomn310hLgOZbrjqZT-F3rR00ulg"
// ⚠️ 私密密钥 - 仅后端使用，不要暴露
SERVICE_ROLE_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoic2VydmljZV9yb2xlIiwiaXNzIjoic3VwYWJhc2UiLCJpYXQiOjE3NjM4MDI2NjksImV4cCI6MjA3OTE2MjY2OX0.gQWUaTkZ6mjjlv2TED0cODp2meqqWuCGKZR1ptIbovg"
```
### 数据库连接
```
主机: 100.64.0.2 或 db (容器内)
端口: 5432
数据库: postgres
用户: postgres
密码: a837234b952ad7aa9ab4852f47021660c038209a71fce027cec8bab37ad82ae5
```
---
## 📡 API 端点
### ✅ 可用的服务端点
| 服务 | HTTPS 端点 | 内网端点 | 用途 |
|------|-----------|----------|------|
| REST API | `https://amiap.hzau.edu.cn/supa/rest/v1/` | `http://100.64.0.2:18000/rest/v1/` | 数据库 CRUD 操作 |
| Auth API | `https://amiap.hzau.edu.cn/supa/auth/v1/` | `http://100.64.0.2:18000/auth/v1/` | 用户认证 |
| Storage API | `https://amiap.hzau.edu.cn/supa/storage/v1/` | `http://100.64.0.2:18000/storage/v1/` | 文件存储 |
| Realtime | `wss://amiap.hzau.edu.cn/supa/realtime/v1/websocket` | `ws://100.64.0.2:18000/realtime/v1/websocket` | 实时订阅 |
| Dashboard | ❌ 不可用 | `http://100.64.0.2:18000/` | 管理界面 |
---
## 🐳 Docker 服务状态
### 核心服务
```bash
# 查看所有服务状态
docker compose ps
# 核心服务列表
supabase-db # PostgreSQL 数据库
supabase-kong # API 网关（端口: 18000）
supabase-auth # 用户认证服务
supabase-rest # REST API 服务
supabase-storage # 文件存储服务
supabase-realtime # 实时订阅服务
supabase-studio # Dashboard
supabase-meta # 数据库元数据
supabase-analytics # 日志分析
```
### 常用命令
```bash
# 进入 supabase-stack 目录
cd /vol1/1000/docker_server/traefik/supabase-stack
# 启动所有服务
docker compose up -d
# 停止所有服务
docker compose down
# 查看服务日志
docker compose logs -f kong
docker compose logs -f rest
docker compose logs -f auth
# 重启特定服务
docker compose restart kong
docker compose restart rest
```
---
## 🔧 配置文件
### 重要文件位置
```
/vol1/1000/docker_server/traefik/supabase-stack/
├── .env # 环境变量配置
├── docker-compose.yml # Docker Compose 配置
├── VUE_API_INTEGRATION.md # Vue 集成文档（已创建）
├── DEPLOYMENT_INFO.md # 本文件
├── volumes/
│ ├── api/kong.yml # Kong 网关配置
│ ├── db/ # 数据库数据目录
│ └── storage/ # 文件存储目录
```
### .env 关键配置
```bash
# 数据库
POSTGRES_PASSWORD=a837234b952ad7aa9ab4852f47021660c038209a71fce027cec8bab37ad82ae5
POSTGRES_HOST=db
POSTGRES_PORT=5432
# JWT
JWT_SECRET=7a264228051ad10724934342ce62dce584161c248841061de0d0a56e92d9bb1a
# API Keys
ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
# Dashboard
DASHBOARD_USERNAME=lab-admin
DASHBOARD_PASSWORD=017b7076cfb25bd18410d1e5f4f7ec5a
# 域名配置
SITE_URL=https://amiap.hzau.edu.cn
API_EXTERNAL_URL=https://amiap.hzau.edu.cn/supa
SUPABASE_PUBLIC_URL=https://amiap.hzau.edu.cn/supa
```
---
## 🚀 快速开始（前端集成）
### 1. 安装依赖
```bash
npm install @supabase/supabase-js
```
### 2. 创建 Supabase 客户端
```javascript
// src/lib/supabaseClient.js
import { createClient } from '@supabase/supabase-js'
const supabaseUrl = 'https://amiap.hzau.edu.cn/supa'
const supabaseAnonKey = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlIiwiaWF0IjoxNzYzODAyNjY5LCJleHAiOjIwNzkxNjI2Njl9.ltGXvQKpguLaf8Vzomn310hLgOZbrjqZT-F3rR00ulg'
export const supabase = createClient(supabaseUrl, supabaseAnonKey)
```
### 3. 使用示例
```javascript
// 查询数据
const { data, error } = await supabase
.from('users')
.select('*')
// 插入数据
const { data, error } = await supabase
.from('users')
.insert([{ name: 'John', email: 'john@example.com' }])
// 用户登录
const { data, error } = await supabase.auth.signInWithPassword({
email: 'user@example.com',
password: 'password'
})
```
---
## 🔍 测试 API
### 快速测试脚本
```bash
cd /vol1/1000/docker_server/traefik/supabase-stack
# 测试 REST API
curl -H "apikey: ANON_KEY" \
-H "Authorization: Bearer ANON_KEY" \
https://amiap.hzau.edu.cn/supa/rest/v1/
# 测试 Auth API
curl https://amiap.hzau.edu.cn/supa/auth/v1/health
# 测试 Storage API
curl https://amiap.hzau.edu.cn/supa/storage/v1/version
```
### 在浏览器中测试
```
1. 访问 Dashboard: http://100.64.0.2:18000
2. 使用用户名/密码登录
3. 创建测试表
4. 在 Vue 应用中调用 API
```
---
## ⚠️ 已知问题
### 1. Dashboard 子路径问题
- **问题**: `https://amiap.hzau.edu.cn/supa` 无法访问 Dashboard
- **原因**: Supabase Studio 是 SPA，不支持子路径部署
- **解决**: 使用内网地址 `http://100.64.0.2:18000`
### 2. Pooler 服务重启
- **问题**: `supabase-pooler` 一直重启
- **影响**: 无影响，这是连接池优化组件，非必需
- **解决**: 可忽略或停止该服务 `docker stop supabase-pooler`
### 3. REST API 缓存重试
- **问题**: 首次访问可能看到 "schema cache retrying"
- **原因**: PostgreSQL schema 缓存加载
- **解决**: 等待几秒自动恢复，或重启 `docker compose restart rest`
---
## 📚 开发文档
| 文档 | 位置 | 说明 |
|------|------|------|
| Vue 集成指南 | `VUE_API_INTEGRATION.md` | 详细的前端集成教程 |
| 部署信息 | `DEPLOYMENT_INFO.md` | 本文件 |
| 官方文档 | https://supabase.com/docs | Supabase 官方文档 |
---
## 🛠️ 故障排查
### 服务无法启动
```bash
# 查看日志
docker compose logs kong
docker compose logs rest
# 重启服务
docker compose restart
# 完全重建
docker compose down
docker compose up -d
```
### API 无法访问
```bash
# 检查 Kong 状态
docker compose ps kong
# 检查端口
netstat -tlnp | grep 18000
# 测试内网连接
curl http://100.64.0.2:18000/rest/v1/
```
### 数据库连接问题
```bash
# 进入数据库容器
docker exec -it supabase-db psql -U postgres
# 查看数据库
\l
# 查看 schema
\dn
```
---
## 📞 支持
如有问题，请检查：
1. 所有容器是否正常运行: `docker compose ps`
2. 查看服务日志: `docker compose logs [service]`
3. 参考 `VUE_API_INTEGRATION.md` 了解详细用法
4. 访问 Dashboard 管理数据库: `http://100.64.0.2:18000`
---
**最后更新**: 2025-11-22
**版本**: Supabase Self-Hosted Stack

350
supabase-stack/docs/OPERATIONS_GUIDE.md Normal file
View File

@@ -0,0 +1,350 @@
# Supabase Stack 运维指南
完整的 Supabase 对象存储运维手册
---
## 📋 目录
1. [系统架构](#系统架构)
2. [服务启动与管理](#服务启动与管理)
3. [Storage API 使用](#storage-api-使用)
4. [故障排查](#故障排查)
---
## 🏗️ 系统架构
### 组件说明
```
外部用户 (HTTPS)
↓
Traefik (:443)
↓
Kong Gateway (:18000)
↓
┌────────────────────────────────┐
│ Supabase Services │
├────────────────────────────────┤
│ • Auth (GoTrue) - 用户认证 │
│ • REST (PostgREST) - 数据API │
│ • Storage - 对象存储 │
│ • Realtime - 实时订阅 │
└────────────────────────────────┘
↓
PostgreSQL + MinIO
```
### 访问地址
| 服务 | 地址 | 用途 |
|------|------|------|
| 公网 API | https://amiap.hzau.edu.cn/supa | 所有 API 入口 |
| Storage API | https://amiap.hzau.edu.cn/supa/storage/v1 | 对象存储 |
| Dashboard | http://100.64.0.2:18000 | 管理后台（内网） |
### 数据存储
- **PostgreSQL 数据**: `./volumes/db/data/`
- **对象存储数据**: `/vol1/1000/s3/stub/`
---
## 🚀 服务启动与管理
### 启动服务
```bash
cd /vol1/1000/docker_server/traefik/supabase-stack
# 启动所有服务（包含 MinIO 对象存储后端）
docker compose -f docker-compose.yml -f docker-compose.s3.yml up -d
```
**说明**：
- `docker-compose.yml` - Supabase 核心服务
- `docker-compose.s3.yml` - MinIO 存储后端（**必需**）
### 查看状态
```bash
# 查看所有容器
docker compose ps
# 查看日志
docker compose logs -f storage
docker compose logs -f kong
```
### 停止/重启
```bash
# 停止服务
docker compose stop
# 重启特定服务
docker compose restart storage
docker compose restart minio
# 完全停止并删除容器（数据保留）
docker compose down
```
### 环境变量
关键密钥在 `.env` 文件中：
```bash
# 服务密钥（后端使用）
SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoic2VydmljZV9yb2xlIiwiaXNzIjoic3VwYWJhc2UiLCJpYXQiOjE3NjM4MDI2NjksImV4cCI6MjA3OTE2MjY2OX0.gQWUaTkZ6mjjlv2TED0cODp2meqqWuCGKZR1ptIbovg
# 匿名密钥（前端使用）
ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlIiwiaWF0IjoxNzYzODAyNjY5LCJleHAiOjIwNzkxNjI2Njl9.ltGXvQKpguLaf8Vzomn310hLgOZbrjqZT-F3rR00ulg
```
---
## 📦 Storage API 使用
### API 端点
```
Base URL: https://amiap.hzau.edu.cn/supa
Storage: https://amiap.hzau.edu.cn/supa/storage/v1
```
### 完整 Python 示例
保存为 `storage_client.py`：
```python
import requests
from pathlib import Path
class StorageClient:
def __init__(self, base_url, api_key):
self.base_url = base_url
self.headers = {
'apikey': api_key,
'Authorization': f'Bearer {api_key}'
}
def create_bucket(self, name, public=False):
"""创建 bucket"""
response = requests.post(
f'{self.base_url}/storage/v1/bucket',
headers=self.headers,
json={'name': name, 'public': public}
)
return response.ok
def upload_file(self, bucket, file_path, storage_path=None):
"""上传文件"""
if not storage_path:
storage_path = Path(file_path).name
with open(file_path, 'rb') as f:
response = requests.post(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers,
files={'file': f}
)
return response.json() if response.ok else None
def download_file(self, bucket, storage_path, local_path):
"""下载文件"""
response = requests.get(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers
)
if response.ok:
with open(local_path, 'wb') as f:
f.write(response.content)
return True
return False
def create_signed_url(self, bucket, storage_path, expires_in=3600):
"""生成临时下载链接"""
response = requests.post(
f'{self.base_url}/storage/v1/object/sign/{bucket}/{storage_path}',
headers=self.headers,
json={'expiresIn': expires_in}
)
if response.ok:
return self.base_url + response.json()['signedURL']
return None
# 使用示例
if __name__ == '__main__':
client = StorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
)
# 创建 bucket
client.create_bucket('my-bucket')
# 上传文件
client.upload_file('my-bucket', 'photo.jpg', 'uploads/photo.jpg')
# 生成临时链接
url = client.create_signed_url('my-bucket', 'uploads/photo.jpg')
print(f'下载链接: {url}')
```
### 完整 JavaScript 示例
```javascript
class StorageClient {
constructor(baseUrl, apiKey) {
this.baseUrl = baseUrl;
this.headers = {
'apikey': apiKey,
'Authorization': `Bearer ${apiKey}`
};
}
async createBucket(name, isPublic = false) {
const response = await fetch(`${this.baseUrl}/storage/v1/bucket`, {
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({ name, public: isPublic })
});
return response.ok;
}
async uploadFile(bucket, file, storagePath) {
const formData = new FormData();
formData.append('file', file);
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{
method: 'POST',
headers: this.headers,
body: formData
}
);
return response.ok ? await response.json() : null;
}
async createSignedUrl(bucket, storagePath, expiresIn = 3600) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/sign/${bucket}/${storagePath}`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({ expiresIn })
}
);
if (response.ok) {
const data = await response.json();
return this.baseUrl + data.signedURL;
}
return null;
}
}
// 使用示例
const client = new StorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
);
// 上传文件
const fileInput = document.querySelector('input[type="file"]');
fileInput.addEventListener('change', async (e) => {
const file = e.target.files[0];
await client.uploadFile('my-bucket', file, `uploads/${file.name}`);
});
```
完整代码示例请查看：`storage_client.py` 和 `storage_client.js`
---
## 🔧 故障排查
### 常见问题
**1. 服务无法启动**
```bash
# 检查端口占用
docker compose ps
netstat -tulpn | grep -E ":(8000|5432|9000)"
# 查看日志
docker compose logs storage
```
**2. API 返回 403**
```bash
# 检查密钥是否正确
grep SERVICE_ROLE_KEY .env
# 测试 API
curl -I https://amiap.hzau.edu.cn/supa/storage/v1/bucket \
-H "apikey: YOUR_KEY"
```
**3. 上传失败**
```bash
# 检查 MinIO 是否运行
docker compose ps minio
# 查看 Storage 日志
docker compose logs storage | tail -50
```
### 健康检查
```bash
# 快速测试脚本
python3 test_https_storage.py
# 手动测试
curl https://amiap.hzau.edu.cn/supa/rest/v1/
```
### 备份
```bash
# 备份数据库
docker exec supabase-db pg_dump -U postgres > backup.sql
# 备份对象存储
tar -czf s3_backup.tar.gz /vol1/1000/s3/
```
---
## 📚 相关文档
- `storage_client.py` - Python 完整客户端代码
- `storage_client.js` - JavaScript 完整客户端代码
- `test_https_storage.py` - 测试脚本
- `VUE_API_INTEGRATION.md` - Vue 集成指南
---
## 🎯 快速开始
```bash
# 1. 启动服务
docker compose -f docker-compose.yml -f docker-compose.s3.yml up -d
# 2. 测试
python3 test_https_storage.py
# 3. 查看文档
cat storage_client.py
```
完成！现在可以开始使用 Supabase Storage 了。

76
supabase-stack/docs/QUICK_START.md Normal file
View File

@@ -0,0 +1,76 @@
# Supabase Stack 快速参考
## 🚀 启动服务
```bash
cd /vol1/1000/docker_server/traefik/supabase-stack
# 启动所有服务（包含 MinIO 对象存储）
docker compose -f docker-compose.yml -f docker-compose.s3.yml up -d
# 查看状态
docker compose ps
# 查看日志
docker compose logs -f storage
```
## 📦 Storage API 访问
**端点**: `https://amiap.hzau.edu.cn/supa/storage/v1`
**密钥**:
```bash
SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoic2VydmljZV9yb2xlIiwiaXNzIjoic3VwYWJhc2UiLCJpYXQiOjE3NjM4MDI2NjksImV4cCI6MjA3OTE2MjY2OX0.gQWUaTkZ6mjjlv2TED0cODp2meqqWuCGKZR1ptIbovg
```
## 💻 快速使用
### Python
```python
from storage_client import SupabaseStorageClient
client = SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
)
# 上传文件
client.upload_file('bucket', 'photo.jpg', 'uploads/photo.jpg')
# 生成临时链接
url = client.create_signed_url('bucket', 'uploads/photo.jpg', 3600)
```
### JavaScript
```javascript
const client = new SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
);
// 上传文件
await client.uploadFile('bucket', fileObject, 'uploads/photo.jpg');
// 生成临时链接
const url = await client.createSignedUrl('bucket', 'uploads/photo.jpg', 3600);
```
## 📚 文档
- **OPERATIONS_GUIDE.md** - 完整运维指南（必读）
- **storage_client.py** - Python 完整客户端代码
- **storage_client.js** - JavaScript 完整客户端代码
- **test_https_storage.py** - 测试脚本
## 🧪 测试
```bash
python3 test_https_storage.py
```
## ⚠️ 重要
- **MinIO 必须运行**：docker-compose.s3.yml 不能删除
- **数据位置**：/vol1/1000/s3/stub/
- **不要直接访问 MinIO**：统一通过 Storage API

1239
supabase-stack/docs/VUE_API_INTEGRATION.md Normal file
View File

File diff suppressed because it is too large Load Diff

56
supabase-stack/docs/versions.md Normal file
View File

@@ -0,0 +1,56 @@
# Docker Image Versions
## 2025-11-12
- supabase/studio:2025.11.10-sha-5291fe3 (prev 2025.10.27-sha-85b84e0)
- supabase/gotrue:v2.182.1 (prev v2.180.0)
- supabase/realtime:v2.63.0 (prev v2.57.2)
- supabase/storage-api:v1.29.0 (prev v1.28.2)
- supabase/edge-runtime:v1.69.23 (prev v1.69.15)
- supabase/supavisor:2.7.4 (prev 2.7.3)
## 2025-10-28
- supabase/studio:2025.10.27-sha-85b84e0 (prev 2025.10.20-sha-5005fc6)
- supabase/realtime:v2.57.2 (prev v2.56.0)
- supabase/storage-api:v1.28.2 (prev v1.28.1)
- supabase/postgres-meta:v0.93.1 (prev v0.93.0)
- supabase/edge-runtime:v1.69.15 (prev v1.69.14)
## 2025-10-21
- supabase/studio:2025.10.20-sha-5005fc6 (prev 2025.10.01-sha-8460121)
- supabase/realtime:v2.56.0 (prev v2.51.11)
- supabase/storage-api:v1.28.1 (prev v1.28.0)
- supabase/postgres-meta:v0.93.0 (prev v0.91.6)
- supabase/edge-runtime:v1.69.14 (prev v1.69.6)
- supabase/supavisor:2.7.3 (prev 2.7.0)
## 2025-10-13
- supabase/logflare:1.22.6 (prev 1.22.4)
## 2025-10-08
- supabase/studio:2025.10.01-sha-8460121 (prev 2025.06.30-sha-6f5982d)
- supabase/gotrue:v2.180.0 (prev v2.177.0)
- postgrest/postgrest:v13.0.7 (prev v12.2.12)
- supabase/realtime:v2.51.11 (prev v2.34.47)
- supabase/storage-api:v1.28.0 (prev v1.25.7)
- supabase/postgres-meta:v0.91.6 (prev v0.91.0)
- supabase/logflare:1.22.4 (prev 1.14.2)
- supabase/postgres:15.8.1.085 (prev 15.8.1.060)
- supabase/supavisor:2.7.0 (prev 2.5.7)
## 2025-07-15
- supabase/gotrue:v2.177.0 (prev v2.176.1)
- supabase/storage-api:v1.25.7 (prev v1.24.7)
- supabase/postgres-meta:v0.91.0 (prev v0.89.3)
- supabase/supavisor:2.5.7 (prev 2.5.6)
## 2025-07-02
- supabase/studio:2025.06.30-sha-6f5982d (prev 2025.06.02-sha-8f2993d)
- supabase/gotrue:v2.176.1 (prev v2.174.0)
- supabase/storage-api:v1.24.7 (prev v1.23.0)
- supabase/supavisor:2.5.6 (prev 2.5.1)
## 2025-06-03
- supabase/studio:2025.06.02-sha-8f2993d (prev 2025.05.19-sha-3487831)
- supabase/gotrue:v2.174.0 (prev v2.172.1)
- supabase/storage-api:v1.23.0 (prev v1.22.17)
- supabase/postgres-meta:v0.89.3 (prev v0.89.0)

467
supabase-stack/examples/storage_client.js Normal file
View File

@@ -0,0 +1,467 @@
/**
* Supabase Storage REST API 完整客户端
* 无需 SDK，纯 JavaScript/TypeScript 实现
*
* 使用示例:
*
* const client = new SupabaseStorageClient(
* 'https://amiap.hzau.edu.cn/supa',
* 'your-service-role-key'
* );
*
* // 创建 bucket
* await client.createBucket('my-bucket');
*
* // 上传文件
* await client.uploadFile('my-bucket', fileObject, 'uploads/photo.jpg');
*
* // 生成临时下载链接
* const url = await client.createSignedUrl('my-bucket', 'uploads/photo.jpg', 3600);
*/
class SupabaseStorageClient {
/**
* 初始化客户端
* @param {string} baseUrl - Supabase Base URL
* @param {string} apiKey - SERVICE_ROLE_KEY 或 ANON_KEY
*/
constructor(baseUrl, apiKey) {
this.baseUrl = baseUrl.replace(/\/$/, '');
this.headers = {
'apikey': apiKey,
'Authorization': `Bearer ${apiKey}`
};
}
// ==================== Bucket 管理 ====================
/**
* 列出所有 buckets
* @returns {Promise<Array>}
*/
async listBuckets() {
const response = await fetch(`${this.baseUrl}/storage/v1/bucket`, {
headers: this.headers
});
return response.ok ? await response.json() : null;
}
/**
* 创建 bucket
* @param {string} name - bucket 名称
* @param {boolean} isPublic - 是否公开
* @param {number} fileSizeLimit - 文件大小限制（字节）
* @returns {Promise<boolean>}
*/
async createBucket(name, isPublic = false, fileSizeLimit = 52428800) {
const response = await fetch(`${this.baseUrl}/storage/v1/bucket`, {
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({
name,
public: isPublic,
file_size_limit: fileSizeLimit
})
});
return response.ok || response.status === 409;
}
/**
* 删除 bucket
* @param {string} name - bucket 名称
* @returns {Promise<boolean>}
*/
async deleteBucket(name) {
const response = await fetch(`${this.baseUrl}/storage/v1/bucket/${name}`, {
method: 'DELETE',
headers: this.headers
});
return response.ok;
}
/**
* 清空 bucket
* @param {string} name - bucket 名称
* @returns {Promise<boolean>}
*/
async emptyBucket(name) {
const response = await fetch(`${this.baseUrl}/storage/v1/bucket/${name}/empty`, {
method: 'POST',
headers: this.headers
});
return response.ok;
}
// ==================== 文件上传 ====================
/**
* 上传文件
* @param {string} bucket - bucket 名称
* @param {File} file - 文件对象
* @param {string} storagePath - 云端存储路径
* @returns {Promise<Object|null>}
*/
async uploadFile(bucket, file, storagePath) {
const formData = new FormData();
formData.append('file', file);
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{
method: 'POST',
headers: this.headers,
body: formData
}
);
return response.ok ? await response.json() : null;
}
/**
* 上传字节数据
* @param {string} bucket - bucket 名称
* @param {Blob|ArrayBuffer} data - 数据
* @param {string} storagePath - 云端存储路径
* @param {string} contentType - MIME 类型
* @returns {Promise<Object|null>}
*/
async uploadBytes(bucket, data, storagePath, contentType = 'application/octet-stream') {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': contentType
},
body: data
}
);
return response.ok ? await response.json() : null;
}
/**
* 更新文件
* @param {string} bucket - bucket 名称
* @param {File} file - 文件对象
* @param {string} storagePath - 云端存储路径
* @returns {Promise<Object|null>}
*/
async updateFile(bucket, file, storagePath) {
const formData = new FormData();
formData.append('file', file);
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{
method: 'PUT',
headers: this.headers,
body: formData
}
);
return response.ok ? await response.json() : null;
}
// ==================== 文件下载 ====================
/**
* 下载文件为 Blob
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 云端文件路径
* @returns {Promise<Blob|null>}
*/
async downloadFile(bucket, storagePath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{ headers: this.headers }
);
return response.ok ? await response.blob() : null;
}
/**
* 下载文件为 ArrayBuffer
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 云端文件路径
* @returns {Promise<ArrayBuffer|null>}
*/
async downloadBytes(bucket, storagePath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{ headers: this.headers }
);
return response.ok ? await response.arrayBuffer() : null;
}
/**
* 下载文件为文本
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 云端文件路径
* @returns {Promise<string|null>}
*/
async downloadText(bucket, storagePath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{ headers: this.headers }
);
return response.ok ? await response.text() : null;
}
// ==================== 文件列表 ====================
/**
* 列出文件
* @param {string} bucket - bucket 名称
* @param {string} folder - 文件夹路径
* @param {number} limit - 返回数量限制
* @param {number} offset - 偏移量
* @returns {Promise<Array|null>}
*/
async listFiles(bucket, folder = '', limit = 100, offset = 0) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/list/${bucket}`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({
prefix: folder,
limit,
offset,
sortBy: { column: 'name', order: 'asc' }
})
}
);
return response.ok ? await response.json() : null;
}
/**
* 搜索文件
* @param {string} bucket - bucket 名称
* @param {string} searchText - 搜索关键词
* @param {number} limit - 返回数量限制
* @returns {Promise<Array|null>}
*/
async searchFiles(bucket, searchText, limit = 100) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/list/${bucket}`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({ search: searchText, limit })
}
);
return response.ok ? await response.json() : null;
}
// ==================== 文件操作 ====================
/**
* 移动文件
* @param {string} bucket - bucket 名称
* @param {string} fromPath - 源路径
* @param {string} toPath - 目标路径
* @returns {Promise<boolean>}
*/
async moveFile(bucket, fromPath, toPath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/move`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({
bucketId: bucket,
sourceKey: fromPath,
destinationKey: toPath
})
}
);
return response.ok;
}
/**
* 复制文件
* @param {string} bucket - bucket 名称
* @param {string} fromPath - 源路径
* @param {string} toPath - 目标路径
* @returns {Promise<Object|null>}
*/
async copyFile(bucket, fromPath, toPath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/copy`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({
bucketId: bucket,
sourceKey: fromPath,
destinationKey: toPath
})
}
);
return response.ok ? await response.json() : null;
}
/**
* 删除文件
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 文件路径
* @returns {Promise<boolean>}
*/
async deleteFile(bucket, storagePath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}/${storagePath}`,
{
method: 'DELETE',
headers: this.headers
}
);
return response.ok;
}
/**
* 批量删除文件
* @param {string} bucket - bucket 名称
* @param {Array<string>} filePaths - 文件路径数组
* @returns {Promise<boolean>}
*/
async deleteFiles(bucket, filePaths) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/${bucket}`,
{
method: 'DELETE',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({ prefixes: filePaths })
}
);
return response.ok;
}
// ==================== URL 生成 ====================
/**
* 生成签名 URL（临时下载链接）
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 文件路径
* @param {number} expiresIn - 过期时间（秒），默认 1 小时
* @returns {Promise<string|null>}
*/
async createSignedUrl(bucket, storagePath, expiresIn = 3600) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/sign/${bucket}/${storagePath}`,
{
method: 'POST',
headers: {
...this.headers,
'Content-Type': 'application/json'
},
body: JSON.stringify({ expiresIn })
}
);
if (response.ok) {
const data = await response.json();
// 签名 URL 需要加上 /storage/v1 前缀
return this.baseUrl + '/storage/v1' + data.signedURL;
}
return null;
}
/**
* 生成上传签名 URL（允许前端直接上传）
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 文件路径
* @returns {Promise<Object|null>} {url, token}
*/
async createUploadSignedUrl(bucket, storagePath) {
const response = await fetch(
`${this.baseUrl}/storage/v1/object/upload/sign/${bucket}/${storagePath}`,
{
method: 'POST',
headers: this.headers
}
);
if (response.ok) {
const data = await response.json();
return {
url: this.baseUrl + '/storage/v1' + data.url,
token: data.token
};
}
return null;
}
/**
* 获取公开 URL（仅适用于 public bucket）
* @param {string} bucket - bucket 名称
* @param {string} storagePath - 文件路径
* @returns {string}
*/
getPublicUrl(bucket, storagePath) {
return `${this.baseUrl}/storage/v1/object/public/${bucket}/${storagePath}`;
}
}
// ==================== 使用示例 ====================
// 在浏览器中使用
if (typeof window !== 'undefined') {
window.SupabaseStorageClient = SupabaseStorageClient;
}
// 在 Node.js 中使用
if (typeof module !== 'undefined' && module.exports) {
module.exports = SupabaseStorageClient;
}
// 示例代码
/*
// 初始化客户端
const client = new SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
);
// 上传文件（HTML5 File API）
const fileInput = document.querySelector('input[type="file"]');
fileInput.addEventListener('change', async (e) => {
const file = e.target.files[0];
const result = await client.uploadFile('my-bucket', file, `uploads/${file.name}`);
console.log('上传成功:', result);
// 生成临时下载链接
const url = await client.createSignedUrl('my-bucket', `uploads/${file.name}`, 3600);
console.log('下载链接:', url);
});
// 列出文件
const files = await client.listFiles('my-bucket', 'uploads/');
console.log('文件列表:', files);
// 下载文件
const blob = await client.downloadFile('my-bucket', 'uploads/photo.jpg');
const url = URL.createObjectURL(blob);
// 创建下载链接
const a = document.createElement('a');
a.href = url;
a.download = 'photo.jpg';
a.click();
查看 OPERATIONS_GUIDE.md 了解更多用法
*/

349
supabase-stack/examples/storage_client.py Normal file
View File

@@ -0,0 +1,349 @@
#!/usr/bin/env python3
"""
Supabase Storage REST API 完整客户端
无需 SDK，仅使用 requests 库
"""
import requests
from pathlib import Path
from typing import Optional, List, Dict, Any
class SupabaseStorageClient:
"""
Supabase Storage REST API 客户端
使用示例:
client = SupabaseStorageClient(
'https://amiap.hzau.edu.cn/supa',
'your-service-role-key'
)
# 创建 bucket
client.create_bucket('my-bucket')
# 上传文件
client.upload_file('my-bucket', 'photo.jpg', 'uploads/photo.jpg')
# 生成临时下载链接
url = client.create_signed_url('my-bucket', 'uploads/photo.jpg', 3600)
"""
def __init__(self, base_url: str, api_key: str):
"""
初始化客户端
Args:
base_url: Supabase Base URL (如 https://amiap.hzau.edu.cn/supa)
api_key: SERVICE_ROLE_KEY 或 ANON_KEY
"""
self.base_url = base_url.rstrip('/')
self.headers = {
'apikey': api_key,
'Authorization': f'Bearer {api_key}'
}
# ==================== Bucket 管理 ====================
def list_buckets(self) -> Optional[List[Dict]]:
"""列出所有 buckets"""
response = requests.get(
f'{self.base_url}/storage/v1/bucket',
headers=self.headers
)
return response.json() if response.ok else None
def create_bucket(self, name: str, public: bool = False,
file_size_limit: int = 52428800) -> bool:
"""
创建 bucket
Args:
name: bucket 名称
public: 是否公开
file_size_limit: 文件大小限制（字节）
"""
response = requests.post(
f'{self.base_url}/storage/v1/bucket',
headers=self.headers,
json={
'name': name,
'public': public,
'file_size_limit': file_size_limit
}
)
return response.ok or response.status_code == 409
def delete_bucket(self, name: str) -> bool:
"""删除 bucket"""
response = requests.delete(
f'{self.base_url}/storage/v1/bucket/{name}',
headers=self.headers
)
return response.ok
def empty_bucket(self, name: str) -> bool:
"""清空 bucket"""
response = requests.post(
f'{self.base_url}/storage/v1/bucket/{name}/empty',
headers=self.headers
)
return response.ok
# ==================== 文件上传 ====================
def upload_file(self, bucket: str, file_path: str,
storage_path: Optional[str] = None) -> Optional[Dict]:
"""
上传文件
Args:
bucket: bucket 名称
file_path: 本地文件路径
storage_path: 云端存储路径（默认使用文件名）
Returns:
{'Key': 'path', 'Id': 'uuid'} 或 None
"""
if not storage_path:
storage_path = Path(file_path).name
with open(file_path, 'rb') as f:
response = requests.post(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers,
files={'file': f}
)
return response.json() if response.ok else None
def upload_bytes(self, bucket: str, data: bytes, storage_path: str,
content_type: str = 'application/octet-stream') -> Optional[Dict]:
"""
上传字节数据
Args:
bucket: bucket 名称
data: 字节数据
storage_path: 云端存储路径
content_type: MIME 类型
"""
response = requests.post(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers={**self.headers, 'Content-Type': content_type},
data=data
)
return response.json() if response.ok else None
def update_file(self, bucket: str, file_path: str, storage_path: str) -> Optional[Dict]:
"""更新已存在的文件"""
with open(file_path, 'rb') as f:
response = requests.put(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers,
files={'file': f}
)
return response.json() if response.ok else None
# ==================== 文件下载 ====================
def download_file(self, bucket: str, storage_path: str, local_path: str) -> bool:
"""
下载文件到本地
Args:
bucket: bucket 名称
storage_path: 云端文件路径
local_path: 本地保存路径
"""
response = requests.get(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers
)
if response.ok:
with open(local_path, 'wb') as f:
f.write(response.content)
return True
return False
def download_bytes(self, bucket: str, storage_path: str) -> Optional[bytes]:
"""下载文件为字节数据"""
response = requests.get(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers
)
return response.content if response.ok else None
# ==================== 文件列表 ====================
def list_files(self, bucket: str, folder: str = '',
limit: int = 100, offset: int = 0) -> Optional[List[Dict]]:
"""
列出文件
Args:
bucket: bucket 名称
folder: 文件夹路径
limit: 返回数量限制
offset: 偏移量
"""
response = requests.post(
f'{self.base_url}/storage/v1/object/list/{bucket}',
headers=self.headers,
json={
'prefix': folder,
'limit': limit,
'offset': offset,
'sortBy': {'column': 'name', 'order': 'asc'}
}
)
return response.json() if response.ok else None
def search_files(self, bucket: str, search_text: str, limit: int = 100) -> Optional[List[Dict]]:
"""搜索文件"""
response = requests.post(
f'{self.base_url}/storage/v1/object/list/{bucket}',
headers=self.headers,
json={'search': search_text, 'limit': limit}
)
return response.json() if response.ok else None
# ==================== 文件操作 ====================
def move_file(self, bucket: str, from_path: str, to_path: str) -> bool:
"""移动文件"""
response = requests.post(
f'{self.base_url}/storage/v1/object/move',
headers=self.headers,
json={
'bucketId': bucket,
'sourceKey': from_path,
'destinationKey': to_path
}
)
return response.ok
def copy_file(self, bucket: str, from_path: str, to_path: str) -> Optional[Dict]:
"""复制文件"""
response = requests.post(
f'{self.base_url}/storage/v1/object/copy',
headers=self.headers,
json={
'bucketId': bucket,
'sourceKey': from_path,
'destinationKey': to_path
}
)
return response.json() if response.ok else None
def delete_file(self, bucket: str, storage_path: str) -> bool:
"""删除文件"""
response = requests.delete(
f'{self.base_url}/storage/v1/object/{bucket}/{storage_path}',
headers=self.headers
)
return response.ok
def delete_files(self, bucket: str, file_paths: List[str]) -> bool:
"""批量删除文件"""
response = requests.delete(
f'{self.base_url}/storage/v1/object/{bucket}',
headers=self.headers,
json={'prefixes': file_paths}
)
return response.ok
# ==================== URL 生成 ====================
def create_signed_url(self, bucket: str, storage_path: str,
expires_in: int = 3600) -> Optional[str]:
"""
生成签名 URL（临时下载链接）
Args:
bucket: bucket 名称
storage_path: 文件路径
expires_in: 过期时间（秒），默认 1 小时
Returns:
完整的签名 URL
"""
response = requests.post(
f'{self.base_url}/storage/v1/object/sign/{bucket}/{storage_path}',
headers=self.headers,
json={'expiresIn': expires_in}
)
if response.ok:
data = response.json()
# 签名 URL 需要加上 /storage/v1 前缀
return self.base_url + '/storage/v1' + data['signedURL']
return None
def create_upload_signed_url(self, bucket: str, storage_path: str) -> Optional[Dict]:
"""
生成上传签名 URL（允许前端直接上传）
Returns:
{'url': upload_url, 'token': token}
"""
response = requests.post(
f'{self.base_url}/storage/v1/object/upload/sign/{bucket}/{storage_path}',
headers=self.headers
)
if response.ok:
data = response.json()
return {
'url': self.base_url + '/storage/v1' + data['url'],
'token': data['token']
}
return None
def get_public_url(self, bucket: str, storage_path: str) -> str:
"""获取公开 URL（仅适用于 public bucket）"""
return f'{self.base_url}/storage/v1/object/public/{bucket}/{storage_path}'
# ==================== 使用示例 ====================
if __name__ == '__main__':
# 初始化客户端
client = SupabaseStorageClient(
base_url='https://amiap.hzau.edu.cn/supa',
api_key='your-service-role-key'
)
print("Supabase Storage 客户端示例")
print("=" * 60)
# 1. 创建 bucket
print("\n1. 创建 bucket...")
client.create_bucket('test-bucket', public=False)
# 2. 列出 buckets
print("\n2. 列出所有 buckets...")
buckets = client.list_buckets()
if buckets:
for bucket in buckets:
print(f" - {bucket['name']}")
# 3. 上传文件
print("\n3. 上传文件...")
result = client.upload_bytes(
'test-bucket',
b'Hello from Supabase Storage!',
'test/hello.txt',
'text/plain'
)
if result:
print(f" ✓ 上传成功: {result['Key']}")
# 4. 生成临时下载链接
print("\n4. 生成临时下载链接...")
url = client.create_signed_url('test-bucket', 'test/hello.txt', 3600)
if url:
print(f" ✓ URL (1小时有效): {url[:80]}...")
print("\n" + "=" * 60)
print("示例完成！查看 OPERATIONS_GUIDE.md 了解更多用法")

194
supabase-stack/examples/test_https_storage.py Executable file
View File

@@ -0,0 +1,194 @@
#!/usr/bin/env python3
"""
测试公网 HTTPS Supabase Storage API
快速验证所有功能是否正常
"""
import requests
import sys
BASE_URL = 'https://amiap.hzau.edu.cn/supa'
API_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoic2VydmljZV9yb2xlIiwiaXNzIjoic3VwYWJhc2UiLCJpYXQiOjE3NjM4MDI2NjksImV4cCI6MjA3OTE2MjY2OX0.gQWUaTkZ6mjjlv2TED0cODp2meqqWuCGKZR1ptIbovg'
headers = {
'apikey': API_KEY,
'Authorization': f'Bearer {API_KEY}'
}
print("=" * 70)
print(" Supabase Storage 公网 HTTPS 功能测试")
print("=" * 70)
print()
print(f"端点: {BASE_URL}/storage/v1")
print()
success_count = 0
total_tests = 5
# 测试 1: 列出 Buckets
print("1️⃣ 列出 Buckets")
print("-" * 70)
try:
response = requests.get(f'{BASE_URL}/storage/v1/bucket', headers=headers)
if response.status_code == 200:
buckets = response.json()
print(f"✓ 成功! 找到 {len(buckets)} 个 bucket")
for b in buckets:
print(f" - {b['name']}")
success_count += 1
else:
print(f"✗ 失败: {response.status_code}")
except Exception as e:
print(f"✗ 错误: {e}")
print()
# 测试 2: 创建 Bucket（或确认存在）
print("2️⃣ 确认测试 Bucket 存在")
print("-" * 70)
try:
response = requests.post(
f'{BASE_URL}/storage/v1/bucket',
headers=headers,
json={'name': 'test-https', 'public': False}
)
if response.status_code in [200, 201]:
print("✓ 创建成功")
success_count += 1
elif response.status_code == 400 and 'already exists' in response.text.lower():
print("✓ Bucket 已存在（正常）")
success_count += 1
else:
print(f"⚠️ 响应: {response.status_code} - {response.text[:100]}")
# 检查是否能列出该 bucket（说明存在）
list_resp = requests.get(f'{BASE_URL}/storage/v1/bucket', headers=headers)
if list_resp.ok and any(b['name'] == 'test-https' for b in list_resp.json()):
print("✓ Bucket 已确认存在")
success_count += 1
except Exception as e:
print(f"✗ 错误: {e}")
print()
# 测试 3: 上传文件（如果存在则更新）
print("3️⃣ 上传/更新文件")
print("-" * 70)
test_data = b"Hello from HTTPS Storage API!\nThis is a test file.\nTimestamp: " + str(__import__('time').time()).encode()
try:
# 先尝试上传
response = requests.post(
f'{BASE_URL}/storage/v1/object/test-https/test.txt',
headers={**headers, 'Content-Type': 'text/plain'},
data=test_data
)
if response.status_code in [200, 201]:
print("✓ 上传成功")
print(f" 响应: {response.json()}")
success_count += 1
elif response.status_code == 400 and 'already exists' in response.text.lower():
# 文件已存在，使用 PUT 更新
print(" 文件已存在，尝试更新...")
response = requests.put(
f'{BASE_URL}/storage/v1/object/test-https/test.txt',
headers={**headers, 'Content-Type': 'text/plain'},
data=test_data
)
if response.status_code in [200, 201]:
print("✓ 更新成功")
print(f" 响应: {response.json()}")
success_count += 1
else:
print(f"✗ 更新失败: {response.status_code} - {response.text[:100]}")
else:
print(f"✗ 失败: {response.status_code} - {response.text[:100]}")
except Exception as e:
print(f"✗ 错误: {e}")
print()
# 测试 4: 下载文件
print("4️⃣ 下载文件")
print("-" * 70)
try:
response = requests.get(
f'{BASE_URL}/storage/v1/object/test-https/test.txt',
headers=headers
)
if response.status_code == 200:
content = response.content.decode('utf-8')
print("✓ 下载成功")
print(f" 内容预览: {content[:50]}...")
print(f" 文件大小: {len(response.content)} bytes")
success_count += 1
else:
print(f"✗ 失败: {response.status_code}")
if response.text:
print(f" 错误信息: {response.text[:100]}")
except Exception as e:
print(f"✗ 错误: {e}")
print()
# 测试 5: 生成签名 URL
print("5️⃣ 生成签名 URL（临时下载链接）")
print("-" * 70)
try:
response = requests.post(
f'{BASE_URL}/storage/v1/object/sign/test-https/test.txt',
headers=headers,
json={'expiresIn': 3600}
)
if response.status_code == 200:
data = response.json()
# 签名 URL 需要加上 /storage/v1 前缀
signed_url = BASE_URL + '/storage/v1' + data['signedURL']
print("✓ 生成成功")
print(f" 完整 URL:")
print(f" {signed_url}")
print(f" 有效期: 1 小时")
success_count += 1
# 验证签名 URL 是否可以下载（不带认证 headers，因为 token 在 URL 中）
print("\n 验证签名 URL 下载...")
try:
verify_response = requests.get(signed_url) # 不带 headers
if verify_response.status_code == 200:
content_preview = verify_response.content[:50].decode('utf-8', errors='ignore')
print(f" ✓ 签名 URL 可以正常下载！")
print(f" 大小: {len(verify_response.content)} bytes")
print(f" 内容: {content_preview}...")
print(f"\n 💡 这个 URL 可以直接在浏览器中打开或分享给他人")
else:
print(f" ⚠️ 签名 URL 返回: {verify_response.status_code}")
if verify_response.text:
print(f" 错误: {verify_response.text[:100]}")
except Exception as ve:
print(f" ⚠️ 验证失败: {ve}")
else:
print(f"✗ 失败: {response.status_code}")
except Exception as e:
print(f"✗ 错误: {e}")
print()
# 总结
print("=" * 70)
print(f" 测试完成: {success_count}/{total_tests} 通过")
print("=" * 70)
print()
if success_count == total_tests:
print("🎉 所有功能正常！")
print()
print("你现在可以：")
print(" ✓ 通过公网 HTTPS 上传文件")
print(" ✓ 下载文件")
print(" ✓ 生成临时下载链接")
print(" ✓ 管理 buckets")
print()
print("📚 查看完整文档:")
print(" - QUICK_START.md 快速入门")
print(" - OPERATIONS_GUIDE.md 运维指南")
print(" - storage_client.py Python 客户端")
print(" - storage_client.js JavaScript 客户端")
sys.exit(0)
else:
print(f"⚠️ {total_tests - success_count} 个测试失败")
print("请检查配置或查看文档")
sys.exit(1)