manyfold3d/manyfold

这是什么？

核心功能

• 01在自托管的网页界面中存储和整理 3D 模型文件。
• 02基于 THREE.js 在浏览器中预览 3D 模型。
• 03通过 Sidekiq 异步处理后台任务。
• 04生产环境支持 PostgreSQL，开发环境使用 SQLite。
• 05以多平台 Docker 镜像发布，并提供 Docker Compose 部署说明。

适用场景

• 为 3D 打印整理个人的 STL、OBJ 模型库。
• 在自有服务器上为创客空间或小团队搭建共享模型档案库。
• 将其作为包含 3D 渲染功能的 Rails 应用参考代码阅读。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/manyfold3d/manyfold.git
2. 2

   进入项目目录

   cd manyfold
3. 3

   使用开发脚本启动应用（安装依赖、初始化数据库，访问地址 http://127.0.0.1:3214）

   bin/dev

使用前须知

• !需要在本地安装多种工具，如 Ruby 3.4、Node.js、libarchive、ImageMagick 和 assimp。
• !生产环境部署最好使用 Docker Compose 和 PostgreSQL，设置较为繁琐。
• !采用 AGPL-3.0 许可证，这是一种 copyleft 许可证，修改后通过网络提供服务时同样适用。

收录于专题

标签

常见问题

manyfold 是什么？

一款自托管的网页应用，用于整理和管理 3D 模型文件，尤其适合 3D 打印资料。 Manyfold 是一款开源、可自托管的网页应用，用于管理 3D 模型集合，重点面向 3D 打印场景。它把模型文件集中存放、浏览和整理，省去在多个文件夹和硬盘之间翻找的麻烦。

manyfold 可以免费使用吗？用的什么许可证？

manyfold 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

manyfold 还在维护吗？

活跃维护中。manyfold 最近一次提交是在 2026年11月6日。

manyfold 适合用来做什么？

为 3D 打印整理个人的 STL、OBJ 模型库。 在自有服务器上为创客空间或小团队搭建共享模型档案库。 将其作为包含 3D 渲染功能的 Rails 应用参考代码阅读。

manyfold 怎么安装和运行？

克隆代码仓库: git clone https://github.com/manyfold3d/manyfold.git 进入项目目录: cd manyfold 使用开发脚本启动应用（安装依赖、初始化数据库，访问地址 http://127.0.0.1:3214）: bin/dev

在哪里获取 manyfold？

源代码和安装说明在 GitHub 上：https://github.com/manyfold3d/manyfold