跳转到内容
选择主题
选择语言简体中文

环境变量

变量 作用
ACDEV_INSTALL 安装目录, 默认 ~/.acdev
ACDEV_DIST 安装脚本从哪里下载 acdev 和它的运行时, 也是 acdev doctor --online 去找更新版本的地方; 默认 https://pkgs.dopame.ai/acdev
ACDEV_SDK acdev new 和 acdev sdk update 让 @dopame/acde-api 指向的 SDK 目录; 默认是随 acdev 一起来的那个
ACDEV_VM_DIR acdev vm 把客户机放在哪里: 镜像、overlay 磁盘、socket、日志; 默认 ~/.local/share/acdev/vm
ACDEV_VM_TRANSPORT acdev vm start 怎样连到客户机里的 acdevd: vsock (Linux 上的默认)、tcp (127.0.0.1 上的一个转发端口, macOS 和 Windows 上的默认) 或 unix (虚拟机目录里一个转发的 Unix socket; 只在设了时用, 需要支持 hostfwd=unix 的 QEMU (2025 年 10 月合入上游; 第一个带它的版本大概是 10.2, 未核实)、libslirp 4.7.0 或更新、不是 Windows 主机, 并且 socket 路径里没有 -, 除非 QEMU 还带了 2026 年 6 月那个按最后一个连字符拆分规则的修复; QEMU 8.2.2 会说 Bad protocol name)
ACDEV_QEMU_DIR acdev vm 用的 qemu-system-x86_64 和 qemu-img 所在的目录 (先于 PATH 查找; Windows 上 PATH 之后再查注册表和 %ProgramFiles%\qemu, macOS 上再查 Homebrew 和 MacPorts)
ACDEVTOOL acdev vm 跑的 acdevtool 二进制: Windows 上用 acdevtool relay 连 QEMU 的 QMP 和客户机代理的 socket, acdev vm start --viewer 和 acdev vm view 用 acdevtool view (默认: 装好的 libexec/acdevtool, 否则从检出的 crates/tool 构建)
ACDEV_VM_ARCH acdev vm 的客户机架构: x86_64 或 aarch64 (默认: Apple 芯片这类 arm64 主机上是 aarch64, 否则 x86_64)
ACDEV_VM_CPUS acdev vm start 给客户机几个 CPU; 默认 4
ACDEV_VM_MEMORY acdev vm start 给客户机多少内存, 写法同 QEMU (8G、4096M); 默认 8G
ACDEV_VM_DIST acdev vm fetch 从哪里下载客户机磁盘镜像; 默认是 acdev 自己的镜像服务器
ACDEV_VM_PASSWORD acdev vm provision 和 acdev test --vm 给客户机的测试用户设的密码; 默认 dopame-dev
ACDEV_DEVD acdev vm start 放进客户机的 acdevd 二进制 (设备守护进程); 文件不在时 acdev 报错停下. 默认: 安装脚本按客户机架构放在 acdev 旁边的那个 (libexec/acdevd-<arch>)
ACDEV_RUNTIME acdev dev 和 acdev test 跑的运行时二进制: 二进制的路径 (不在 PATH 上查找; 文件不在时 acdev 报错停下). 没设: 安装脚本装在 acdev 旁边的那个, 即安装目录的 libexec/acdev
ACDEV_BUNDLER=vite Bun 上也用 Vite 打包
ACDEV_DEBUG=1 出错时还打出调用栈 (平常只有一行消息)
ACDEV_BROWSER acdev devtools 和 acdev dev 里的 F12 在哪个浏览器里打开 DevTools: 一个路径, 或 none, 什么都不开, 只打出地址. 没设: Windows 上先 Edge 再 Chrome; macOS 上先 Chrome 再 Edge; Linux 上是 PATH 上的 Chrome、Chromium 或 Edge
CI 设了时 toHaveScreenshot 不会写新的基线, 缺基线直接失败
NO_COLOR 设了且不为空: acdev 的输出不带颜色
FORCE_COLOR 设了且不是 0 或 false: 输出不是终端时也带颜色

acdev dev 和 acdev test 会替你设好需要的. 手动调整:

变量 作用
ACDE_PATH 额外的包目录 (Windows 用 ; 分隔)
ACDE_DESKTOP 默认桌面
ACDE_HEADLESS=1 不开窗口
ACDE_SIZE 屏幕尺寸, 如 1280x800
ACDE_SCALE headless 时的缩放 (0.5–4)
ACDE_COLOR_SCHEME light / dark
ACDE_STORAGE 网页存储的根目录; 设成空则只在内存
ACDE_AUTOSTART 自启动项默认只在 Dopame OS 会话里跑: 1 在宿主窗口里也跑, 0 不跑
ACDE_AUDIO=null 不出声
ACDE_CAPTURE=fake 用假的摄像头和麦克风 (Fake camera、Fake microphone) 代替系统的设备, 给 getUserMedia() 用
ACDE_FRAME_STYLE 标题栏样式: mac (红绿灯) 或 windows (Windows 的按钮). 没设: Windows 上的宿主窗口里是 windows, 其他情况是 mac
变量 是什么
ACDE_APP_ID 应用 id
ACDE_APP_DATA 应用的数据目录 (也是工作目录)
ACDE_APP_SOCKETS 应用的 socket 目录. Windows 上的 Node.js 后端没有这个变量, 它拿到的是 ACDE_APP_CHANNEL=fd; 见 后端
PORT 配置的端口
NODE_ENV production
http_proxy、https_proxy、all_proxy、no_proxy 会话的代理变量; 没有的话是系统的手动代理 (Windows、macOS) 连同它的例外, no_proxy 里再加上 localhost,127.0.0.1,::1; Windows 上是大写的名字, 其它平台大小写都有. 见 后端