alexvanin/rclone
1
0
Fork 0
forked from TrueCloudLab/rclone
Code Pull requests Activity

Update PROXY section of the FAQ

Browse source
This commit is contained in:
Stephen Harris 2018-11-23 14:58:32 -05:00 committed by Nick Craig-Wood
parent bb10a51b39
commit 4c8c87a935
1 changed files with 25 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
docs/content/faq.md
View file

@ -90,18 +90,38 @@ just requires writing the algorithm to do it.
### Can I use rclone with an HTTP proxy? ### ### Can I use rclone with an HTTP proxy? ###
Yes. rclone will use the environment variables `HTTP_PROXY`, Yes. rclone will follow the standard environment variables for
`HTTPS_PROXY` and `NO_PROXY`, similar to cURL and other programs. proxies, similar to cURL and other programs.
`HTTPS_PROXY` takes precedence over `HTTP_PROXY` for https requests. In general the variables are called `http_proxy` (for services reached
over `http`) and `https_proxy` (for services reached over `https`). Most
public services will be using `https`, but you may wish to set both.
The environment values may be either a complete URL or a "host[:port]", If you ever use `FTP` then you would need to set `ftp_proxy`.
in which case the "http" scheme is assumed.
The content of the variable is `protocol://server:port`. The protocol
value is the one used to talk to the proxy server, itself, and is commonly
either `http` or `socks5`.
Slightly annoyingly, there is no _standard_ for the name; some applications
may use `http_proxy` but another one `HTTP_PROXY`. The `Go` libraries
used by `rclone` will try both variations, but you may wish to set all
possibilities. So, on Linux, you may end up with code similar to
export http_proxy=http://proxyserver:12345
export https_proxy=$http_proxy
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$http_proxy
The `NO_PROXY` allows you to disable the proxy for specific hosts. The `NO_PROXY` allows you to disable the proxy for specific hosts.
Hosts must be comma separated, and can contain domains or parts. Hosts must be comma separated, and can contain domains or parts.
For instance "foo.com" also matches "bar.foo.com". For instance "foo.com" also matches "bar.foo.com".
e.g.
export no_proxy=localhost,127.0.0.0/8,my.host.name
export NO_PROXY=$no_proxy
### Rclone gives x509: failed to load system roots and no roots provided error ### ### Rclone gives x509: failed to load system roots and no roots provided error ###
This means that `rclone` can't file the SSL root certificates. Likely This means that `rclone` can't file the SSL root certificates. Likely