# dfdaemon ## dfget `dfget` 是 Dragonfly 中用来下载和上传文件的客户端。 ### dfget 简介 dfget 是 Dragonfly 中用来下载和上传文件的客户端，也是 p2p 网络中的一个 peer。当用户发起文件下载请求时， dfget 将从其他 peer 下载文件。同时，它也能作为上传者，让其他 peer 下载它已拥有的那部分文件。 此外，dfget 还提供了一些高级功能，如网络带宽限制、加密传输等。 ### dfget 用法 ```text dfget [flags] ``` ### dfget 用法案例 ```text dfget --schedulers 127.0.0.1:8002 -o /path/to/output -u "http://example.com/object" ``` ### 查看 dfget 日志 如果您想要在 Terminal 中查看日志，请使用 --console 参数，或者将环境变量 console 设置为 true。 ### dfget 的可选参数 ```text --alivetime duration alive duration for which uploader keeps no accessing by any uploading requests, after this period uploader will automatically exit (default 5m0s) --cacerts strings the cacert file which is used to verify remote server when supernode interact with the source. --callsystem string the name of dfget caller which is for debugging. Once set, it will be passed to all components around the request to make debugging easy --clientqueue int specify the size of client queue which controls the number of pieces that can be processed simultaneously --console show log on console, it's conflict with '--showbar' --daemon-pid string the daemon pid (default "/tmp/dfdaemon.pid") --daemon-sock string the unix domain socket address for grpc with daemon (default "/tmp/dfdamon.sock") --dfdaemon identify whether the request is from dfdaemon --expiretime duration caching duration for which cached file keeps no accessed by any process, after this period cache file will be deleted (default 3m0s) -f, --filter string filter some query params of URL, use char '&' to separate different params eg: -f 'key&sign' will filter 'key' and 'sign' query param in this way, different but actually the same URLs can reuse the same downloading task --header stringArray http header, eg: --header='Accept: *' --header='Host: abc' -h, --help help for dfget --home string the work home directory of dfget (default "/Users/jim/.dragonfly/dfdaemon/") -i, --identifier string the usage of identifier is making different downloading tasks generate different downloading task IDs even if they have the same URLs. conflict with --md5. --insecure identify whether supernode should skip secure verify when interact with the source. --ip string IP address that server will listen on (default "0.0.0.0") -m, --md5 string md5 value input from user for the requested downloading file to enhance security --more-daemon-options string more options passed to daemon by command line, please confirm your options with "dfget daemon --help" -n, --node supernodes deprecated, please use schedulers instead. specify the addresses(host:port=weight) of supernodes where the host is necessary, the port(default: 8002) and the weight(default:1) are optional. And the type of weight must be integer --notbacksource disable back source downloading for requested file when p2p fails to download it -o, --output string destination path which is used to store the requested downloading file. It must contain detailed directory and specific filename, for example, '/tmp/file.mp4' -p, --pattern string download pattern, must be p2p/cdn/source, cdn and source do not support flag --totallimit (default "p2p") --port int port number that server will listen on (default 65002) --schedulers schedulers the scheduler addresses -b, --showbar show progress bar, it is conflict with '--console' -e, --timeout duration timeout set for file downloading task. If dfget has not finished downloading all pieces of file before --timeout, the dfget will throw an error and exit --totallimit ratelimit network bandwidth rate limit for the whole host, in format of G(B)/g/M(B)/m/K(B)/k/B, pure number will also be parsed as Byte (default 104857600.000000) -u, --url string URL of user requested downloading file(only HTTP/HTTPs supported) --verbose enable verbose mode, all debug log will be display ``` ## dfget daemon ### 查看 daemon 日志 如果您想要在 Terminal 中查看日志，请使用 --console 参数，或者将环境变量 console 设置为 true。 ### daemon 的可选参数 ```text --advertise-ip string the ip report to scheduler, normal same with listen ip (default "10.15.232.63") --alivetime duration alive duration for which uploader keeps no accessing by any uploading requests, after this period uploader will automatically exit (default 5m0s) --data string local directory which stores temporary files for p2p uploading --download-rate ratelimit download rate limit for other peers and back source (default 104857600.000000) --expiretime duration caching duration for which cached file keeps no accessed by any process, after this period cache file will be deleted (default 3m0s) --gc-interval duration gc interval (default 1m0s) --grpc-port int the listen address for grpc with other peers (default 65000) --grpc-port-end int the listen address for grpc with other peers (default 65000) --grpc-unix-listen string the local unix domain socket listen address for grpc with dfget (default "/tmp/dfdamon.sock") -h, --help help for daemon --home string the work home directory of dfget daemon --idc string peer idc for scheduler --keep-storage keep storage after daemon exit --ip string IP address that server will listen on --location string peer location for scheduler --lock string dfdaemon lock file location (default "/tmp/dfdaemon.lock") --net-topology string peer net topology for scheduler --pid string dfdaemon pid file location (default "/tmp/dfdaemon.pid") --proxy-port int the address that daemon will listen on for proxy service (default 65001) --proxy-port-end int the address that daemon will listen on for proxy service (default 65001) -s, --schedulers schedulers schedulers --security-domain string peer security domain for scheduler --upload-port int the address that daemon will listen on for peer upload (default 65002) --upload-port-end int the address that daemon will listen on for peer upload (default 65002) --upload-rate ratelimit upload rate limit for other peers (default 104857600.000000) --verbose print verbose log and enable golang debug info ```