Orca Server Deploy

Headless Orca serve via systemd, pairing, WSL to Windows.

publieople 8f0c0ad 3 files · 2.6 KB Updated

File contents

Orca Headless Server 部署

orca serve 把 Orca 当无界面服务器跑。

systemd user unit

模板 templates/orca-serve.service。三坑:完整 PATH、ProtectHome=false、PrivateTmp=true。

cp templates/orca-serve.service ~/.config/systemd/user/orca-serve.service
systemctl --user daemon-reload
systemctl --user enable --now orca-serve.service

WSL → Windows 连接

WSL localhost 自动映射 Windows。ws://127.0.0.1:PORT 直达,不用 Tailscale/SSH。 Windows Orca → Settings → Remote Orca Servers → Add Server → 粘贴配对 URL。

配对 URL 提取

orca serve 输出截断配对码(...),但 orca_server_ready JSON 含完整 URL。 从 ~/.orca/serve.log 提取:

grep orca_server_ready ~/.orca/serve.log | python3 -c "
import sys,json
d=json.loads(sys.stdin.read().split('{',1)[1])
print(d['pairing']['url'])
" > ~/.orca/pairing-url.txt

端口

默认 6768。被占自动 fallback。--port 强制指定。无害警告:D-Bus/Fontconfig/Codex ENOENT。

publieople/hermes-config-kit/tree/main/skills/orca-server-deploy commit 8f0c0adaa4

Frequently asked questions

npx skillmds@latest add publieople/orca-server-deploy