ghcr.io/besoeasy/yantr:20260406

⚡ Yantr

您的自托管应用商店 — 与现有操作系统并行运行，无需接管硬件。

快速开始 · 应用目录 · 功能特性 · 官方网站 · 报告问题

其他家庭实验室平台的问题

Umbrel、CasaOS、Proxmox — 它们都想成为您的操作系统。您必须擦除机器，完全将其交给这些平台，一旦出现问题，还需费力恢复工作流程。

Yantr 采用不同的方法。

它作为容器在您现有的机器上运行。日常使用的笔记本电脑、游戏 PC、旧服务器 — 都可以。30 秒内完成安装，从目录部署 130+ 应用，使用完毕后也能彻底干净地卸载。您的操作系统会保持原样。

┌─────────────────────────────────────────┐
│ 您的操作系统 │
│ │
│ ┌─────────────┐ ┌─────────────────┐ │
│ │ Yantr 容器 │ │ 您现有的应用和文件 │ │
│ └──────┬──────┘ └─────────────────┘ │
│ │ Docker API │
│ ┌──────▼──────────────────────────┐ │
│ │ Jellyfin · n8n · Nextcloud ... │ │
│ │ (隔离的 Docker 栈) │ │
│ └──────────────────────────────────┘ │
└─────────────────────────────────────────┘

🚀 快速开始

[!IMPORTANT] 要求：Docker — 安装指南

docker run -d \
--name yantr \
--network host \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /var/lib/docker/volumes:/var/lib/docker/volumes \
--restart unless-stopped \
ghcr.io/besoeasy/yantr

打开 http://localhost:5252 — 就是这样。无需配置文件，无需账户，无需设置向导。

📦 应用目录

130+ 精选应用，全部支持一键部署。

在 apps/ 中浏览完整列表 · 通过 apps/apps.md 贡献新应用

✨ 功能特性

零系统占用

Yantr 从不触碰主机文件系统。每个应用都在独立的 Docker 栈中运行，拥有隔离的卷。卸载应用后不会留下任何痕迹 — 无注册表项、无后台服务、无散落的配置文件。

一键部署

从目录中选择应用，点击部署即可。Yantr 自动处理 Compose 文件配置、端口分配和卷设置。

无依赖冲突

AI 模型、媒体服务器和数据库可并行运行，无版本冲突。Python、Node、CUDA — 每个应用都在容器内自带运行时环境。

全生命周期控制

网络与远程访问

• 端口冲突检测 — Yantr 跟踪所有已分配的主机端口，防止冲突
• Tailscale — 无需端口转发即可实现私有管理访问
• Cloudflare Tunnel — 无需开放路由器即可公开发布服务
• Caddy 反向代理 — 为任何内部应用添加认证和 HTTPS

存储与备份

• 直接从浏览器浏览和管理卷数据
• 基于 Restic 的加密备份，支持定时运行和时间点恢复
• 支持本地路径、S3 兼容存储和 Backblaze B2

REST API + 命令行友好

所有操作（安装、移除、日志、备份、状态）均通过 JSON 端点提供。可使用 curl、shell 脚本或 cron 实现自动化。

# 检查运行中的应用
curl http://localhost:5252/api/stacks

# 部署应用
curl -X POST http://localhost:5252/api/stack/jellyfin/up

🏗️ 工作原理

Yantr 是一个单一的 Docker 容器，它：

1. 在端口 5252 上提供 Vue 3 网页界面
2. 暴露 Fastify REST API，通过 socket 管理 Docker
3. 从内置目录读取应用模板（Docker Compose + 元数据）
4. 部署隔离的栈 — 每个应用都是独立的 Docker Compose 项目

无数据库、无外部依赖、无主机代理。

🤝 贡献指南

欢迎提交 PR。要向目录添加应用，请遵循 apps/apps.md 中的格式。编辑 apps/ 中的任何应用后，运行：

node check.js

在提交 PR 前修复其报告的所有格式问题。

基于 Vue 3 · Fastify · Docker · Tailwind CSS 构建

yantr.org · 问题反馈 · 应用格式指南