Zipoly Server 团队版
一句话介绍
把 Zipoly 桌面版的压缩能力变成一个 Web 服务，部署在你自己的服务器上，通过 API 调用或浏览器操作。
适合谁用？
| 你是... | 桌面版够用吗？ | 需要团队版吗？ |
|---|---|---|
| 3D 美术 / 设计师 | ✅ 够了 | 不需要 |
| 个人开发者 | ✅ 够了 | 不需要 |
| 团队（3 人以上共用） | ❌ 每人装一遍太麻烦 | 需要 |
| 有 CI/CD 自动化流水线 | ❌ 无法自动化 | 需要 |
| 数据不能出内网 | ❌ 桌面版跑在个人电脑上 | 需要 |
| 需要批量处理上百个模型 | ❌ 桌面版有批量限制 | 需要 |
能做什么？
| 功能 | 说明 |
|---|---|
| 模型压缩 | Draco / Meshopt 双引擎，GLB 体积减少 60%-90% |
| 格式转换 | GLB、glTF、FBX、OBJ、STL、DAE、PLY 七种格式互转 |
| 纹理优化 | JPEG / WebP / PNG 压缩 + KTX2（Basis Universal）编码 |
| 模型修复 | 自动去空节点、修法线、合并重复顶点、删退化面 |
| 体检诊断 | 生成详细报告：顶点数、面数、贴图信息、问题列表 |
| 批量处理 | 一次提交几十个文件，自动排队并发处理 |
和桌面版的区别
桌面版：打开软件 → 拖入文件 → 点按钮 → 下载结果
团队版：部署到服务器 → 调用 API → 自动处理 → 下载结果核心区别就三点：
- 没有图形界面（但有 Web 管理后台可以看状态）
- 跑在服务器上，不占用你的电脑
- 通过 API 调用，可以接入任何系统
怎么部署？
只需要一台能跑 Docker 的服务器，三步启动：
bash
# 1. 加载镜像
docker load -i zipoly-server-v2.1.0-image.tar
# 2. 启动（一行命令）
docker run -d --name zipoly-server \
-p 8080:80 -v zipoly-data:/app/data \
-e ZIPOLY__SERVER__API_KEY=your-key-here \
zipoly-server:2.1.0
# 3. 打开浏览器验证
curl http://localhost:8080/api/v1/health详细步骤见 Docker 部署。
文档导航
| 我想... | 看这里 |
|---|---|
| 部署服务 | Docker 部署 —— 从零开始，5 分钟跑通 |
| 调用接口 | API 参考 —— 全部端点、参数、示例代码 |
| 调整配置 | 配置参考 —— 并发数、存储、日志等 |
| 了解价格 | 授权与定价 —— 套餐与购买 |
技术架构（给运维看的）
┌─────────────────────────────────────┐
│ Docker 容器 │
│ │
│ ┌──────────┐ ┌───────────────┐ │
│ │ Nginx │───▶│ Zipoly Core │ │
│ │ :80 │ │ (Rust/Axum) │ │
│ └──────────┘ └───────┬───────┘ │
│ │ │
│ ┌──────▼───────┐ │
│ │ SQLite │ │
│ │ + 文件存储 │ │
│ │ (/app/data) │ │
│ └──────────────┘ │
└─────────────────────────────────────┘
▲
│ 映射 :8080
你的服务器对外只需暴露一个端口（默认 8080），数据持久化在 /app/data 卷中。