lingyuzeng/labweb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
12 Commits 3 Branches 0 Tags
7f74b41a40c99588ff4dc9fc88aa2b63b3e9d977
Commit Graph

12 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
zly
7f74b41a40 update 2025-12-05 20:27:09 +08:00
zly
1f7a2ed1e4 feat: 迁移 Storage 后端从 MinIO 到文件系统 
## 主要变更

### 1. Storage 配置修改
- 修改 docker-compose.yml: STORAGE_BACKEND 从 s3 改为 file
- 注释所有 GLOBAL_S3_* 环境变量
- 启用 FILE_STORAGE_BACKEND_PATH=/var/lib/storage
- 停止使用 MinIO 容器（docker-compose.s3.yml）

### 2. 文档更新
- 新增 docs/STORAGE_FILE_BACKEND_MIGRATION.md - 迁移详细文档
- 新增 docs/STORAGE_TROUBLESHOOTING.md - 故障排查指南
- 更新 README.md - 反映新的架构

### 3. 存储架构变更
- 从 MinIO S3 对象存储 -> 本地文件系统
- 存储路径: volumes/storage/undefined/stub/{bucket}/{file}/{version}
- 不再需要额外的 MinIO 容器

## 测试结果
- ✅ 上传文件 - 正常
- ✅ 下载文件 - 正常
- ✅ 删除文件 - 正常
- ✅ 签名 URL - 正常
- ⚠️ 更新文件 - 已知bug（使用删除+上传代替）

## 注意事项
- 旧的 S3 后端数据需要清理数据库元数据
- 文件更新操作有已知bug，需使用删除+重新上传
- 备份文件保存在 *.backup-before-rustfs

## 回滚方法
如需回滚到 MinIO:
```bash
cp docker-compose.yml.backup-before-rustfs docker-compose.yml
docker compose -f docker-compose.s3.yml up -d
docker compose restart storage
```

日期: 2025-12-05
状态: ✅ 测试通过 (4/5 功能正常)
 2025-12-05 19:44:11 +08:00
zly
276856e38a redirect nginx 2025-11-23 17:45:27 +08:00
zly
9bdc52b2dd template 2025-11-23 17:45:04 +08:00
zly
929b96feeb update 2025-11-23 17:41:01 +08:00
zly
d6f40cc488 docs: 全面更新根目录 README.md 文档 
完整重写根目录 README.md，提供系统级文档说明：

📝 新增内容:

1. 系统架构说明
   - 添加完整的架构图（Traefik → Supabase/Web Apps/Derper）
   - 详细的目录结构说明
   - 清晰的服务组织关系

2. 🚀 Supabase 启动说明
   - 完整的 docker compose override 启动命令
   - docker compose -f docker-compose.yml -f docker-compose.s3.yml up -d
   - 详细的启动流程和验证步骤

3. 🌐 URL 路由规划
   - 所有服务的访问地址和状态
   - Supabase API 端点树状结构
   - 路径前缀方案说明

4. Web 应用架构
   - web/ws (ABM 数据库项目) 详细说明
   - web/gzy, web/zz 待部署项目说明
   - 每个项目的启动和配置方法

5. 📊 完整的运维指南
   - 服务状态检查命令
   - 日志查看方法
   - 重启/停止/更新服务流程
   - 故障排查步骤

6. 📚 文档导航
   - Traefik 部署策略文档链接
   - Supabase 完整文档链接
   - 示例代码路径

7. ⚙️ 配置说明
   - Traefik 核心配置
   - Supabase 环境变量
   - Web 应用 Traefik 标签配置

8. 🔒 安全配置
   - SSL/TLS 证书管理
   - API 密钥说明
   - 访问控制建议

9. 📝 开发指南
   - 添加新 Web 应用的方法
   - Vue 项目集成 Supabase 示例
   - Storage API 使用示例 (Python/JavaScript)

10. 🎯 最佳实践
    - 部署流程
    - 备份策略
    - 监控和日志
    - 性能优化建议

变更统计:
  - 新增 529 行
  - 删除 26 行
  - 从简单说明扩展为完整的系统文档

目标受众:
  - 新加入的运维工程师
  - 需要部署新服务的开发者
  - 系统维护人员

相关文档:
  - supabase-stack/README_CN.md (Supabase 详细指南)
  - supabase-stack/README_STORAGE.md (Storage 使用)
  - docs/strategy-*.md (部署策略文档)
 2025-11-22 21:54:33 +08:00
zly
9a261bb265 chore: 添加 .gitignore 和 Traefik 部署策略文档 
.gitignore 更新:
- 添加 pixi 环境和 .claude 目录忽略
- 添加 supabase-stack 相关忽略规则
- 添加 web/ws/postgres_data/pgdata/ 数据库数据忽略

docs/ 文档:
- strategy-1-path-prefix.md: 路径前缀部署方案
- strategy-2-subdomain.md: 子域名部署方案
- strategy-3-hybrid.md: 混合部署方案
- strategy-comparison-report.md: 策略对比报告

这些文档详细说明了 Traefik 反向代理的三种部署策略，
为多应用部署提供参考方案。
 2025-11-22 21:30:19 +08:00
zly
e68ad06829 后端初始化结构 2025-11-22 21:29:00 +08:00
zly
9fa602f21b feat(supabase): 整理 Storage 文档和示例代码 
- 创建 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
 2025-11-22 21:03:00 +08:00
zly
8b068d8171 update restart args use always 2025-11-22 11:28:29 +08:00
zly
9e2f455b23 feat: 配置 ABM 静态网站访问路由 
- 添加 Traefik 网关配置，启用 ping 健康检查
- 配置 nginx-webws 服务处理 /ABM 路径
- 实现 HTTP 到 HTTPS 自动重定向
- 使用 rewrite 规则正确处理 /ABM/ 路径前缀
- 添加静态资源缓存优化（CSS/JS/JSON/图片）
- 配置 PostgreSQL 数据库服务

网站访问地址: https://amiap.hzau.edu.cn/ABM/
所有静态资源（HTML/CSS/JS/JSON/图片）均可正常访问
 2025-11-20 01:16:06 +08:00
zly
074c09e36e first commit 2025-11-19 22:28:33 +08:00