运行代码文件

❖ Arcadia CLI - 运行代码文件

  使用方法：

    arcadia run <name/path/url> [--options]

  命令选项：

    -l, --loop                  循环运行 - 连续多次的执行代码文件，选项后需跟循环次数
    -s, --silent                静默运行 - 不推送任何通知消息
    -w, --wait                  推迟执行 - 等待指定时间后再运行任务，选项后需跟时间值
    -D, --delay                 延迟执行 - 随机倒数一定秒数后再执行代码文件
    -a, --agent                 网络代理 - 为 JavaScript 和 TypeScript 代码文件启用全局 HTTP/HTTPS 代理，配置方法详见文档
    -T, --timeout               运行超时 - 设置运行任务超时机制，选项后需跟 timeout 指令的参数作为选项值
    -N, --no-log                禁用日志 - 不记录代码运行日志
    -p, --proxy                 启用下载代理 - 仅适用于执行位于 GitHub 仓库的代码文件，代理固定为 jsDelivr CDN
    -c, --concurrent            并发运行 - 默认运行1个任务，若想增加运行任务数量那么请传参任务数量
    -t, --thread                并发线程数 - 指定同时运行的最大任务数量，选项后需跟正整数，需与并发运行同时使用
    -b, --background            后台运行 - 不在前台输出代码执行进度，不占用终端命令行
    -r, --recombine-env         变量重组 - 按照指定顺序重新组合复合变量的值，选项后需跟变量名称、分隔符、重组表达式
ㅤ                                        表达式语法：多个值用 "," 隔开，值区间用 "-" 连接，可以用 "%" 表示值的总数
    -R, --recombine-env-group   分组运行 - 为每组变量单独运行，是变量重组的扩展，传参基本一致，其中重组表达式内用 "@" 来区分不同组
    -S, --split-env             拆分运行 - 将复合变量的值拆分后为每个值声明变量并单独运行代码文件，选项后需跟需要拆分的变量名称、分隔符

    -E, --exec-args             执行参数 - 将该选项后面的内容作为参数传递给代码执行器
    --                          传递选项 - 将该选项后面的所有内容都作为选项参数传递给代码文件

    --deno，--use-deno          使用 Deno 运行时
    --bun，--use-bun            使用 Bun 运行时
    --node，--use-node          使用 Node.js 运行时
    --tsx，--use-tsx            使用 tsx 执行
    --ts-node，--use-ts-node    使用 ts-node 执行

    沙箱：

    --sandbox                                 沙箱模式，在受限环境中运行代码，隔离网络、文件系统和内存
    --sandbox-net-allow <spec>                出站白名单，仅放行匹配规则的出站连接（指定后取代默认全量联网），可多次使用
    --sandbox-net-deny <spec>                 出站黑名单，仅屏蔽匹配规则的出站连接（默认联网不变），可多次使用，与 --sandbox-net-allow 互斥
    --sandbox-net-deny-all                    完全断网，阻断所有出站网络连接
    --sandbox-net-deny-local                  屏蔽局域网，阻断本地回环、私网网段及云元数据地址，可与 --sandbox-net-deny 叠加
    --sandbox-net-allow-bind <port>           允许绑定指定端口，放行指定 TCP 端口的服务端绑定监听（与出站控制独立），可多次使用
    --sandbox-net-allow-bind-all              允许绑定任意端口，放行所有 TCP 端口绑定监听，与 --sandbox-net-allow-bind 互斥
    --sandbox-http-allow <rule>               HTTP 请求白名单，仅放行匹配的 HTTP/HTTPS 请求（格式："METHOD host/path"），可多次使用，与 --sandbox-http-deny 互斥
    --sandbox-http-deny <rule>                HTTP 请求黑名单，屏蔽匹配的 HTTP/HTTPS 请求（格式："METHOD host/path"），可多次使用，与 --sandbox-http-allow 互斥
    --sandbox-max-memory <size>               内存上限，限制进程最大内存用量（例如 512M、1G）
    --sandbox-clear-env                       清空环境变量，移除所有继承的环境变量（仅保留最小系统路径）
    --sandbox-env KEY=VALUE                   注入环境变量，向进程追加自定义环境变量，可多次使用
    --sandbox-allow-env-whitelist VAR1,VAR2   环境变量白名单，仅保留指定变量（隐式启用清空），与 --sandbox-clear-env 互斥
    --sandbox-allow-env-blacklist VAR1,VAR2   环境变量黑名单，排除指定变量（其余正常继承）
    --sandbox-allow-read <path>               允许只读访问，在预设挂载之外追加只读目录，可多次使用
    --sandbox-allow-write <path>              允许读写访问，在预设挂载之外追加读写目录，可多次使用
    --sandbox-opts <args>                     透传底层参数，将原始参数直接传递给 sandlock（选项名与值写在同一字符串内），可多次使用

  命令帮助：

    <name> 文件名(仅scripts目录)  <path> 相对路径或绝对路径  <url> 链接地址  [--options] 命令选项

arcadia run <name/path/url> [--options]

arcadia stop <name/path>

❖ Arcadia CLI - 运行代码文件（守护进程）

  使用方法：

    arcadia rund <name/path> [--options]

  专属命令选项：

    --name                          指定任务名称
    --max-restarts                  指定最大重启次数
    --restart-delay                 指定重启延迟毫秒数
    --log-file                      指定日志文件路径
    --restart-cron                  指定重启计划任务
    --no-autorestart                禁用进程崩溃后的自动重启
    --max-memory-restart            内存超出指定值时自动重启（例如 200M）
    --stop-exit-codes               指定不触发自动重启的退出码
    --exp-backoff-restart-delay     启用指数退避重启，指定初始延迟毫秒数

  通用命令选项：

    -s, --silent                静默运行 - 不推送任何通知消息
    -a, --agent                 网络代理 - 为 JavaScript 和 TypeScript 代码文件启用全局 HTTP/HTTPS 代理，配置方法详见文档
    -r, --recombine-env         变量重组 - 按照指定顺序重新组合复合变量的值，选项后需跟变量名称、分隔符、重组表达式
                                           表达式语法：多个值用 "," 隔开，值区间用 "-" 连接，可以用 "%" 表示值的总数

    -E, --exec-args             执行参数 - 将该选项后面的内容作为参数传递给代码执行器
    --                          传递选项，将该选项后面的所有内容都作为选项参数传递给代码文件

    --deno，--use-deno          使用 Deno 运行时
    --bun，--use-bun            使用 Bun 运行时
    --node，--use-node          使用 Node.js 运行时
    --tsx，--use-tsx            使用 tsx 执行
    --ts-node，--use-ts-node    使用 ts-node 执行

  命令帮助：

    <name> 文件名(仅scripts目录)  <path> 相对路径或绝对路径  [--options] 命令选项

arcadia run <name/path/url> --sandbox