NAS / Docker / 自部署

书、游戏、漫画、电影与剧集，一个自部署的个人数字库。

FolioSpace Library 运行在你的 NAS、Docker 主机或本地服务器上。它不托管内容，也不是云盘，而是把你已经拥有的个人数字资产整理成一个统一索引，再提供 Web 界面、客户端 API 和 MCP 工具给 FolioSpace Reader、SpatialEMU 或 Agent 使用。

Docker 安装了解 Reader

FolioSpace Library 1.01

本地书库

扫描任务

游戏目录

客户端接口 GET /api/client/home GET /api/client/videos

FolioSpace Library 1.03 · 电影与剧集库

书、游戏、漫画之外，把自己的影片也整理起来。

在 NAS 或 Docker 主机上统一管理自己的电影与剧集。分页海报墙、作品与媒体库筛选，以及季、集、特别篇和多文件版本，让本地影片更容易浏览。

影片封面与资料

使用本地 NFO 和图片，手动修正资料，也可选择通过 TMDB 搜索候选作品。检查并确认匹配后，再明确请求资料与影片封面。

面向兼容客户端的电影服务

服务器提供目录、海报、元数据、原文件流，以及已看状态、继续观看和下一集接口。解码由客户端完成；具体功能需要能力检测和兼容的客户端版本。

按需启用 TMDB

在线匹配默认关闭。部署者配置自己的 TMDB API Read Access Token 后才会启用。不启用在线来源，也能使用本地文件、NFO、图片和手动资料。TMDB 提供资料和图片，不提供影片文件。

Library 1.03 是服务端版本，不代表商店客户端发布新版本或已有容器自动升级。保留原有可选 HLS 兼容能力。TMDB 匹配和季目录刷新需要明确操作，不会自动抓取整个影片库。

查看 1.03 发布说明配置可选 TMDB 匹配

使用前请查阅 TMDB 条款与署名要求；拥有自己的令牌不等于获得商用许可。

为什么需要它

文件夹能存东西，但很难被不同设备舒服地使用。

很多人已经把漫画、电子书、PDF 手册、游戏 ROM、视频文件放在 NAS 或移动硬盘里。问题不在于“有没有文件”，而在于缺少一个轻量、清楚、可被客户端读取的本地服务层。

电子书和 EPUB

记录阅读进度、封面、章节和私有状态，让 Reader 不必直接处理真实文件路径。

漫画和 ZIP / CBZ

按需读取归档里的页面，适合本地漫画库，也避免一开始就把大文件全部解开。

PDF 和说明书

扫描 PDF，生成首页预览，并通过服务 URL 提供单页或双页阅读。

本地 ROM 目录

只管理用户自己已有的本地 ROM 文件，不提供下载源，也不内置任何资源。

电影与剧集库

海报浏览、本地资料、可选 TMDB 匹配、季集管理，以及面向兼容客户端的服务接口。

扫描任务可见

扫描进度、耗时、暂停、取消、恢复和错误列表都能看到，出问题不用猜。

产品边界

它不是另一个大而全的媒体中心。

FolioSpace Library 的定位更接近“个人资产索引层 + 客户端服务层”。它应该轻、透明、容易部署，而不是替代所有媒体服务器。

不是云服务

服务端由用户自己部署。FolioSpace Library 不上传、不托管、不同步你的内容。

不是 Plex / Jellyfin 替代品

服务器提供影片目录、资料、海报和原文件流；解码由客户端完成，保留可选 HLS 兼容能力。

不是 ROM 资源站

ROM 功能只索引本地已有文件，不提供下载、分发或版权资源。

不是只给网页用

它的核心价值是给 iPhone、iPad 与 Vision Pro 上的 FolioSpace Reader、SpatialEMU、MCP Agent 等客户端提供统一入口。

快速开始

先用 Docker 跑起来，再把 NAS 目录挂进去。

服务端发布版本：1.03。镜像支持 linux/amd64 和 linux/arm64。 /config 必须是可写持久化目录，用来保存 SQLite、封面、缩略图和缓存。

docker pull funland/foliospace-library:1.03

docker run -d \
  --name foliospace-library \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /volume1/docker/foliospace-library/config:/config \
  -v /volume2/ComicCenter:/library:ro \
  -v /volume2/Books:/books:ro \
  -v /volume2/GameROMS:/games:ro \
  -v /volume2/MovieCollection/Movies:/videos:ro \
  -e FOLIOSPACE_DIRECTORY_ROOTS=/library,/books,/games,/videos \
  funland/foliospace-library:1.03

打开 http://你的NAS地址:8080。首次进入会创建访问密钥，然后选择容器内可见的目录，例如 /library、/books、 /games 或 /videos。

Reader

FolioSpace Reader 已经可以把这个资产库带到 iPhone、iPad 和 Vision Pro。

FolioSpace Reader 保留独立的本地阅读体验，也可以选择连接 FolioSpace Library，浏览 NAS 上的 EPUB、PDF 与漫画、同步进度，并按需下载到设备离线阅读。

查看 Reader 联系支持

本地阅读优先

不是在空间里摆一个书架，而是让你更安静地读完一本书。

远程书库作为补充

Reader 可以继续支持本地导入，也可以逐步接入 NAS 上的 FolioSpace Library。

API / MCP

给客户端和 Agent 一个安全的服务入口。

Client API 返回的是服务 URL 和 manifest，不暴露 NAS 真实路径。 MCP 则让 Codex、Claude Desktop 或 Hermes 这类工具查询版本、健康状态、扫描任务、视频转码状态和资源 manifest。

curl -fsSL https://foliospace.app/install-mcp.sh | sh

foliospace.client_info
foliospace.list_videos
foliospace.open_video_manifest
foliospace.get_video_transcode_queue