命令行用法

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 的规则引用。

HTTP 请求头与镜像

以下可选参数用于 HTTP/HTTPS 主下载地址,不能与 FTP、Magnet 或 BC 链接一起使用:

参数用途
--cookieCookie 值,不带 Cookie: 前缀。
--referer引用页 URL,不带 Referer: 前缀。
--user_agentUser-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。

Windows:CMD

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 输入和在批处理文件中输入的百分号规则不同。

Windows:PowerShell

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 不应直接套用同一种内嵌双引号写法。

Linux 和 macOS:Shell

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。不指定输出位置时,使用对应任务创建流程的默认位置。

其他操作

长选项支持无歧义的前缀匹配,但建议使用完整名称,避免将来新增选项后产生歧义。Windows 还支持以 / 开头的长选项,如 /cookie;Linux 和 macOS 请使用 --。