using-exe-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

About

关于

exe.dev provides Linux VMs with persistent disks, instant HTTPS, and built-in auth. All management is via SSH.
exe.dev提供带有持久化磁盘、即时HTTPS和内置身份验证功能的Linux虚拟机,所有管理操作都通过SSH完成。

Documentation

文档

The index is organized for progressive discovery: start there and follow links as needed.
文档索引按循序渐进的逻辑组织:建议从索引页开始,按需点击对应链接查看内容。

Quick reference

快速参考

ssh exe.dev help             # show commands
ssh exe.dev help <command>   # show command details
ssh exe.dev new --json       # create VM
ssh exe.dev ls --json        # list VMs
ssh exe.dev rm <vm>          # delete VM
ssh <vm>.exe.xyz             # connect to VM
scp file.txt <vm>.exe.xyz:~/ # transfer file
Every VM gets
https://<vm>.exe.xyz/
with automatic TLS.
ssh exe.dev help             # 显示命令列表
ssh exe.dev help <command>   # 查看指定命令的详情
ssh exe.dev new --json       # 创建虚拟机
ssh exe.dev ls --json        # 列出所有虚拟机
ssh exe.dev rm <vm>          # 删除虚拟机
ssh <vm>.exe.xyz             # 连接到虚拟机
scp file.txt <vm>.exe.xyz:~/ # 传输文件到虚拟机
每个虚拟机都会自动分配
https://<vm>.exe.xyz/
地址并自动配置TLS证书。

A tale of two SSH destinations

两类SSH目标说明

  • ssh exe.dev <command>
    — the exe.dev lobby. A REPL for VM lifecycle, sharing, and configuration. Does not support scp, sftp, or arbitrary shell commands.
  • ssh <vm>.exe.xyz
    — a direct connection to a VM. Full SSH: shell, scp, sftp, port forwarding, everything.
  • ssh exe.dev <command>
    — exe.dev入口,用于执行虚拟机生命周期管理、共享、配置相关操作的REPL环境,不支持scp、sftp或任意Shell命令。
  • ssh <vm>.exe.xyz
    — 与虚拟机的直接连接,支持完整SSH功能:Shell、scp、sftp、端口转发等所有功能。

Working in non-interactive and sandboxed environments

非交互式与沙箱环境下的使用说明

Coding agents often run SSH in non-interactive shells or sandboxes. Common issues and workarounds:
scp/sftp failures: Ensure you're targeting
<vm>.exe.xyz
rather than
exe.dev
. Use ssh-based workarounds.
Hung connections: Non-interactive SSH can block on host key prompts with no visible output. Use
-o StrictHostKeyChecking=accept-new
on first connection to a new VM.
SSH config: Check whether both destinations are configured to use the right key:
Host exe.dev *.exe.xyz
  IdentitiesOnly yes
  IdentityFile ~/.ssh/id_ed25519
代码Agent通常会在非交互式Shell或沙箱中运行SSH,常见问题及解决方案如下:
scp/sftp连接失败:请确保你连接的目标是
<vm>.exe.xyz
而非
exe.dev
,可使用基于SSH的替代方案。
连接卡住:非交互式SSH可能会在主机密钥验证环节阻塞且无可见输出,首次连接新虚拟机时请添加
-o StrictHostKeyChecking=accept-new
参数。
SSH配置:请检查两类SSH目标是否都配置了正确的密钥:
Host exe.dev *.exe.xyz
  IdentitiesOnly yes
  IdentityFile ~/.ssh/id_ed25519