BitComet 的桌面程序支持从命令行创建任务和执行常用操作。以下示例中的 BitComet.exe 适用于 Windows;Linux 和 macOS 请替换为实际的可执行文件路径。参数区分大小写。执行 BitComet.exe --help 可查看当前版本支持的参数;新参数需要使用包含相应功能的版本。
BitComet.exe --url "URL" [--silent] [--paused] [--tray]
--url 支持 HTTP、HTTPS、FTP、Magnet URI 和 BC 链接。URL 中包含 &、空格等 Shell 特殊字符时,请按所用 Shell 的规则引用。
--silent 或 -s:不显示添加任务对话框,直接创建任务。--paused 或 -p:创建后暂不启动任务;与 --silent 一起使用可直接添加暂停的任务。--tray:启动时最小化到系统托盘;仅对首次启动的实例有效。以下可选参数用于 HTTP/HTTPS 主下载地址,不能与 FTP、Magnet 或 BC 链接一起使用:
| 参数 | 用途 |
|---|---|
--cookie | Cookie 值,不带 Cookie: 前缀。 |
--referer | 引用页 URL,不带 Referer: 前缀。 |
--user_agent | User-Agent 值,不带 User-Agent: 前缀。 |
--mirror | 同一文件的 HTTP/HTTPS 镜像 URL。每个地址使用一次 --mirror,可重复指定。 |
参数值可以写作 --cookie "值" 或 --cookie="值"。如果值以 -- 开头,请使用等号形式以避免被当作选项。Cookie、Referer 和 User-Agent 可显式指定为空值;镜像 URL 不能为空。程序会拒绝控制字符;镜像和主 URL 均需包含主机名。参数不能与 --exit、--file、--make 等其他操作组合。
镜像是否发送自定义 HTTP 请求头,遵循任务的“向镜像发送自定义 HTTP 头”设置,添加 --mirror 不会自动启用该设置。默认情况下不要假设镜像会收到原站的 Cookie 或 User-Agent。
BitComet.exe --url "https://example.com/file.zip?a=1&b=2" --cookie "sid=\"abc123\"; token=a+b==" --referer "https://example.com/page?id=1&from=download" --user_agent "My Client/1.0" --mirror "https://mirror1.example.com/file.zip" --mirror "https://mirror2.example.com/file.zip" --silent
上例传给程序的 Cookie 为 sid="abc123"; token=a+b==。Windows 参数中的反斜杠仅在紧邻双引号时按转义规则处理:\" 表示字面双引号;带引号的值若以反斜杠结尾,应在结束引号前将结尾反斜杠加倍,例如 "D:\Download Folder\\"。
CMD 即使在双引号中也会展开 %VAR%;批处理 .cmd / .bat 中的字面 % 需要写作 %%。若值含 !,应关闭延迟展开,例如在批处理开头使用 setlocal DisableDelayedExpansion。直接在交互式 CMD 输入和在批处理文件中输入的百分号规则不同。
PowerShell 7 可使用 Standard 原生参数传递模式:
$PSNativeCommandArgumentPassing = 'Standard'
& 'C:\Program Files\BitComet\BitComet.exe' --url 'https://example.com/file.zip?a=1&b=%2F' --cookie 'sid="abc123"; token=a+b==' --user_agent 'My Client/1.0' --mirror 'https://mirror.example.com/file.zip' --silent
Windows PowerShell 5.1 可通过 Start-Process 传入已按 Windows 规则引用的参数字符串:
Start-Process -FilePath 'C:\Program Files\BitComet\BitComet.exe' -ArgumentList '--url "https://example.com/file.zip" --cookie "sid=\"abc123\"; token=a+b==" --silent'
PowerShell 的单引号可避免 $ 和反引号展开。原生命令参数的传递方式随 PowerShell 版本和模式变化,5.1 与 7 不应直接套用同一种内嵌双引号写法。
bitcomet --url 'https://example.com/file.zip?a=1&b=%2F' --cookie 'sid="abc123"; token=a+b==' --referer 'https://example.com/page?a=1&b=2' --user_agent 'My Client/1.0' --mirror 'https://mirror.example.com/file.zip' --silent
这里的 bitcomet 代表实际程序路径。Shell 单引号内的空格、双引号、反斜杠、$ 和反引号按字面传递;若值本身包含单引号,需要按所用 Shell 的规则另行引用。Shell 会先处理命令,程序无法恢复已经被 Shell 展开的内容。
Cookie 和其他命令行参数可能被同一台计算机上的其他用户或进程读取,也可能留在 Shell 历史中。请勿把真实 Cookie 放入共享脚本、日志或示例。
BitComet.exe "TORRENT_FILE" [--output "DIRECTORY"] [--silent] [--paused]
BitComet.exe --make "SOURCE" [--output "DIRECTORY"] [--piece_size "SIZE"] [--silent]
第一条打开已有 torrent;--output 可指定下载目录。第二条从文件或目录制作 torrent;--output 可指定生成 torrent 文件的目录,--piece_size 可指定分块大小,例如 256KB。--make、--output 和 --silent 也可分别写作 -m、-o 和 -s。不指定输出位置时,使用对应任务创建流程的默认位置。
--help 或 -h:显示当前版本的命令行帮助;同时提供的其他操作不会执行。--suspend / --resume:暂停全部活动任务 / 恢复已暂停的任务。--exit:请求正在运行的实例退出。--bt_port PORT / --webui_port PORT:设置监听端口 / WebUI 端口。长选项支持无歧义的前缀匹配,但建议使用完整名称,避免将来新增选项后产生歧义。Windows 还支持以 / 开头的长选项,如 /cookie;Linux 和 macOS 请使用 --。