mcpField
O
Oriel

Oriel

本地服务
github.com/ParadoxInfinite云与基础设施817 周前更新

关于 Oriel

Oriel 是面向使用兼容容器引擎的开发者的浏览器 Docker 管理界面和 MCP 服务。它向 MCP 客户端提供经过验证的工具,并遮蔽机密、限制破坏性操作。

主要功能

  1. 01管理容器、镜像、卷、网络和 Compose
  2. 02查看容器详情并流式读取日志
  3. 03进入运行中容器的交互式终端
  4. 04遮蔽机密并限制破坏性操作
  5. 05跟踪 CPU、内存、磁盘和运行时间

适用场景

  1. 01通过检查信息和日志排查容器反复重启
  2. 02在浏览器界面管理 Compose 项目
  3. 03让 MCP 客户端执行受保护的 Docker 操作

MCP 相关

运行 `oriel mcp`,即可将 Oriel 用作管理 Docker 和 Colima 的 MCP 服务。它提供经过验证且已遮蔽机密的工具,破坏性操作需授权,并记录助手发起的工具调用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"oriel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/paradoxinfinite/oriel:0.7.0"
]
}
}
}
启动命令docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
ocighcr.io/paradoxinfinite/oriel:0.7.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Oriel

Oriel

AI 可安全操控的本地 Docker GUI。

通过简洁的浏览器界面管理容器、镜像、卷、网络和 Compose。也可以把工作交给 AI:任何 MCP 客户端(Claude、Cursor、本地大模型)都能使用与界面相同的工具,并采用相同的机密信息屏蔽和破坏性操作授权机制。它适用于 macOS 和 Linux 上的任何 Docker 引擎(Colima、Docker Engine、OrbStack、Podman 或远程守护进程)。这是 Docker Desktop 的免费开源替代方案,所有功能集成在一个约 13 MB 的二进制文件中,空闲时仅占用 15–30 MB 内存;不使用 Electron,无需账户,采用 Apache-2.0 许可证。

CI Go Report Card Release License: Apache-2.0

在线试用 ↗ · 在浏览器中体验完整界面,使用模拟数据,无需安装。

Oriel Studio(浅色) Oriel Studio(深色)

使用 AI 操控

将任意 MCP 客户端连接到 Oriel,然后用日常语言提出问题。它会调用与界面相同、经过验证且会屏蔽机密信息的工具,还能串联多个工具来真正解答问题,而不是只调用一个工具:

你: api 为什么一直重启?

助手: 先读取 container.list、container.inspect,然后查看日志。 它因 137(OOM) 退出:容器内存上限为 256 MB,而 Node 堆内存超出了这个限制。请提高内存上限,或修复 worker.js 中的内存泄漏。

oriel mcp        # stdio MCP server for Claude, Cursor, or a local LLM

二进制文件不包含任何模型;客户端需自行提供模型。读取操作随时可用,破坏性操作则始终需要先授权。设置与工具列表 ↓

安装

Homebrew(macOS 和 Linux):

brew install ParadoxInfinite/oriel/oriel

脚本(自动检测平台并验证校验和):

curl -fsSL https://raw.githubusercontent.com/ParadoxInfinite/oriel/main/install.sh | sh

添加 -s -- --edge 以跟踪预发布版本(优先获取最新构建),或添加 -s -- --uninstall 将其移除:

curl -fsSL https://raw.githubusercontent.com/ParadoxInfinite/oriel/main/install.sh | sh -s -- --edge

⚠️ **通过管道将脚本传给 sh,会在你的机器上运行来自互联网的代码。**请先阅读 install.sh,再运行脚本;或者改为从 releases 下载二进制文件。

手动下载二进制文件、使用 Go 或从源码构建

从 releases 下载二进制文件(Apple Silicon 对应 oriel-darwin-arm64,Intel 对应 oriel-darwin-amd64,另有 oriel-linux-arm64 和 oriel-linux-amd64),然后运行 chmod +x。或者:

go install github.com/ParadoxInfinite/oriel@latest   # with Go
make build                                           # from source (builds + embeds the UI)

运行

./oriel            # opens http://127.0.0.1:4321

参数:--port <n>(默认值为 4321)、--no-open。设置为登录时运行:./oriel service install(launchd / systemd;另有 status、uninstall)。

需要任何兼容 Docker Engine 的运行时和 docker CLI。Colima 提供一流支持(可启动和停止虚拟机);Docker Engine、OrbStack、Rancher/Docker Desktop、Podman 和远程守护进程也都适用(参见文档)。如需通过专用网络进行远程访问,请参阅文档;请先阅读安全说明。

功能特性

  • **容器:**实时 CPU/内存、退出代码、批量操作、流式日志、完整检查。
  • **浏览器内 Shell:**直接从容器详情抽屉打开交互式终端,进入任意正在运行的容器。
  • **AI 控制(MCP):**任意 MCP 客户端都能通过同一套经过验证且会屏蔽机密的工具来控制 Docker/Colima,破坏性操作需先授权。了解更多 ↓
  • **镜像:**通过注册表搜索拉取镜像、清理镜像、一键标记。
  • **Compose:**管理堆栈,并发现和部署磁盘上的项目。
  • **仪表板:**CPU 历史记录、内存、磁盘、运行时间/中断跟踪。
  • 命令面板(⌘K):模糊搜索并运行任意操作,或跳转到任意视图。
  • **版本、主题和语言:**切换整个 UI(Studio,或添加你自己的版本)、浅色/深色/系统主题、自定义强调色,以及支持翻译的界面(内置英语;其他语言按需加载)。
  • **轻量且实时:**约 15–30 MB 内存占用,一个 SSE 流(不轮询),通过校验和验证的自我更新。

对比

在 Mac 或 Linux 设备上运行容器的常见方式,以及 Oriel 的定位。(数据会变化,请将其视为快照。)

OrielDocker DesktopOrbStacklazydockerPortainer
许可证Apache-2.0,免费专有(大型组织需付费)专有(商业用途需付费)MIT,免费免费(CE)
界面图形化 Web UI桌面应用原生应用终端(TUI)Web UI(服务)
资源占用约 15–30 MB 内存,约 13 MB 二进制文件高(约 3–4 GB VM)低(原生)低容器,约 200–300 MB
安装单个静态二进制文件安装程序安装程序单个二进制文件运行容器
自带引擎Colima · Docker · OrbStack · Podman · 远程服务捆绑引擎捆绑引擎任意 Docker socket任意 Docker socket
本地运行,无需账户是账户/登录账户是服务端 + 身份验证
AI 控制(MCP)内置,设有安全防护MCP Toolkit(运行其他服务)否否否

这里列出的产品中,只有它能让 AI 直接控制,并且通过与 UI 相同的检查。相比 Docker Desktop / OrbStack,选择它无需付费许可证、捆绑 VM 或菜单栏应用;相比 lazydocker,它提供真正的图形界面,而非终端界面;相比 Portainer,它是供你自行运行的二进制文件,而不是需要部署并加以保护的服务。

完整对比(包括 Oriel 的不足之处,如 Windows、Kubernetes、多主机支持),请参阅在线演示中的详尽对比。

AI 控制(MCP)

oriel mcp 会将 Oriel 作为 Model Context Protocol 服务运行,因此 MCP 客户端(Claude Desktop、Claude Code、Cursor、本地大模型)可以通过日常语言以无头模式管理你的 Docker/Colima,无需 GUI。使用相同的工具和安全防护:

  • 机密始终受到屏蔽。container.inspect 和 container.logs 会在数据到达模型前,将形似机密的值替换掉;MCP 客户端永远无法获取完全未经处理的环境变量或日志(“关闭”设置仅适用于本地 UI)。日志屏蔽会尽力处理自由格式文本。
  • 破坏性操作默认锁定,直到你开启一个短暂的限时窗口(oriel ai allow-destructive --for 15m)。读取操作始终可用;在你授权前,无法执行删除/清理操作。
  • **每项操作都会记录。**审计日志会记录助手发起的每次工具调用:执行了什么、使用了哪些参数,以及执行时间(Settings → AI activity)。你自己的点击操作不会记录。
  • **二进制文件中不包含模型。**模型由你的客户端提供,因此 Oriel 保持供应商中立。

让任意 MCP 客户端连接到它。安装 Oriel 后:

{ "mcpServers": { "oriel": { "command": "oriel", "args": ["mcp"] } } }

也可以不安装,通过已发布的镜像运行(Linux 主机;挂载 Docker socket):

{ "mcpServers": { "oriel": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "/var/run/docker.sock:/var/run/docker.sock", "ghcr.io/paradoxinfinite/oriel"] } } }

Claude Code:claude mcp add oriel -- oriel mcp。设置、HTTP、作用域和完整工具列表,请参阅:docs/MCP.md。

版本与主题

UI 是基于稳定平台 SDK 的可替换插件:Studio(浅色/深色/跟随系统、自定义强调色)。重新为其配色,或加入你自己的版本(参见 docs/THEMES.md)。

安全

Oriel 开箱即用时没有登录功能,而驱动 Docker 实际上相当于拥有主机上的 root 权限。可选的 Bearer Token 可限制远程访问和 MCP-over-HTTP 访问(默认关闭),但安全的默认做法是仅在本地使用,或仅通过专用网络访问(如 Tailscale、ZeroTier、WireGuard)。绝不可通过公共互联网访问。 完整的信任模型见:SECURITY.md。

常见问题

Colima 有图形界面吗? 有。Colima 按设计仅提供命令行界面,而 Oriel 正是它一直缺少的浏览器 UI。它也可以驱动 Docker Engine、OrbStack、Podman 和远程守护进程。

可以免费替代 Docker Desktop 吗? 可以。采用 Apache-2.0 许可,没有许可费用,也无需账号。将其连接到任意兼容 Docker 的引擎即可。

AI 能管理我的容器吗? 可以。运行 oriel mcp,并将任意 MCP 客户端(Claude、Cursor、本地大模型)连接到它。它可以使用与 UI 相同的、经过验证且会屏蔽机密信息的工具;在你授权之前,破坏性操作始终处于锁定状态。

它与 lazydocker 有什么不同? lazydocker 是终端 UI;Oriel 是图形化浏览器 UI,提供仪表板、流式日志、镜像仓库搜索、Compose 发现和可换主题的版本。

资源占用和支持的平台? 约占用 15–30 MB 内存,二进制文件约 13 MB,不使用 Electron。支持 macOS(Apple Silicon + Intel)和 Linux(amd64 + arm64)。

开发

运行 make dev + make dev-web(Vite 热重载),以及 make test。请参阅 CONTRIBUTING.md。

许可

Apache-2.0 © Oriel 贡献者。请参阅 NOTICE。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。