Zipoly Server 团队版
**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 Key 认证、速率限制与输入验证，上传与结果文件按配置的保留时长自动清理，任务状态通过接口可查询。
和桌面版的区别
text
桌面版：打开软件 → 拖入文件 → 点按钮 → 下载结果
团队版：部署到服务器 → 调用 API → 自动处理 → 下载结果核心区别就三点：
- 没有图形界面（但有 Web 管理后台可以看状态）
- 跑在服务器上，不占用你的电脑
- 通过 API 调用，可以接入任何系统
怎么部署？
只需要一台能跑 Docker 的服务器，三步启动：
- 加载镜像：解压发布包后导入镜像 tar
- 启动容器：一行
docker run拉起服务，设置 API Key 并挂载数据卷 - 验证：访问健康检查接口，返回正常即部署完成
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/zipoly-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 参考 —— 全部端点、参数、示例代码 |
| 调整配置 | 配置参考 —— 并发数、存储、日志等 |
| 了解价格 | 授权与定价 —— 套餐与购买 |
技术架构（给运维看的）
text
┌─────────────────────────────────────┐
│ Docker 容器 │
│ │
│ ┌──────────┐ ┌───────────────┐ │
│ │ Nginx │───▶│ Zipoly Core │ │
│ │ :80 │ │ (Rust/Axum) │ │
│ └──────────┘ └───────┬───────┘ │
│ │ │
│ ┌──────▼───────┐ │
│ │ SQLite │ │
│ │ + 文件存储 │ │
│ │ (/app/zipoly-data) │ │
│ └──────────────┘ │
└─────────────────────────────────────┘
▲
│ 映射 :8080
你的服务器对外只需暴露一个端口（默认 8080），数据持久化在 /app/zipoly-data 卷中。
常见问题
团队版会把模型传到你们的云上吗？
不会。团队版是私有化部署：整个服务跑在你自己的服务器/内网，模型数据不出内网，适合保密要求高的场景。
没有 License Key 能先跑起来吗？
可以。未配置 License Key 时以试用模式运行（功能受限），购买后把 Key 写入环境变量重启容器即立即解锁，详见授权与定价。
和桌面版授权通用吗？
不通用，两套授权相互独立：桌面版按设备授权（GUI），团队版按席位授权（私有化 API）。同团队常见做法是美术用桌面版、CI/CD 与业务系统接团队版 API。
团队版怎么计费？
按席位阶梯：≤3 席 ¥299/年、≤10 席 ¥599/年、不限席位 ¥999/年封顶，可开发票签合同，详见授权与定价。
对服务器配置有什么要求？
不高：能跑 Docker 即可，内存最低 2 GB（推荐 4 GB+）、磁盘 10 GB 可用空间，系统不限（Linux / Windows / macOS）。完整环境要求见 Docker 部署 → 环境要求。
版本升级怎么操作？数据会丢吗？
三步完成，数据不丢：停止并删除旧容器 → docker load 加载新版本镜像 → 用交付包的编排文件重新启动。任务数据与上传文件都持久化在 zipoly-data 卷中，与容器生命周期分离，详见升级版本。