109 lines
7.3 KiB
Markdown
109 lines
7.3 KiB
Markdown
# 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 的可选参数
|
||
|
||
<!-- markdownlint-disable -->
|
||
|
||
```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
|
||
```
|
||
|
||
<!-- markdownlint-restore -->
|
||
|
||
## dfget daemon
|
||
|
||
### 查看 daemon 日志
|
||
|
||
如果您想要在 Terminal 中查看日志，请使用 --console 参数，或者将环境变量 console 设置为 true。
|
||
|
||
### daemon 的可选参数
|
||
|
||
<!-- markdownlint-disable -->
|
||
|
||
```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
|
||
```
|
||
|
||
<!-- markdownlint-restore -->
|