如何在香港VPS上自行托管Orca：分步设置步骤-华纳云

如何在香港VPS上自行托管Orca：分步设置步骤

时间 : 2026-08-30 10:03:03

编辑 : 华纳云

阅读量 : 7

　　如果你正在用Claude Code、Codex这类AI编程助手，大概率遇到过这种情况：开好几个终端窗口，每个窗口跑一个AI，来回切换看哪个任务跑完了、哪个出错了，手忙脚乱。Orca要解决的就是这个问题——它让多个AI编程助手在独立的工作区里并行干活，结果在一个界面里统一查看和对比。

　　Orca本身不是大模型，它不负责推理，而是充当一个“编排器”，调度你已有的那些AI工具。部署到香港VPS上之后，AI任务可以7x24小时持续运行，不用担心本地电脑休眠或者断网导致进程中断。下面把在VPS上部署Orca服务端的完整流程拆开来讲，照着做就行。

　　准备工作，动手之前，先把需要的东西准备好：

一台香港VPS，操作系统选Ubuntu 22.04 LTS(官方文档最推荐这个版本，踩坑最少)
root权限的SSH访问
至少一个AI编程助手的订阅，比如Claude Code、Codex或OpenCode——Orca本身不带Agent，也不额外收费
如果打算通过HTTPS远程访问，准备一个域名(非必须，但建议加上)

　　服务器配置怎么选：Orca对资源的需求取决于你打算同时跑几个Agent。官方给的一个参考标准是：每个并发Agent大约需要4GB内存，再加上操作系统、Xvfb和Orca本身占用的4GB基础开销。当然这是官方给的保守建议，如果只是轻量使用，4核8GB也能跑，但同时跑多个Agent可能会卡。

　　第一步：准备服务器环境

　　SSH登录到你的VPS：

ssh root@你的服务器IP

　　确保系统是最新的：

sudo apt-get update
sudo apt-get upgrade -y

　　确认一下系统版本：

lsb_release -a

　　如果是Ubuntu 22.04，后面的命令可以直接照抄。如果是24.04，注意后面几个包名有变化。

　　第二步：安装Orca运行环境

　　Orca是以一个独立的Linux AppImage分发的，在无图形界面的VPS上跑需要装一堆依赖库。这条命令一次性全装好：

sudo apt-get install -y \
  curl libfuse2 xvfb \
  libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 \
  libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 \
  libpango-1.0-0 libcairo2 libgtk-3-0 libgdk-pixbuf2.0-0 \
  libnss3 libnspr4 libxss1 libxtst6 libasound2t64

　　这几个依赖的作用分别是：

　　libfuse2：AppImage运行的基础

　　xvfb：虚拟显示服务器，让无头服务器能跑图形程序

　　GTK和Electron相关库：Orca的Electron前端需要这些

　　Ubuntu 24.04用户注意：libfuse2改名叫libfuse2t64，libasound2改名叫libasound2t64。上面的命令已经用了24.04的名字，如果你是22.04，把libfuse2t64改成libfuse2，libasound2t64改成libasound2。

　　装完依赖，下载Orca AppImage：

sudo mkdir -p /opt/orca
sudo curl -L https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage \
  -o /opt/orca/orca-linux.AppImage
sudo chmod +x /opt/orca/orca-linux.AppImage

　　验证一下文件能正常执行：

/opt/orca/orca-linux.AppImage --version

　　如果看到输出版本号，说明环境没问题了。如果报libfuse.so.2: cannot open shared object file的错误，检查一下libfuse2有没有装好；如果报libatk-1.0.so.0相关的错误，把上面那串apt-get命令再跑一遍。

　　第三步：创建专用服务用户

　　这一步不能省。Electron应用拒绝以root身份运行(除非加--no-sandbox参数，但不推荐这么做)，而且用非root用户跑服务本身也更安全。

　　创建一个名叫orca的系统用户：

sudo useradd --system --create-home --shell /usr/sbin/nologin orca

　　然后把/opt/orca目录的所有权给这个用户：

sudo chown -R orca:orca /opt/orca

　　这里有个细节：官方文档建议保持安装目录root所有，服务用户只有读取和执行权限，不能替换文件。但上面这条命令给了orca用户完整权限，方便后续操作。如果对安全要求比较高，可以参考官方文档做更严格的权限控制。

　　第四步：前台测试——确认能跑起来

　　在配置系统服务之前，先用前台模式跑一次，确认Orca能正常启动并拿到配对URL。

sudo -u orca sh -c 'xvfb-run --auto-servernum \
  /opt/orca/orca-linux.AppImage serve'

　　xvfb-run会启动一个虚拟显示器，Orca在这个虚拟环境里运行。

　　启动成功的话，终端里会输出一串类似这样的信息，里面有配对地址：

Orca server running on http://localhost:6768
Pairing URL: http://xxx.xxx.xxx.xxx:6768/pair/xxxxx

　　看到配对URL说明服务端已经跑起来了。按Ctrl+C停止，继续下一步。

　　第五步：配置systemd服务(让Orca开机自启)

　　前台跑能通之后，把它注册成systemd服务，这样VPS重启后Orca会自动启动。

　　创建服务文件：

sudo vi /etc/systemd/system/orca-serve.service

　　写入以下内容：

[Unit]
Description=Orca runtime server
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5

[Service]
Type=simple
User=orca
WorkingDirectory=/home/orca
Environment=LIBGL_ALWAYS_SOFTWARE=1
ExecStart=/usr/bin/xvfb-run --auto-servernum /opt/orca/orca-linux.AppImage serve --port 6768 --pairing-address 你的服务器公网IP
StandardOutput=journal
StandardError=journal
KillMode=mixed
Restart=on-failure
RestartPreventExitStatus=3
RestartSec=5

[Install]
WantedBy=multi-user.target

　　几个关键参数说明：

　　--port 6768：Orca服务监听的端口，可以改成你想要的

　　--pairing-address：填服务器的公网IP或者域名，客户端通过这个地址连接

　　KillMode=mixed：先给主进程发优雅停止信号，超时后再强杀，能避免Xvfb残留

　　RestartPreventExitStatus=3：退出码3表示配置文件已被其他进程占用，不重启

　　然后让服务生效：

sudo systemctl daemon-reload
sudo systemctl enable --now orca-serve.service

　　查看启动日志确认没有报错：

sudo journalctl -u orca-serve.service -f

　　如果一切正常，你会看到类似前台测试时的那条配对URL输出。

　　第六步：配置反向代理(可选但推荐)

　　Orca默认监听6768端口，直接暴露公网也能用，但配上Nginx做HTTPS代理会更安全。而且Orca的配对机制涉及设备注册，不加密的话存在一定风险。

　　安装Nginx：

sudo apt install nginx -y

　　创建站点配置：

sudo vi /etc/nginx/sites-available/orca

　　写入：

server {
    listen 80;
    server_name 你的域名.com;

    location / {
        proxy_pass http://127.0.0.1:6768;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

　　启用站点：

sudo ln -s /etc/nginx/sites-available/orca /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

　　如果需要HTTPS，用Certbot申请免费SSL证书：

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d 你的域名.com

　　第七步：客户端连接

　　服务端跑起来之后，在本地电脑上打开Orca桌面客户端(从官网下载安装包)，点击连接远程服务器，输入配对地址，就可以像操作本地环境一样使用VPS上运行的Orca了。

　　Orca还提供了iOS和Android配套App，通过手机也能监控任务进度和接收通知。

　　部署完之后，你可以在VPS上同时拉起多个Agent处理不同的开发任务，所有状态都持久化在云端，本地电脑随时关机都不影响任务执行。这套方案搭好之后，相当于有了一个24小时在线的AI开发舰队。