Install guide
如何用 Docker 啟動 AiyoPerps Headless
如果你只需要本機 REST API 與 MCP，而不需要桌面 GUI，這篇頁面會帶你直接用 Docker 啟動 AiyoPerps 的 headless 模式。
前置需求
- 已安裝 Docker
- 可開放本機 `5078` 埠號
- 需要 REST API 或 MCP 連接能力
1使用 docker run 啟動容器
使用 Docker 命令可直接啟動最新映像並自動將本機 `5078` 映射進容器。
或也可以在 Docker Hub 搜尋 AiyoPerps。
docker run --rm --name aiyoperps -p 5078:5078 phidiassj/aiyoperps:latest
2確認容器與埠號狀態
確認容器正在執行，並且 `5078` 已經正確綁定到本機。
docker ps
3驗證 OpenAPI 或 MCP 端點
在瀏覽器開啟 OpenAPI UI，或直接對 MCP 端點做連線測試。只要頁面能打開，就表示 headless 服務正常。
下一步
查看 MCP / REST API 工具手冊
完成 headless 服務後，下一步通常是整理 MCP 工具與 API 端點，方便寫入 AI Agent prompt。
前往 MCP / REST API 手冊改走桌面版？
如果你後來需要圖形化操作，請改看 Windows 或 Linux 安裝頁。
查看 Windows 安裝