mirror of
https://github.com/oh-my-fish/oh-my-fish
synced 2024-11-09 13:10:40 +00:00
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
proxy plugin
|
|
============
|
|
|
|
The proxy plugin provides a couple helper functions to those of us who are
|
|
stuck behind HTTP/HTTPS/FTP proxies that require authentication. The variables
|
|
it exports are used by many command-line and GUI applications on Linux, as well
|
|
as [MacPorts][1] and [Homebrew][2] on OS X.
|
|
|
|
Both uppercase and lowercase versions of the proxy environment variables are
|
|
set, some applications are case sensitive. If you'd like to learn more about
|
|
the use of these variables, this [Arch Wiki Article][3] is a good place to
|
|
start.
|
|
|
|
## Usage
|
|
|
|
In all cases you will need to add 'proxy' to your fish_plugins list in
|
|
config.fish
|
|
|
|
### No authentication
|
|
|
|
If you just want to have the proxy plugin configure all the environment
|
|
variables, you may set proxy_host:
|
|
|
|
set proxy_host myproxy.example.com:8000
|
|
|
|
The proxy plugin will prepend `http://` for you. Here's the result:
|
|
|
|
~> set -x |grep proxy
|
|
ALL_PROXY http://myproxy.example.com:8000
|
|
FTP_PROXY http://myproxy.example.com:8000
|
|
HTTPS_PROXY http://myproxy.example.com:8000
|
|
HTTP_PROXY http://myproxy.example.com:8000
|
|
all_proxy http://myproxy.example.com:8000
|
|
ftp_proxy http://myproxy.example.com:8000
|
|
http_proxy http://myproxy.example.com:8000
|
|
https_proxy http://myproxy.example.com:8000
|
|
|
|
### With authentication
|
|
|
|
Set your proxy host and username:
|
|
|
|
set proxy_host myproxy.example.com:8000
|
|
set proxy_user mylogin
|
|
|
|
When you need to make use of the proxy, just run `proxy`. It will prompt you
|
|
for a password and setup your environment.
|
|
|
|
If you didn't setup a proxy_user variable, you will be prompted for a username.
|
|
|
|
If you wish to clear your proxy variables, run `noproxy`.
|
|
|
|
[1]: http://www.macports.org/
|
|
[2]: http://brew.sh/
|
|
[3]: https://wiki.archlinux.org/index.php/proxy_settings
|