Headless

用于本地部署（通常是在 NAS 里）的单机版无头 studio，没有 Electron，没有服务端调度。

本地调试

准备 .env 文件：

OOMOL_ENV=prod
OOMOL_TOKEN=  # 可选，用于连接 OOMOL 服务 https://console.oomol.com/api-key
START_API_SERVER=true
START_UI_SERVER=true
OOMOL_LOCAL=1
ENABLE_OOMOL_CONNECT=true  # 推荐开启，支持远程操作

打包 pnpm build
运行 pnpm start

Docker 部署

准备存储目录，例如：
```
mkdir -p $HOME/oomol-storage
```

准备环境变量文件：

将 .env 放入 $HOME/.oomol-studio/headless/.env，内容如下（注意删掉 OOMOL_LOCAL=1）：

OOMOL_ENV=prod
OOMOL_TOKEN=  # 可选，用于连接 OOMOL 服务
START_API_SERVER=true
START_UI_SERVER=true
ENABLE_OOMOL_CONNECT=true  # 推荐开启，支持远程操作

拉取并运行 Docker 镜像，绑定存储目录和环境变量文件：

docker pull oomolstudio/headless:latest

docker run -d --privileged --name oomol-headless -p 4000:4000 -p 52222:52222 --mount type=bind,src=$HOME/.oomol-studio/headless/.env,dst=/app/.env --mount type=bind,src=$HOME/oomol-storage,dst=/oomol-driver/oomol-storage oomolstudio/headless:latest

在 http://localhost:4000 访问 UI 界面。

环境变量说明

ENABLE_OOMOL_CONNECT

推荐配置: ENABLE_OOMOL_CONNECT=true

启用此选项后,你可以通过 connect.oomol.com 远程操作 Headless 镜像,包括:

远程调用功能
远程安装功能
远程管理工作流

非常建议打开此选项,它能大大提升你的使用体验。

本地调试
Docker 部署
环境变量说明
- ENABLE_OOMOL_CONNECT